nodejs assert 模块

assert模块是Node的内置模块，主要用于断定。如果表达式不符合预期，就抛出一个错误。该模块提供11个方法，但只有少数几个是常用的。

1.assert()

assert(value[, message])

assert.ok() 的别名，ok是assert方法的另一个名字，与assert方法完全一样。

 

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。

2.assert.throws(block[, error][, message])

断定 block 函数会抛出错误（通俗解释throws方法预期某个代码块会抛出一个错误，且抛出的错误符合指定的条件。）。

error 参数可以是构造函数、正则表达式、或自定义函数。

如果指定了 message 参数，则当 block 函数不抛出错误时，message 参数会作为 AssertionError 的错误信息。

// 格式
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;
    }
  },
  '不符合预期的错误类型'
);

error 参数不能是字符串。 如果第二个参数是字符串，则视为省略 error 参数，传入的字符串会被用于 message 参数。 例如：

// 这是错误的！不要这么做！
assert.throws(myFunction, '错误信息', '没有抛出期望的信息');

// 应该这么做。
assert.throws(myFunction, /错误信息/, '没有抛出期望的信息');

3.assert.doesNotThrow(block[, error][, message])

断定 block 函数不会抛出错误。

当 assert.doesNotThrow() 被调用时，它会立即调用 block 函数。

如果抛出错误且错误类型与 error 参数指定的相同，则抛出 AssertionError。 如果错误类型不相同，或 error 参数为 undefined，则抛出错误（通俗解释doesNotThrow方法与throws方法正好相反，预期某个代码块不抛出错误。）。

// 格式
assert.doesNotThrow(block, [message])

// 用法
assert.doesNotThrow(
  function() {
    console.log("Nothing to see here");
  },
  '预期不抛出错误'
);

以下例子会抛出 TypeError，因为在断定中没有匹配的错误类型：

assert.doesNotThrow(
  () => {
    throw new TypeError('错误信息');
  },
  SyntaxError
);

以下例子会抛出一个带有 Got unwanted exception (TypeError).. 信息的 AssertionError：因为错误类型相同

assert.doesNotThrow(
  () => {
    throw new TypeError('错误信息');
  },
  TypeError
);

如果抛出了 AssertionError 且有给 message 参数传值，则 message 参数的值会被附加到 AssertionError 的信息中：

assert.doesNotThrow(
  () => {
    throw new TypeError('错误信息');
  },
  TypeError,
  '抛出错误'
);
// 抛出 AssertionError: Got unwanted exception (TypeError). 抛出错误