assert模塊是Node的內置模塊,主要用于斷言。如果表達式不符合預期,就拋出一個錯誤。該模塊提供11個方法,但只有少數幾個是常用的。
[TOC]
## 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。
## assert.ok()
ok是assert方法的另一個名字,與assert方法完全一樣。
## assert.equal()
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方法內部使用的是相等運算符(==),而不是嚴格運算符(===),進行比較運算。
## assert.notEqual()
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方法內部使用不相等運算符(!=),而不是嚴格不相等運算符(!==),進行比較運算。
## assert.deepEqual()
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, '預期兩個對象應該有相同的屬性');
~~~
## assert.notDeepEqual()
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, '預期兩個對象不相等');
~~~
## assert.strictEqual()
strictEqual方法使用嚴格相等運算符(===),比較兩個表達式。
~~~
// 格式
assert.strictEqual(actual, expected, [message])
// 例子
var assert = require('assert');
assert.strictEqual(1, '1', '預期嚴格相等');
// AssertionError: 預期嚴格相等
~~~
## assert.notStrictEqual()
assert.notStrictEqual方法使用嚴格不相等運算符(!==),比較兩個表達式。
~~~
// 格式
assert.notStrictEqual(actual, expected, [message])
// 例子
var assert = require('assert');
assert.notStrictEqual(1, true, '預期嚴格不相等');
~~~
## assert.throws()
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;
}
},
'不符合預期的錯誤類型'
);
~~~
## assert.doesNotThrow()
doesNotThrow方法與throws方法正好相反,預期某個代碼塊不拋出錯誤。
~~~
// 格式
assert.doesNotThrow(block, [message])
// 用法
assert.doesNotThrow(
function() {
console.log("Nothing to see here");
},
'預期不拋出錯誤'
);
~~~
## assert.ifError()
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);
// ...
})
~~~
## assert.fail()
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,否則錯誤信息就是“實際值 + 分隔符 + 預期值”。
- 第一章 導論
- 1.1 前言
- 1.2 為什么學習JavaScript?
- 1.3 JavaScript的歷史
- 第二章 基本語法
- 2.1 語法概述
- 2.2 數值
- 2.3 字符串
- 2.4 對象
- 2.5 數組
- 2.6 函數
- 2.7 運算符
- 2.8 數據類型轉換
- 2.9 錯誤處理機制
- 2.10 JavaScript 編程風格
- 第三章 標準庫
- 3.1 Object對象
- 3.2 Array 對象
- 3.3 包裝對象和Boolean對象
- 3.4 Number對象
- 3.5 String對象
- 3.6 Math對象
- 3.7 Date對象
- 3.8 RegExp對象
- 3.9 JSON對象
- 3.10 ArrayBuffer:類型化數組
- 第四章 面向對象編程
- 4.1 概述
- 4.2 封裝
- 4.3 繼承
- 4.4 模塊化編程
- 第五章 DOM
- 5.1 Node節點
- 5.2 document節點
- 5.3 Element對象
- 5.4 Text節點和DocumentFragment節點
- 5.5 Event對象
- 5.6 CSS操作
- 5.7 Mutation Observer
- 第六章 瀏覽器對象
- 6.1 瀏覽器的JavaScript引擎
- 6.2 定時器
- 6.3 window對象
- 6.4 history對象
- 6.5 Ajax
- 6.6 同域限制和window.postMessage方法
- 6.7 Web Storage:瀏覽器端數據儲存機制
- 6.8 IndexedDB:瀏覽器端數據庫
- 6.9 Web Notifications API
- 6.10 Performance API
- 6.11 移動設備API
- 第七章 HTML網頁的API
- 7.1 HTML網頁元素
- 7.2 Canvas API
- 7.3 SVG 圖像
- 7.4 表單
- 7.5 文件和二進制數據的操作
- 7.6 Web Worker
- 7.7 SSE:服務器發送事件
- 7.8 Page Visibility API
- 7.9 Fullscreen API:全屏操作
- 7.10 Web Speech
- 7.11 requestAnimationFrame
- 7.12 WebSocket
- 7.13 WebRTC
- 7.14 Web Components
- 第八章 開發工具
- 8.1 console對象
- 8.2 PhantomJS
- 8.3 Bower:客戶端庫管理工具
- 8.4 Grunt:任務自動管理工具
- 8.5 Gulp:任務自動管理工具
- 8.6 Browserify:瀏覽器加載Node.js模塊
- 8.7 RequireJS和AMD規范
- 8.8 Source Map
- 8.9 JavaScript 程序測試
- 第九章 JavaScript高級語法
- 9.1 Promise對象
- 9.2 有限狀態機
- 9.3 MVC框架與Backbone.js
- 9.4 嚴格模式
- 9.5 ECMAScript 6 介紹
- 附錄
- 10.1 JavaScript API列表
- 草稿一:函數庫
- 11.1 Underscore.js
- 11.2 Modernizr
- 11.3 Datejs
- 11.4 D3.js
- 11.5 設計模式
- 11.6 排序算法
- 草稿二:jQuery
- 12.1 jQuery概述
- 12.2 jQuery工具方法
- 12.3 jQuery插件開發
- 12.4 jQuery.Deferred對象
- 12.5 如何做到 jQuery-free?
- 草稿三:Node.js
- 13.1 Node.js 概述
- 13.2 CommonJS規范
- 13.3 package.json文件
- 13.4 npm模塊管理器
- 13.5 fs 模塊
- 13.6 Path模塊
- 13.7 process對象
- 13.8 Buffer對象
- 13.9 Events模塊
- 13.10 stream接口
- 13.11 Child Process模塊
- 13.12 Http模塊
- 13.13 assert 模塊
- 13.14 Cluster模塊
- 13.15 os模塊
- 13.16 Net模塊和DNS模塊
- 13.17 Express框架
- 13.18 Koa 框架