NodeJs下的測試框架Mocha


介紹和代碼下載

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

如果你需要下載實例代碼,可以通過這個鏈接 gitClone 或者下載zip壓縮包

下載代碼后安裝依賴:

$ cd DemoOfMocha
$ npm install

代碼目錄結構如圖所示:

alt

您可以按照代碼目錄結構在根目錄新建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

測試報告如下:

alt

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

讓測試報告變得更漂亮

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

alt

通過如下命令進行安裝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中生成了

alt

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

alt

異步測試

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就會等到超時結束的時候報錯。

輸入命令運行測試用例

alt

我們也可以測試異步請求內部地址或者外部的接口,這里我們請求內部地址為例子:
在根目錄新建: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();
            });
    })
})

測試結果

alt

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,{});
            });
    })
})

執行測試

alt

測試的鈎子

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)
    });
});

測試結果

alt

測試用例管理

如果項目有很多測試用例,但有的時候只希望運行其中幾個,這個時候可以用 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);
    })
})

測試結果:

alt

還有 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);
    })
})

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

alt

本人的博客http://www.wjs.photo/,感興趣的可以看看哦,基於NodeJs框架ThinkJs


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM