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

介紹和程式碼下載

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.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://www.php.cn/:' + 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);
 })
})

测试结果如下，跳过的用 - 号表示

以上就是本文的全部内容，希望对大家的学习有所帮助，也希望大家多多支持PHP中文网。

更多NodeJs下的測試框架Mocha的簡單介紹相关文章请关注PHP中文网！