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). 抛出错误

巴特西

nodejs assert 模块

1.assert()

assert(value[, message])

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

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

最新文章

热门文章