W3Cschool
恭喜您成為首批注冊用戶
獲得88經驗值獎勵
assert模塊是Node的內置模塊,主要用于斷言。如果表達式不符合預期,就拋出一個錯誤。該模塊提供11個方法,但只有少數幾個是常用的。
assert方法接受兩個參數,當第一個參數對應的布爾值為true時,不會有任何提示,返回undefined。當第一個參數對應的布爾值為false時,會拋出一個錯誤,該錯誤的提示信息就是第二個參數設定的字符串。
// 格式
assert(value, message)
// 例子
var assert = require('assert');
function add (a, b) {
return a + b;
}
var expected = add(1,2);
assert( expected === 3, '預期1加2等于3');
上面代碼不會有任何輸出,因為assert方法的第一個參數是true。
assert( expected === 4, '預期1加2等于3')
// AssertionError: 預期1加2等于3
上面代碼會拋出一個錯誤,因為assert方法的第一個參數是false。
ok是assert方法的另一個名字,與assert方法完全一樣。
equal方法接受三個參數,第一個參數是實際值,第二個是預期值,第三個是錯誤的提示信息。
// 格式
assert.equal(actual, expected, [message])
assert.equal(true, value, message);
// 等同于
assert(value, message);
// 例子
var assert = require('assert');
function add (a, b) {
return a + b;
}
var expected = add(1,2);
// 以下三句效果相同
assert(expected == 3, '預期1+2等于3');
assert.ok(expected == 3, '預期1+2等于3');
assert.equal(expected, 3, '預期1+2等于3');
equal方法內部使用的是相等運算符(==),而不是嚴格運算符(===),進行比較運算。
notEqual方法的用法與equal方法類似,但只有在實際值等于預期值時,才會拋出錯誤。
// 格式
assert.notEqual(actual, expected, [message])
// 用法
var assert = require('assert');
function add (a, b) {
return a + b;
}
var expected = add(1,2);
// 以下三種寫法效果相同
assert(expected != 4, '預期不等于4');
assert.ok(expected != 4, '預期不等于4');
assert.notEqual(expected, 4, '預期不等于4');
notEqual方法內部使用不相等運算符(!=),而不是嚴格不相等運算符(!==),進行比較運算。
deepEqual方法用來比較兩個對象。只要它們的屬性一一對應,且值都相等,就認為兩個對象相等,否則拋出一個錯誤。
// 格式
assert.deepEqual(actual, expected, [message])
// 例子
var assert = require('assert');
var list1 = [1, 2, 3, 4, 5];
var list2 = [1, 2, 3, 4, 5];
assert.deepEqual(list1, list2, '預期兩個數組應該有相同的屬性');
var person1 = { "name":"john", "age":"21" };
var person2 = { "name":"john", "age":"21" };
assert.deepEqual(person1, person2, '預期兩個對象應該有相同的屬性');
notDeepEqual方法與deepEqual方法正好相反,用來斷言兩個對象是否不相等。
// 格式
assert.notDeepEqual(actual, expected, [message])
// 例子
var assert = require('assert');
var list1 = [1, 2, ,3, 4, 5];
var list2 = [1, 2, 3, 4, 5];
assert.notDeepEqual(list1, list2, '預期兩個對象不相等');
var person1 = { "name":"john", "age":"21" };
var person2 = { "name":"jane", "age":"19" };
// deepEqual checks the elements in the objects are identical
assert.notDeepEqual(person1, person2, '預期兩個對象不相等');
strictEqual方法使用嚴格相等運算符(===),比較兩個表達式。
// 格式
assert.strictEqual(actual, expected, [message])
// 例子
var assert = require('assert');
assert.strictEqual(1, '1', '預期嚴格相等');
// AssertionError: 預期嚴格相等
assert.notStrictEqual方法使用嚴格不相等運算符(!==),比較兩個表達式。
// 格式
assert.notStrictEqual(actual, expected, [message])
// 例子
var assert = require('assert');
assert.notStrictEqual(1, true, '預期嚴格不相等');
throws方法預期某個代碼塊會拋出一個錯誤,且拋出的錯誤符合指定的條件。
// 格式
assert.throws(block, [error], [message])
// 例一,拋出的錯誤符合某個構造函數
assert.throws(
function() {
throw new Error("Wrong value");
},
Error,
'不符合預期的錯誤類型'
);
// 例二、拋出錯誤的提示信息符合正則表達式
assert.throws(
function() {
throw new Error("Wrong value");
},
/value/,
'不符合預期的錯誤類型'
);
// 例三、拋出的錯誤符合自定義函數的校驗
assert.throws(
function() {
throw new Error("Wrong value");
},
function(err) {
if ( (err instanceof Error) && /value/.test(err) ) {
return true;
}
},
'不符合預期的錯誤類型'
);
doesNotThrow方法與throws方法正好相反,預期某個代碼塊不拋出錯誤。
// 格式
assert.doesNotThrow(block, [message])
// 用法
assert.doesNotThrow(
function() {
console.log("Nothing to see here");
},
'預期不拋出錯誤'
);
ifError方法斷言某個表達式是否false,如果該表達式對應的布爾值等于true,就拋出一個錯誤。它對于驗證回調函數的第一個參數十分有用,如果該參數為true,就表示有錯誤。
// 格式
assert.ifError(value)
// 用法
function sayHello(name, callback) {
var error = false;
var str = "Hello "+name;
callback(error, str);
}
// use the function
sayHello('World', function(err, value){
assert.ifError(err);
// ...
})
fail方法用于拋出一個錯誤。
// 格式
assert.fail(actual, expected, message, operator)
// 例子
var assert = require('assert');
assert.fail(21, 42, 'Test Failed', '###')
// AssertionError: Test Failed
assert.fail(21, 21, 'Test Failed', '###')
// AssertionError: Test Failed
assert.fail(21, 42, undefined, '###')
// AssertionError: 21 ### 42
該方法共有四個參數,但是不管參數是什么值,它總是拋出一個錯誤。如果message參數對應的布爾值不為false,拋出的錯誤信息就是message,否則錯誤信息就是“實際值 + 分隔符 + 預期值”。
Copyright©2021 w3cschool編程獅|閩ICP備15016281號-3|閩公網安備35020302033924號
違法和不良信息舉報電話:173-0602-2364|舉報郵箱:jubao@eeedong.com
掃描二維碼
下載編程獅App
編程獅公眾號
聯系方式:
更多建議: