介紹和代碼下載
Mocha在2011年發布,是目前最為流行的javascript框架之一,在本文我們重點介紹它在NodeJs上的使用。
如果你需要下載實例代碼,可以通過這個鏈接 gitClone 或者下載zip壓縮包
下載代碼后安裝依賴:
$ 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.js
var 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.js
var 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 || 3000
if (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.js
var 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.js
var 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.js
var 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.js
var 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.js
var 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);
})
})
測試結果如下,跳過的用 - 號表示
本人的博客http://www.wjs.photo/,感興趣的可以看看哦,基於NodeJs框架ThinkJs