NodeJs下的測試框架Mocha的簡單介紹

2019-11-19 17:26:59

字體：大中小

來源：轉載

供稿：網友

介紹和代碼下載

Mocha在2011年發布，是目前最為流行的javascript框架之一，在本文我們重點介紹它在NodeJs上的使用。

如果你需要下載實例代碼，可以通過去官網查找。https://mochajs.org/

下載代碼后安裝依賴：

$ cd DemoOfMocha$ npm install

代碼目錄結構如圖所示：

您可以按照代碼目錄結構在根目錄新建lib文件夾和test文件夾，再在test文件夾中新建lib文件夾，然后通過npm init命令來生成package.json，也可以先將代碼下載下來跑一下

第一個測試

現在在lib目錄下新建一個sum.js文件

exports.sum =function (a,b) { return a+b}

接下來測試這個腳本，在test目錄下的lib文件夾中新建測試腳本：sum.js

//test/lib/sum.jsvar sum = require('../../lib/sum')var assert = require('assert')describe('和函數的測試',function () { it('1加1應該等于2',function () { var expect=10; assert.equal(sum(1,1),expect); })})

上面的代碼是測試腳本，測試腳本可以獨立執行，測試腳本里應該包含一個或者多個 describe 塊，每個describe塊也應該包含一個或者多個 it 塊

describe 塊是“ 測試套件”，表示一組相關的測試，是一個函數，第二個是實際可以執行的函數

It 塊是“測試用例” 表示一個單獨的測試，測試的最小單位，也是一個函數，第一參數是測試用例的名稱或說明，第二個參數是實際可以執行的函數

assert 是斷言包（斷言包有很多種，這里我使用NodeJs自帶的斷言包），判斷測試代碼的執行結果和預期的結果是否一致，不一致的話拋出一個錯誤，在我們的測試腳本中，sum(1,1)，結果應該等于2

我們在這里介紹一下Assert的斷言模塊的一些函數

assert.fail(actual, expected, message, operator)

使用指定操作符測試actual（真實值）是否和expected（期望值）一致。

assert.ok(value, [message])

測試實際值是否為true，和assert.equal(true, value, message);作用一致

assert.equal(actual, expected, [message])

使用等值比較操作符( == )測試真實值是否淺層地（shallow），強制性地（coercive）和預期值相等。

assert.notEqual(actual, expected, [message])

使用不等比較操作符( != )測試真實值是否淺層地（shallow），強制性地（coercive）和預期值不相等。

assert.deepEqual(actual, expected, [message])

測試真實值是否深層次地和預期值相等。

assert.notDeepEqual(actual, expected, [message])

測試真實值是否深層次地和預期值不相等。

assert.strictEqual(actual, expected, [message])

使用嚴格相等操作符 ( === )測試真實值是否嚴格地（strict）和預期值相等。

assert.notStrictEqual(actual, expected, [message])

使用嚴格不相等操作符 ( !== )測試真實值是否嚴格地（strict）和預期值不相等。

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

預期block時拋出一個錯誤（error）， error可以為構造函數，正則表達式或者其他驗證器。

接下來我們在package.json中更新一下scripts字段

{ "name": "DemoOfMocha", "version": "1.0.0", "description": "demo of mocha", "main": "index.js", "directories": { "test": "test" }, "dependencies": {}, "devDependencies": {}, "scripts": { "test": "NODE_ENV=test mocha test/**/*.js" }, "keywords": [ "deom", "mocha" ], "author": "wjszxli", "license": "ISC"}

我們通過npm命令去安裝MochaJS

$ npm install mocha --save-dev

我們添加了運行測試的命令，接下來通過命令來獲得測試報告

$ npm test

測試報告如下：

這樣，我們第一個測試就成功了

讓測試報告變得更漂亮

我們可以使用mochawesome模塊，生成漂亮的HTML格式的報告，如圖：

通過如下命令進行安裝mochawesome

$ npm install --save-dev mochawesome

然后更新在package.json中的scripts字段

 "name": "DemoOfMocha", "version": "1.0.0", "description": "demo of mocha", "main": "index.js", "directories": { "test": "test" }, "dependencies": {}, "devDependencies": { "mocha": "^3.2.0", "mochawesome": "^2.0.4" }, "scripts": { "test": "NODE_ENV=test mocha test/**/*.js --reporter mochawesome" }, "keywords": [ "deom", "mocha" ], "author": "wjszxli", "license": "ISC”}

運行測試命令，測試報表就在mochawesome-reports中生成了

用瀏覽器打開下的html頁面，我們會看到漂亮的測試報告

異步測試

Mocha默認每個測試用例最多執行2000毫秒，2000毫秒之后沒有得到結果，就會報錯，如果涉及到異步操作的測試用例，2000毫秒是不夠的，這個時候我們需要用 -t 或 ―timeout 參數指定超時門檻

我們可以修改在package.json中的scripts字段（我們這里改成3000毫秒）

"scripts": { "test": "NODE_ENV=test mocha -t 3000 timeout test/**/*.js --reporter mochawesome”},

寫一個異步測試腳本

//test/lib/timeout.jsvar assert = require('assert')describe('測試應該3000毫秒后結束',function () { it('測試應該3000毫秒后結束',function (over) { var a=false; var b = function () {  a=true;  assert.ok(a);  over(); }; setTimeout(b,2500); })})

這個測試用例在執行 it 塊的時候傳入了一個參數 over，在測試結束的時候必須顯式的調用這個函數，告訴Mocha測試結束了，否則Mocha就會等到超時結束的時候報錯。

輸入命令運行測試用例

我們也可以測試異步請求內部地址或者外部的接口，這里我們請求內部地址為例子：

在根目錄新建：app.js

var express = require('express')var app = express();app.get('/api/test',function (req,res) { res.send({})})var port = process.env.PORT || 3000if (process.env.NODE_ENV !== 'test') { app.listen(port); console.log('start from http://localhost:' + port)} else { module.exports = app;}

在test目錄下的lib文件夾中新建 async.js

//test/lib/async.jsvar http = require('http')var assert = require('assert')var request = require('superagent');describe("測試異步請求",function () { it("測試異步請求返回一個對象",function (next) { request  .get('http://localhost:3000/api/test')  .end(function(err, res){  //expect(res).to.be.an('object');  console.log(res.body);  assert.deepEqual(res.body,Object)  next();  }); })})

測試結果

Mocha支持對Promist的測試，允許直接返回Promise,等到他的狀態發生變化之后，再執行斷言

//test/lib/promise.jsvar fetch = require('node-fetch');var http = require('http')var assert = require('assert')describe('Promise 異步測試',function () { it('異步Promise返回一個對象',function () { return fetch('http://localhost:3000/api/test')  .then(function(res) {  return res.json();  }).then(function(json) {  console.log(json)  assert.deepEqual(json,{});  }); })})

執行測試

測試的鉤子

在 describe 塊之中，有四個測試用例的鉤子：before()、after()、beforeEach()和afterEach()。它們會在指定時間執行。

describe('hooks', function() {  before(function() {  // 在當前區塊的所有測試用例之前執行  });  after(function() {  // 在當前區塊的所有測試用例之后執行  });  beforeEach(function() {  // 在當前區塊的每個測試用例之前執行  });  afterEach(function() {  // 在當前區塊的每個測試用例之后執行  });  //測試用例 });

在test目錄下的lib文件夾中新建 hooks.js

//test/lib/hooks.jsvar assert = require('assert')describe('hook示例', function() { var foo = false; beforeEach(function() { foo = true; }); it('修改foo要成功', function() { assert.ok(foo) });});

測試結果

測試用例管理

如果項目有很多測試用例，但有的時候只希望運行其中幾個，這個時候可以用 only 方法，describe 塊和 it 塊都允許 only 方法，表示只允許運行帶有 only 的測試用例

在test目錄下的lib文件夾中新建 only.js

//test/lib/only.jsvar sum = require('../../lib/sum')var assert = require('assert')describe('和函數的測試',function () { it('1加2應該等于3',function () { var expect=3; assert.equal(sum(1,2),expect); }) it.only('3加4應該等于7',function () { var expect=7; assert.equal(sum(3,4),expect); })})

測試結果：

還有 skip 方法，表示跳過指定的測試用例

在test目錄下的lib文件夾中新建 skip.js

//test/lib/only.jsvar sum = require('../../lib/sum')var assert = require('assert')describe('和函數的測試',function () { it('5加6應該等于11',function () { var expect=11; assert.equal(sum(5,6),expect); }) it.skip('7加8應該等于15',function () { var expect=15; assert.equal(sum(7,8),expect); })})

測試結果如下，跳過的用 - 號表示