使用 Deno 進行測試

本篇會向各位讀者介紹 Deno 內建的單元測試功能。

在正式開始前,我們先看看什麼是斷言

程式設計中,斷言assertion)是一種放在程式中的一階邏輯(如一個結果為真或是假的邏輯判斷式),目的是為了標示與驗證程式開發者預期的結果-當程式執行到斷言的位置時,對應的斷言應該為真。若斷言不為真時,程式會中止執行,並給出錯誤訊息。

-- wikipedia

簡單來說,當我們在程式執行的某個階段下可以肯定某個變數、函式輸出... 的值時,就能夠使用斷言。

筆者認為斷言可以翻譯成:斷定的認為會更好理解。

進入正題

為了讓開發者編寫測試, Deno 的標準庫內建了斷言模組

import { assert } from "https://deno.land/std@0.73.0/testing/asserts.ts";

Deno.test("Hello Test", () => {
  assert("Hello");
});

assert() 是一個簡單的布林值斷言,可以用於斷言任何可推導成 true 的值。

相等性

Deno 提供了三種相等性斷言供開發者使用:

  • assertEquals(para1, para2, errMsg)

    比較兩者是否相等。

  • assertNotEquals(para1, para2, errMsg)

    比較兩者是否為不相等。

  • assertStrictEquals(para1, para2, errMsg)

    該斷言方法不會對比較值進行強制轉型,這也就意味著使用者需要確保兩個比較輸入值的型別是完全相同的。

補充: para1 (實際輸出) 和 para2 (期望值) 為待測值,當斷言結果不符合預期會在命令列印出自定義的 errMsg ,當然錯誤訊息是可省略的。

在實際應用上,我們可以將外部模組的待測試函式 export 後,並使用 import 導入到我們撰寫的測試檔:

// 受測邏輯
export function sum(para1: number, para2: number): number{
    return para1 + para2 ;
}
// 測試程式
import { assertEquals } from "https://deno.land/std@0.73.0/testing/asserts.ts";
import { sum } from "./testLogi.ts";
  Deno.test("check on sum",()=>{
    let result = sum(1,2)
    assertEquals(result,4,`result should be 4, but output is ${result}.`);
  });

準備好程式碼後,使用 deno test 開始測試:

deno test test.ts

注意: 請務必使用 deno test 去執行測試程式。愚蠢如筆者,昨天反覆的使用 deno run 執行測試檔,果不其然,什麼都沒發生。

害我自己很擔心本日的文章產不出來 XDD

在上面的範例中,我們斷言 result 的值為 4 ,不過 sum(1,2) 卻回傳了 3 。因此,我們可以看到命列中印出了錯誤:

test check on sum ... FAILED (2ms)

failures:

check on sum
AssertionError: result should be 4, but output is 3.
    at assertEquals (asserts.ts:196:9)
    at test.ts:12:5
    at asyncOpSanitizer (deno:cli/rt/40_testing.js:34:13)
    at Object.resourceSanitizer [as fn] (deno:cli/rt/40_testing.js:68:13)
    at TestRunner.[Symbol.asyncIterator] (deno:cli/rt/40_testing.js:240:24)
    at AsyncGenerator.next ()
    at Object.runTests (deno:cli/rt/40_testing.js:317:22)

failures:

        check on sum

test result: FAILED. 1 passed; 1 failed; 0 ignored; 0 measured; 0 filtered out (4ms)

我們也可以一次進行多個測試:

import { assertEquals } from "https://deno.land/std@0.73.0/testing/asserts.ts";
import {sum} from "./testLogi.ts";
Deno.test("check on foo", () => {
    class Foo {}
    const foo1 = new Foo();
    const foo2 = new Foo();
    assertEquals(foo1, foo2, "not eq");
  });
  Deno.test("check on sum",()=>{
    let result = sum(2,2)
    assertEquals(result,4,`result should be 4, but output is ${result}.`);
  });

執行結果:

running 2 tests
test check on foo ... ok (3ms)
test check on sum ... ok (1ms)

test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out (4ms)

選擇單一測試

就上述的測試範例來看,一共有 "check on foo""check on sum" 兩個測試流程,若我們希望單獨拉出某個流程進行測試,這時候 -- filter 就派上用場了:

deno test --filter "check on sum" test.ts

結果:

running 1 tests
test check on sum ... ok (4ms)

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 1 filtered out (5ms)

其他斷言

Deno 一共提供了 10 種斷言方法:

  • assert(expr: unknown, msg = ""): asserts expr

  • assertEquals(actual: unknown, expected: unknown, msg?: string): void

  • assertNotEquals(actual: unknown, expected: unknown, msg?: string): void

  • assertStrictEquals(actual: unknown, expected: unknown, msg?: string): void

  • assertStringContains(actual: string, expected: string, msg?: string): void

  • assertArrayContains(actual: unknown[], expected: unknown[], msg?: string): void

  • assertMatch(actual: string, expected: RegExp, msg?: string): void

  • assertNotMatch(actual: string, expected: RegExp, msg?: string): void

  • assertThrows(fn: () => void, ErrorClass?: Constructor, msgIncludes = "", msg?: string): Error

  • assertThrowsAsync(fn: () => Promise, ErrorClass?: Constructor, msgIncludes = "", msg?: string): Promise

在暸解一般的斷言後,也可以練習看看其他的斷言方法。礙於篇幅問題,筆者就不拉出來一一說明了,還請見諒。

延伸閱讀

同樣的事情在不同人眼中可能會有不同的見解、看法。

在讀完本篇以後,筆者也強烈建議大家去看看以下文章,或許會對型別、變數宣告...等觀念有更深層的看法唷!

Last updated