Deno 測試

測試

Deno 有一個(gè)內(nèi)置的測試器，可以用來測試 JavaScript 或 TypeScript 代碼。

編寫測試

要定義測試，需要使用要測試的名稱和函數(shù)調(diào)用 Deno.test。 您可以使用兩種風(fēng)格： // 傳遞名稱和函數(shù)，緊湊的形式，但不能配置

Deno.test("hello world #1", () => {
  const x = 1 + 2;
  assertEquals(x, 3);
});


// 全面的測試定義，更長的形式，但可配置（請參見下文）
Deno.test({
  name: "hello world #2",
  fn() => {
    const x = 1 + 2;
    assertEquals(x, 3);
  }
});

Assertions

在 https://deno.land/std/testing 上有一些有用的斷言實(shí)用程序，可以簡化測試：
import {
  assertEquals,
  assertArrayContains,
} from "https://deno.land/std/testing/asserts.ts";


Deno.test("hello world", () => {
  const x = 1 + 2;
  assertEquals(x, 3);
  assertArrayContains([1, 2, 3, 4, 5, 6], [3], "Expected 3 to be in the array");
});

資源和異步操作清理器

Deno 中的某些操作在資源表（在此處了解更多）中創(chuàng)建資源。 這些資源應(yīng)該在使用完后關(guān)閉。 對于每個(gè)測試定義，測試器會(huì)檢查此測試中創(chuàng)建的所有資源是否已關(guān)閉，以防止資源“泄漏”。 默認(rèn)情況下，這對所有測試都是啟用的，但可以通過在測試定義中將 sanitizeResources 布爾值設(shè)置為 false 來禁用。 對于異步操作（如與文件系統(tǒng)交互）也是如此。測試器檢查您在測試中啟動(dòng)的每個(gè)操作是否在測試結(jié)束之前完成。默認(rèn)情況下，這對所有測試都是啟用的，但可以通過在測試定義中將 sanitizeps 布爾值設(shè)置為 false 來禁用。

Deno.test({
  name: "leaky test",
  fn() {
    Deno.open("hello.txt");
  },
  sanitizeResources: false,
  sanitizeOps: false,
});

運(yùn)行測試

要運(yùn)行測試，使用 deno test 命令，傳入包含測試函數(shù)的文件。您也可以忽略文件名，這樣當(dāng)前目錄樹內(nèi)所有符合通配符 {_,.,}test.{js,mjs,ts,jsx,tsx} 的測試都會(huì)被運(yùn)行。如果您傳入了一個(gè)目錄，那么該目錄下所有匹配的文件都會(huì)被運(yùn)行。

## 運(yùn)行當(dāng)前目錄樹內(nèi)的所有測試
deno test


## 運(yùn)行 util 目錄內(nèi)的所有測試
deno test util/


## 只運(yùn)行 my_test.ts
deno test my_test.ts
deno test 和 deno run 使用相同的權(quán)限模型，比如在測試期間有可能要求 --allow-write 來寫入文件系統(tǒng)。
使用 deno help test 命令來查看相關(guān)選項(xiàng)。

過濾

有許多選項(xiàng)可以過濾要運(yùn)行的測試。

命令行過濾

使用 --filter 選項(xiàng)可以單獨(dú)或成組運(yùn)行測試。 deno test --filter "hello world" tests/ 對于在 tests/ 目錄中的文件中找到的測試，此命令將運(yùn)行所有名稱中包含字符串 "hello world" 的測試。

測試定義過濾

在測試本身中，您有兩個(gè)過濾選項(xiàng)。

忽略測試

有時(shí)您希望忽略基于某種條件的測試（例如您只希望在 Windows 上運(yùn)行測試）。 為此，您可以使用 ignore 測試定義中的布爾值。 如果它被設(shè)置為 true，則測試將被跳過。

Deno.test({
  name: "do macOS feature",
  ignore: Deno.build.os !== "darwin",
  fn() {
    doMacOSFeature();
  },
});

啟用測試

有時(shí)您可能會(huì)在大型測試中遇到問題，只想專注于有問題的測試，忽略其他測試。 為此您可以使用 only 選項(xiàng)來讓測試框架只運(yùn)行一部分測試。多個(gè)測試可以設(shè)置此選項(xiàng)。盡管測試框架將報(bào)告每個(gè)測試的成功或失敗，但當(dāng)任何一個(gè)測試標(biāo)記為 only 時(shí)，總體測試將始終失敗。因?yàn)檫@只是一種臨時(shí)措施，幾乎會(huì)禁用所有測試。

Deno.test({
  name: "Focus on this test only",
  only: true,
  fn() {
    testComplicatedStuff();
  },
});

快速失敗

如果您有一個(gè)運(yùn)行時(shí)間較長的測試，并希望它在第一次失敗時(shí)停止運(yùn)行，則可以在運(yùn)行測試時(shí)指定 --failfast 選項(xiàng)。 deno test --failfast