Module 基础模块

模块 assert

断言测试模块,如果测试值为假,则报错,报错行为可设定继续运行或者错误抛出

引用方法:

1
var assert = require('assert');

或者通过 test 模块引用:

1 2
var test = require('test'); var assert = test.assert;

或者通过 test.setup 配置:

1
require("test").setup();

静态函数

Function

测试数值为真,为假则断言失败

1 2
static assert.Function(Value actual = undefined, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

ok

测试数值为真,为假则断言失败

1 2
static assert.ok(Value actual = undefined, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

notOk

测试数值为假,为真则断言失败

1 2
static assert.notOk(Value actual = undefined, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

equal

测试数值等于预期值,不相等则断言失败

1 2 3
static assert.equal(Value actual = undefined, Value expected = undefined, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

notEqual

测试数值不等于预期值,相等则断言失败

1 2 3
static assert.notEqual(Value actual = undefined, Value expected = undefined, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

strictEqual

测试数值严格等于预期值,不相等则断言失败

1 2 3
static assert.strictEqual(Value actual = undefined, Value expected = undefined, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

notStrictEqual

测试数值不严格等于预期值,相等则断言失败

1 2 3
static assert.notStrictEqual(Value actual = undefined, Value expected = undefined, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

deepEqual

测试数值深度等于预期值,不相等则断言失败

1 2 3
static assert.deepEqual(Value actual = undefined, Value expected = undefined, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

notDeepEqual

测试数值不深度等于预期值,相等则断言失败

1 2 3
static assert.notDeepEqual(Value actual = undefined, Value expected = undefined, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

closeTo

测试数值近似等于预期值,否则断言失败

1 2 3 4
static assert.closeTo(Value actual, Value expected, Value delta, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • delta: Value, 近似的小数精度
  • msg: String, 断言失败时的提示信息

notCloseTo

测试数值不近似等于预期值,否则断言失败

1 2 3 4
static assert.notCloseTo(Value actual, Value expected, Value delta, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • delta: Value, 近似的小数精度
  • msg: String, 断言失败时的提示信息

lessThan

测试数值小于预期值,大于或等于则断言失败

1 2 3
static assert.lessThan(Value actual, Value expected, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

notLessThan

测试数值不小于预期值,小于则断言失败

1 2 3
static assert.notLessThan(Value actual, Value expected, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

greaterThan

测试数值大于预期值,小于或等于则断言失败

1 2 3
static assert.greaterThan(Value actual, Value expected, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

notGreaterThan

测试数值不大于预期值,大于则断言失败

1 2 3
static assert.notGreaterThan(Value actual, Value expected, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • expected: Value, 预期的数值
  • msg: String, 断言失败时的提示信息

exist

测试变量存在,为假则断言失败

1 2
static assert.exist(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

notExist

测试变量不存在,为真则断言失败

1 2
static assert.notExist(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isTrue

测试数值为布尔值真,否则断言失败

1 2
static assert.isTrue(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNotTrue

测试数值不为布尔值真,否则断言失败

1 2
static assert.isNotTrue(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isFalse

测试数值为布尔值假,否则断言失败

1 2
static assert.isFalse(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNotFalse

测试数值不为布尔值假,否则断言失败

1 2
static assert.isNotFalse(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNull

测试数值为 Null,否则断言失败

1 2
static assert.isNull(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNotNull

测试数值不为 Null,否则断言失败

1 2
static assert.isNotNull(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isUndefined

测试数值为 undefined,否则断言失败

1 2
static assert.isUndefined(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isDefined

测试数值不为 undefined,否则断言失败

1 2
static assert.isDefined(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isFunction

测试数值为函数,否则断言失败

1 2
static assert.isFunction(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNotFunction

测试数值不为函数,否则断言失败

1 2
static assert.isNotFunction(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isObject

测试数值为对象,否则断言失败

1 2
static assert.isObject(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNotObject

测试数值不为对象,否则断言失败

1 2
static assert.isNotObject(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isArray

测试数值为数组,否则断言失败

1 2
static assert.isArray(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNotArray

测试数值不为数组,否则断言失败

1 2
static assert.isNotArray(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isString

测试数值为字符串,否则断言失败

1 2
static assert.isString(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNotString

测试数值不为字符串,否则断言失败

1 2
static assert.isNotString(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNumber

测试数值为数字,否则断言失败

1 2
static assert.isNumber(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNotNumber

测试数值不为数字,否则断言失败

1 2
static assert.isNotNumber(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isBoolean

测试数值为布尔,否则断言失败

1 2
static assert.isBoolean(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

isNotBoolean

测试数值不为布尔,否则断言失败

1 2
static assert.isNotBoolean(Value actual, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • msg: String, 断言失败时的提示信息

typeOf

测试数值为给定类型,否则断言失败

1 2 3
static assert.typeOf(Value actual, String type, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • type: String, 指定的类型
  • msg: String, 断言失败时的提示信息

notTypeOf

测试数值不为给定类型,否则断言失败

1 2 3
static assert.notTypeOf(Value actual, String type, String msg = "");

调用参数:

  • actual: Value, 要测试的数值
  • type: String, 指定的类型
  • msg: String, 断言失败时的提示信息

property

测试对象中包含指定属性,否则断言失败

1 2 3
static assert.property(Value object, Value prop, String msg = "");

调用参数:

  • object: Value, 要测试的对象
  • prop: Value, 要测试的属性
  • msg: String, 断言失败时的提示信息

notProperty

测试对象中不包含指定属性,否则断言失败

1 2 3
static assert.notProperty(Value object, Value prop, String msg = "");

调用参数:

  • object: Value, 要测试的对象
  • prop: Value, 要测试的属性
  • msg: String, 断言失败时的提示信息

deepProperty

深度测试对象中包含指定属性,否则断言失败

1 2 3
static assert.deepProperty(Value object, Value prop, String msg = "");

调用参数:

  • object: Value, 要测试的对象
  • prop: Value, 要测试的属性,以“.”分割
  • msg: String, 断言失败时的提示信息

notDeepProperty

深度测试对象中不包含指定属性,否则断言失败

1 2 3
static assert.notDeepProperty(Value object, Value prop, String msg = "");

调用参数:

  • object: Value, 要测试的对象
  • prop: Value, 要测试的属性,以“.”分割
  • msg: String, 断言失败时的提示信息

propertyVal

测试对象中指定属性的值为给定值,否则断言失败

1 2 3 4
static assert.propertyVal(Value object, Value prop, Value value, String msg = "");

调用参数:

  • object: Value, 要测试的对象
  • prop: Value, 要测试的属性
  • value: Value, 给定的值
  • msg: String, 断言失败时的提示信息

propertyNotVal

测试对象中指定属性的值不为给定值,否则断言失败

1 2 3 4
static assert.propertyNotVal(Value object, Value prop, Value value, String msg = "");

调用参数:

  • object: Value, 要测试的对象
  • prop: Value, 要测试的属性
  • value: Value, 给定的值
  • msg: String, 断言失败时的提示信息

deepPropertyVal

深度测试对象中指定属性的值为给定值,否则断言失败

1 2 3 4
static assert.deepPropertyVal(Value object, Value prop, Value value, String msg = "");

调用参数:

  • object: Value, 要测试的对象
  • prop: Value, 要测试的属性,以“.”分割
  • value: Value, 给定的值
  • msg: String, 断言失败时的提示信息

deepPropertyNotVal

深度测试对象中指定属性的值不为给定值,否则断言失败

1 2 3 4
static assert.deepPropertyNotVal(Value object, Value prop, Value value, String msg = "");

调用参数:

  • object: Value, 要测试的对象
  • prop: Value, 要测试的属性,以“.”分割
  • value: Value, 给定的值
  • msg: String, 断言失败时的提示信息

throws

测试给定的代码会抛出错误,未抛出则断言失败

1 2
static assert.throws(Function block, String msg = "");

调用参数:

  • block: Function, 指定测试的代码,以函数形式给出
  • msg: String, 断言失败时的提示信息

doesNotThrow

测试给定的代码不会抛出错误,抛出则断言失败

1 2
static assert.doesNotThrow(Function block, String msg = "");

调用参数:

  • block: Function, 指定测试的代码,以函数形式给出
  • msg: String, 断言失败时的提示信息

ifError

如果参数为真,则抛出

1
static assert.ifError(Value object = undefined);

调用参数:

  • object: Value, 参数