摘要:斷言穩(wěn)定級別鎖定斷言模塊提供了一個簡單斷言集,用于測試不變量。但是要注意,斷言模塊并不是一個測試框架,也不是一個通用的斷言庫。斷言模塊的已經(jīng)鎖定。版本加入測試深且強(qiáng)不等,與對立。版本加入測試是否為真。
斷言
穩(wěn)定級別:3 - 鎖定
斷言模塊提供了一個簡單斷言集,用于測試不變量。本模塊原本是Node.js的內(nèi)部使用,但也可以通過require("assert")在應(yīng)用中使用。但是要注意,斷言模塊并不是一個測試框架,也不是一個通用的斷言庫。
斷言模塊的API已經(jīng)鎖定。意味著在未來,本模塊應(yīng)用和暴露的方法都不會有任何修改或者增加。
assert(value[, message])v0.5.9版本加入
是assert.ok()的alias。
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])
v0.1.21版本加入
用于測試 actual和expected的深等于。基本數(shù)據(jù)類型的值將會用等價(jià)運(yùn)算符( == )作比較。
本方法只適用于可枚舉且返回自身的屬性。 deepEqual()不能用于測試對象原型、附加符號、不可枚舉的屬性。這一點(diǎn)可能會導(dǎo)致一些意想不到的結(jié)果。比如,下面的例子不會拋出AssertionError,因?yàn)镋rror對象的屬性是不可枚舉的。
// 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, 一個對象和自身肯定是相等的 assert.deepEqual(obj1, obj2); // AssertionError: { a: { b: 1 } } deepEqual { a: { b: 2 } } // b的值不同 assert.deepEqual(obj1, obj3); // OK, 兩個對象是相等的 assert.deepEqual(obj1, obj4); // AssertionError: { a: { b: 1 } } deepEqual {} // 對象原型不能用于比較
如果傳入的兩個參數(shù)不相等,將會拋出一個AssertionError,它會自帶一個message屬性,可由message傳參設(shè)置。如果message傳參是undefined,就會給它賦值一個默認(rèn)的錯誤信息。
assert.deepStrictEqual(actual, expected[, message])v1.2.0版本加入
與assert.deepEqual()只有兩個區(qū)別。第一,基本數(shù)據(jù)類型的值是用強(qiáng)等價(jià)運(yùn)算符(===)來比較的。第二,對象之間的比較要求它們的原型(prototype)也一致。
如果傳入的兩個參數(shù)不相等,將會拋出一個AssertionError,它會自帶一個message屬性,可由message傳參設(shè)置。如果message傳參是undefined,就會給它賦值一個默認(rèn)的錯誤信息。
assert.doesNotThrow(block, error)v0.1.21版本加入
斷言block方法不會拋出錯誤,關(guān)于拋出(throw)可參加assert.throw()了解更多細(xì)節(jié)。
當(dāng)assert.doesNotThrow()被調(diào)用的時候,它會立即調(diào)用block方法。
如果有錯誤拋出,并且錯誤類型與傳參中的錯誤類型一致,此方法將拋出一個AssertionError。如果錯誤類型不一致,或者傳參error未定義,那么錯誤會被回傳給調(diào)用者。
比如下例中,將會拋出一個TypeError,因?yàn)殄e誤類型不一致。
assert.doesNotThrow( () => { throw new TypeError("Wrong value"); }, SyntaxError );
但下例中就會拋出AssertionError并附帶message“Got unwanted exception (TypeError)..”。
assert.doesNotThrow( () => { throw new TypeError("Wrong value"); }, TypeError );
當(dāng)有AssertionError拋出的時候,如果傳參中定義了message參數(shù),那么它將會被附到AssertionError的message后面。
assert.doesNotThrow( () => { throw new TypeError("Wrong value"); }, TypeError, "Whoops" ); // Throws: AssertionError: Got unwanted exception (TypeError). Whoopsassert.equal(actual, expected[, message])
v0.1.21版本加入
用等價(jià)運(yùn)算符(==)比較actual和expected的淺等于。
const assert = require("assert"); assert.equal(1, 1); // OK, 1 == 1 assert.equal(1, "1"); // OK, 1 == "1" assert.equal(1, 2); // AssertionError: 1 == 2 assert.equal({a: {b: 1}}, {a: {b: 1}}); //AssertionError: { a: { b: 1 } } == { a: { b: 1 } }
如果傳入的兩個參數(shù)不相等,將會拋出一個AssertionError,它會自帶一個message屬性,可由message傳參設(shè)置。如果message傳參是undefined,就會給它賦值一個默認(rèn)的錯誤信息。
assert.fail(actual, expected, message, operator)v0.1.21版本加入
拋出AssertionError。如果message也就是比較結(jié)果為假,那么錯誤信息輸出actual和expected的值,用傳入的運(yùn)算符隔開;如果結(jié)果為真,錯誤信息輸出傳入的message。
const assert = require("assert"); assert.fail(1, 2, undefined, ">"); // AssertionError: 1 > 2 assert.fail(1, 2, "whoops", ">"); // AssertionError: whoopsassert.ifError(value)
v0.1.97版本加入
如果value為真則輸出value值。適合用于測試回調(diào)方法中的error參數(shù)。
const assert = require("assert"); assert.ifError(0); // OK assert.ifError(1); // Throws 1 assert.ifError("error"); // Throws "error" assert.ifError(new Error()); // Throws Errorassert.notDeepEqual(actual, expected[, message])
v0.1.21版本加入
測試深不等,與assert.deepEqual()對立。
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.notDeepEqual(obj1, obj1); // AssertionError: { a: { b: 1 } } notDeepEqual { a: { b: 1 } } assert.notDeepEqual(obj1, obj2); // OK, obj1 and obj2 are not deeply equal assert.notDeepEqual(obj1, obj3); // AssertionError: { a: { b: 1 } } notDeepEqual { a: { b: 1 } } assert.notDeepEqual(obj1, obj4); // OK, obj1 and obj2 are not deeply equal
如果傳入的兩個參數(shù)深相等,將會拋出一個AssertionError,它會自帶一個message屬性,可由message傳參設(shè)置。如果message傳參是undefined,就會給它賦值一個默認(rèn)的錯誤信息。
assert.notDeepStrictEqual(actual, expected[, message])v1.2.0版本加入
測試深且強(qiáng)不等,與assert.deepStrictEqual()對立。
const assert = require("assert"); assert.notDeepEqual({a:1}, {a:"1"}); // AssertionError: { a: 1 } notDeepEqual { a: "1" } assert.notDeepStrictEqual({a:1}, {a:"1"}); // OK
如果傳入的兩個參數(shù)深且強(qiáng)相等,將會拋出一個AssertionError,它會自帶一個message屬性,可由message傳參設(shè)置。如果message傳參是undefined,就會給它賦值一個默認(rèn)的錯誤信息。
assert.notEqual(actual, expected[, message])v0.1.21版本加入
用不等價(jià)運(yùn)算符(!=)測試淺不等。
const assert = require("assert"); assert.notEqual(1, 2); // OK assert.notEqual(1, 1); // AssertionError: 1 != 1 assert.notEqual(1, "1"); // AssertionError: 1 != "1"
如果傳入的兩個參數(shù)淺相等,將會拋出一個AssertionError,它會自帶一個message屬性,可由message傳參設(shè)置。如果message傳參是undefined,就會給它賦值一個默認(rèn)的錯誤信息。
assert.notStrictEqual(actual, expected[, message])v0.1.21版本加入
用強(qiáng)不等運(yùn)算符(!==)測試強(qiáng)不等。
const assert = require("assert"); assert.notStrictEqual(1, 2); // OK assert.notStrictEqual(1, 1); // AssertionError: 1 != 1 assert.notStrictEqual(1, "1"); // OK
如果傳入的兩個參數(shù)強(qiáng)等,將會拋出一個AssertionError,它會自帶一個message屬性,可由message傳參設(shè)置。如果message傳參是undefined,就會給它賦值一個默認(rèn)的錯誤信息。
assert.ok(value[, message])v0.1.21版本加入
測試value是否為真。其實(shí)與assert.equal(!!value, true, message)等價(jià)。
如果value不為真,拋出AssertionError,附帶message信息與傳入message一致。如果message傳參是undefined,就會給它賦值一個默認(rèn)的錯誤信息。
const assert = require("assert"); assert.ok(true); // OK assert.ok(1); // OK assert.ok(false); // throws "AssertionError: false == true" assert.ok(0); // throws "AssertionError: 0 == true" assert.ok(false, "it"s false"); // throws "AssertionError: it"s false"assert.strictEqual(actual, expected[, message])
v0.1.21版本加入
用強(qiáng)等運(yùn)算符(===)測試傳參是否強(qiáng)等于。
const assert = require("assert"); assert.strictEqual(1, 2); // AssertionError: 1 === 2 assert.strictEqual(1, 1); // OK assert.strictEqual(1, "1"); // AssertionError: 1 === "1"
如果傳入的兩個參數(shù)不是強(qiáng)等,將會拋出一個AssertionError,它會自帶一個message屬性,可由message傳參設(shè)置。如果message傳參是undefined,就會給它賦值一個默認(rèn)的錯誤信息。
assert.throws(block, error)v0.1.21版本加入
期望block方法拋出錯誤。
如果傳入自定義error,可以是構(gòu)造函數(shù)、正則表達(dá)式或驗(yàn)證函數(shù)。
如果傳入message但沒有錯誤拋出,message將是AssertionError附帶的。
用構(gòu)造函數(shù)驗(yàn)證實(shí)例:
assert.throws( () => { throw new Error("Wrong value"); }, Error );
用正則表達(dá)式驗(yàn)證error:
assert.throws( () => { throw new Error("Wrong value"); }, /value/ );
自定義error驗(yàn)證:
assert.throws( () => { throw new Error("Wrong value"); }, function(err) { if ( (err instanceof Error) && /value/.test(err) ) { return true; } }, "unexpected error" );
請注意error參數(shù)可以為字符串。如果第二個傳參是個字符串,那么error參數(shù)將會被忽略,直接用這個字符串作為輸出的message。但這可能會導(dǎo)致很容易被忽略的問題:
// THIS IS A MISTAKE! DO NOT DO THIS! assert.throws(myFunction, "missing foo", "did not throw with expected message"); // Do this instead. assert.throws(myFunction, /missing foo/, "did not throw with expected message");全文目錄
請查看:全文目錄
文章版權(quán)歸作者所有,未經(jīng)允許請勿轉(zhuǎn)載,若此文章存在違規(guī)行為,您可以聯(lián)系管理員刪除。
轉(zhuǎn)載請注明本文地址:http://systransis.cn/yun/86557.html
摘要:關(guān)于本文檔本文檔的目的,是全面地解釋的,即可作為參考文檔,同時也包含了概念的講解。但有的全新的實(shí)驗(yàn)性的,或者存在危險(xiǎn)性的部分則會被重新設(shè)計(jì)。穩(wěn)定級別鎖定只會有安全性能或相關(guān)的修復(fù)。不接受對此做修改的建議。 關(guān)于本文檔 本文檔的目的,是全面地解釋Node.js的API,即可作為參考文檔,同時也包含了概念的講解。每個章節(jié)都描述了一個內(nèi)置模塊或一個高階概念(high-level concep...
摘要:畢竟官方文檔才是未經(jīng)提煉的純技術(shù)點(diǎn),讀書不能只讀二手書。目前網(wǎng)上能找到的中文文檔基本都是基于的,但截至此文發(fā)布,最新的穩(wěn)定版都已經(jīng)是了。翻譯過程中主要參考官方英文文檔,以及極客學(xué)院的官方文檔中文翻譯。 前言 相信很多開發(fā)者和我一樣,在學(xué)習(xí)一門技術(shù)的時候,通過網(wǎng)上的各種教程和視頻入門之后會發(fā)現(xiàn)自己遇到一個上升瓶頸。造成這個瓶頸的很大一部分原因,我認(rèn)為是進(jìn)階教程的知識點(diǎn)過于分散,同時高質(zhì)量...
摘要:用法具體的參數(shù)及腳本運(yùn)行方式,請參考命令行工具章節(jié)。示例用寫的一個返回的服務(wù)器示例要運(yùn)行此服務(wù)器,將上面所示代碼放入文件,并用執(zhí)行它本文檔中所有的示例均可以類似方式運(yùn)行。全文目錄請查看全文目錄 用法 node [options] [v8 options] [script.js | -e script] [arguments] 具體的option參數(shù)及腳本運(yùn)行方式,請參考命令行工具章節(jié)。...
摘要:單元測試,測試一個簡單的組件。接口測試,用戶信息接口測試。學(xué)習(xí)借鑒,一些使用做測試的開源項(xiàng)目。這里使用到的內(nèi)置斷言斷言結(jié)果值等于我們想要的預(yù)期值,則測試通過。在里放入一個函數(shù),函數(shù)自動執(zhí)行,里面執(zhí)行的結(jié)果必須拋出錯誤,則測試通過。 目錄 1、為什么選擇 AVA ?2、API 概覽。3、準(zhǔn)備工作。4、單元測試,測試一個簡單的工具函數(shù)。5、使用 Promise、Async/await、Ob...
摘要:單元測試上一節(jié)有討論過,單元測試就是以代碼單元為單位進(jìn)行測試,代碼單元可以是一個函數(shù),一個模塊,或者一個類。單元測試是最容易理解也最容易實(shí)現(xiàn)的測試方式。在寫單元測試的時候,盡量將你的單元測試獨(dú)立出來,不要幾個單元互相引用。 showImg(https://segmentfault.com/img/remote/1460000008823416?w=997&h=350); 本文作者:G...
閱讀 1316·2021-11-22 09:34
閱讀 2178·2021-10-08 10:18
閱讀 1737·2021-09-29 09:35
閱讀 2471·2019-08-29 17:20
閱讀 2149·2019-08-29 15:36
閱讀 3412·2019-08-29 13:52
閱讀 791·2019-08-29 12:29
閱讀 1196·2019-08-28 18:10