assert模塊提供了一組簡單的斷言測試，分嚴格模式(strict)和遺留模式(legacy)，嚴格模式下，對比的方式比較嚴格，比如說，0與'0'比較，會報錯，但在遺留模式下是可以通過的。官方推薦使用嚴格模式, 所以本文基于strict模式下學習。

如何使用嚴格模式

const assert = require('assert').strict; // 嚴格模式
assert.equal(0, '0') // error

全局使用strict模式后，assert.equal() 與assert.strictEqual()的效果是一樣的。

如果不想全局使用的話，可以直接使用帶strict的方法。

const assert = require('assert') // 遺留模式

assert.equal(0, '0') // success
assert.strictEqual(0, '0') // error

assert.AssertionError

Error的子類，表示斷言失敗，assert模塊拋出的錯誤都是AssertionError的實例。

類似于下面這個class，實際上的AssertionError是由ES5寫的，下面這個只是方便理解傳入的參數(shù)

interface IOptions {
 message?: string; // 設(shè)置錯誤的信息
 actual?: any; // 設(shè)置錯誤實例上的實際值
 expected?: any; // 設(shè)置錯誤實例上的期望值
 operator?: string; // 設(shè)置用于比較的操作或觸發(fā)錯誤的斷言函數(shù)
 stackStartFn(): any; // 生成的堆棧跟蹤將移除所有幀直到提供的函數(shù)
}


class AssertionError extends Error {
 constructor(options: IOptions) {
  // ...
 }
}

assert(value: any, message?: string | Error)

檢測是否為真值，是assert.ok的別名。

assert.ok(value: any, message?: string | Error)

檢測value是否為真值。

如果不為真值，拋出屬性message為message參數(shù)值的AssertionError，如果未定義，為默認錯誤信息。

如果是Error的實例，則拋出Error實例。(以下關(guān)于message的使用都一樣)

assert.strictEqual(actual: any, expected: any, message?: string | Error)

檢測 actual參數(shù)和expected參數(shù)之間的嚴格相等性，使用sameValue比較。

assert.deepStrictEqual(actual: any, expected: any, message?: string | Error)

檢測actual參數(shù)和expected參數(shù)之間的深度嚴格相等性，深度比較意味著子對象的可枚舉的自身屬性也通過以下規(guī)則進行遞歸計算。

assert.notStrictEqual(actual: any, expected: any, message?: string | Error)

檢測 actual參數(shù)和expected參數(shù)之間的嚴格不相等性，使用sameValue比較。

assert.notDeepStrictEqual(actual: any, expected: any, message?: string | Error)

檢測actual參數(shù)和expected參數(shù)之間的深度嚴格不相等性，深度比較意味著子對象的可枚舉的自身屬性也通過以下規(guī)則進行遞歸計算。

assert.fail(message?: string | Error = 'failed')

使用提供的錯誤消息或默認錯誤消息拋出 AssertionError。

assert.throws(fn: function, error?: regExp | function | object | Error, message?: string)

檢測fn函數(shù)拋出的錯誤是否與預(yù)期的錯誤error一樣。

fn為一個會拋出錯誤的函數(shù)

error可以為多種類型，作為與拋出的錯誤對比的樣本。

為regExp時，可以匹配拋出的錯誤。

assert.throws(() => {
 throw new Error('it is a error')
}, /^Error: it is a error$/);

為function時，可以自定義驗證函數(shù)

assert.throws(() => {
 throw new Error('it is a error')
}, (err) => {
 if ((err instanceof Error) && /error/.test(err)) {
  return true;
 }
});

為object時，將僅測試驗證對象error上的屬性。

const err = new TypeError('錯誤值');
err.code = 404;
err.foo = 'bar';
err.info = {
 nested: true,
 baz: 'text'
};
err.reg = /abc/i; // 正則表達式只有當驗證對象包含相同的正則表達式時才通過。

assert.throws(() => {
 throw err;
}, {
 name: 'TypeError',
 message: '錯誤值'
 info: {
  nested: true,
  baz: 'text'
  // 使用嵌套對象需要存在所有屬性。
  // 否則驗證將失敗。
  // 無法對嵌套屬性使用正則表達式！
 }
});

為Error時，用instanceof檢測是否是該實例。

注意， error 不能是字符串。 如果提供了一個字符串作為第二個參數(shù)，則假定 error 被忽略，而字符串將用于 message。

assert.reject(asyncFn: function | promise, error?: regExp | function | object | Error, message?: string)

assert.throws的異步版本。

asyncFn為一個function時

立即執(zhí)行該函數(shù)，如果該函數(shù)不返回promise，則返回一個被拒絕(reject)的 Promise。
如果該函數(shù)同步拋出一個錯誤，返回一個帶有該錯誤的被拒絕的 Promise。

asyncFn為一個Promise時

等待Promise執(zhí)行，檢測是否被拒絕。

assert.ifError(value: any)

如果value不為null或者undefined就將value作為錯誤拋出。

在回調(diào)中測試error參數(shù)時，這很有用。

以上就是本文的全部內(nèi)容，希望對大家的學習有所幫助，也希望大家多多支持腳本之家。

最新評論