freeCodeCamp/curriculum/challenges/chinese-traditional/06-quality-assurance/quality-assurance-and-testing-with-chai/run-functional-tests-on-api-endpoints-using-chai-http.md

id, title, challengeType, forumTopicId, dashedName

id	title	challengeType	forumTopicId	dashedName
587d824e367417b2b2512c58	使用 Chai-HTTP 在 API 端上運行功能測試	2	301593	run-functional-tests-on-api-endpoints-using-chai-http

--description--

請注意，本項目在這個 Replit 項目的基礎上進行開發。你也可以從 GitHub 上克隆。

Mocha 允許測試異步操作。 有一個差異， 你能發現它嗎？

我們可以使用一個叫作 chai-http 的插件測試 API 端點。 讓我們看看它是如何工作的。 請記住，API 調用是異步的。

以下是使用 chai-http 測試 'GET /hello?name=[name] => "hello [name]"' 套件的例子。 測試通過 GET 請求在 url 查詢字符串 ?name=John 中發送一個名稱字符串給 server。 在 end 方法的回調函數中，接收包含 status 屬性的響應對象（res）。 第一個 assert.equal 檢查狀態是否爲 200。 第二個 assert.equal 檢查響應字符串 res.text 是否爲 "hello John"。

suite('GET /hello?name=[name] => "hello [name]"', function () {
  test("?name=John", function (done) {
    chai
      .request(server)
      .get("/hello?name=John")
      .end(function (err, res) {
        assert.equal(res.status, 200, "response status should be 200");
        assert.equal(
          res.text,
          "hello John",
          'response should be "hello John"'
        );
        done();
      });
  });

請注意測試的回調函數中的 done 參數。 在沒有傳入參數的情況下調用它，是成功完成異步任務所必需的。

--instructions--

在 tests/2_functional-tests.js 中，修改 'Test GET /hello with no name' 測試（// #1），對 status 和 text 使用斷言。 不要修改傳給斷言的參數。

不要在 query 中傳入 name，端點將會返回 hello Guest。

--hints--

應通過所有測試。

(getUserInput) =>
  $.get(getUserInput('url') + '/_api/get-tests?type=functional&n=0').then(
    (data) => {
      assert.equal(data.state, 'passed');
    },
    (xhr) => {
      throw new Error(xhr.responseText);
    }
  );

應測試 “res.status” 是否爲 200。

(getUserInput) =>
  $.get(getUserInput('url') + '/_api/get-tests?type=functional&n=0').then(
    (data) => {
      assert.equal(data.assertions[0].method, 'equal');
      assert.equal(data.assertions[0].args[0], 'res.status');
      assert.equal(data.assertions[0].args[1], '200');
    },
    (xhr) => {
      throw new Error(xhr.responseText);
    }
  );

應測試 “res.text“ 是否爲 ”hello Guest“。

(getUserInput) =>
  $.get(getUserInput('url') + '/_api/get-tests?type=functional&n=0').then(
    (data) => {
      assert.equal(data.assertions[1].method, 'equal');
      assert.equal(data.assertions[1].args[0], 'res.text');
      assert.match(data.assertions[1].args[1], /('|")hello Guest\1/);
    },
    (xhr) => {
      throw new Error(xhr.responseText);
    }
  );

--solutions--

/**
  Backend challenges don't need solutions, 
  because they would need to be tested against a full working project. 
  Please check our contributing guidelines to learn more.
*/