文档参考地址:https://nodejs.org/dist/latest-v4.x/docs/api/
Assert(断言)
assert模块提供了一组简单的断言测试方法,可以拥有测试不变量。该模块本意是用于node.js内部使用,但是现在可以通过require('assert')引入模块的方式在应用程序代码中使用。然而,断言并不是一个测试框架,也不是用来作为一个通用的断言库。
assert模块的API是锁级别的。这意味着该模块实现的方法和暴露的任何方法将不可增加或更改。
- assert(value[, message])
- assert.deepEqual(actual, expected[, message])
- assert.deepStrictEqual(actual, expected[, message])
- assert.doesNotThrow(block[, error][, message])
- assert.equal(actual, expected[, message])
- assert.fail(actual, expected, message, operator)
- assert.ifError(value)
- assert.notDeepEqual(actual, expected[, message])
- assert.notDeepStrictEqual(actual, expected[, message])
- assert.notEqual(actual, expected[, message])
- assert.notStrictEqual(actual, expected[, message])
- assert.ok(value[, message])
- assert.strictEqual(actual, expected[, message])
- assert.throws(block[, error][, message])
assert(value[, message])#
有一个别名assert.ok()
.
const assert = require('assert'); assert(true); // OK
assert(1); // OK
assert(false);
// throws "AssertionError: false == true"
assert(0);
// throws "AssertionError: 0 == true"
assert(false, 'it\'s false');
// throws "AssertionError: it's false"
assert.deepEqual(actual, expected[, message])#
用于深层次的比较参数actual和expected是否相等。值比较的话等效于操作符(==)。
只有自身属性是可列举订单才能被考虑。deepEqual()方法的设计不能测试对象的原型,附加符号,或不可数性质。这可能导致一些意想不到的结果。例如,下面这个例子就不会抛出AssertionError,因为Error对象的属性是不可数的。
// WARNING: This does not throw an AssertionError!
assert.deepEqual(Error('a'), Error('b'));
"深度"相等意味着子对象的可列举属性也会被计算。
const assert = require('assert'); const obj1 = {
a : {
b : 1
}
};
const obj2 = {
a : {
b : 2
}
};
const obj3 = {
a : {
b : 1
}
}
const obj4 = Object.create(obj1); assert.deepEqual(obj1, obj1);
// OK, object is equal to itself assert.deepEqual(obj1, obj2);
// AssertionError: { a: { b: 1 } } deepEqual { a: { b: 2 } }
// values of b are different assert.deepEqual(obj1, obj3);
// OK, objects are equal assert.deepEqual(obj1, obj4);
// AssertionError: { a: { b: 1 } } deepEqual {}
// Prototypes are ignored
如果值不相等,抛出AssertionError断言错误,这个错误信息是设置的message参数。如果message参数没有定义,那么将指定一个默认的错误信息。