作者： 阮一峰

日期： 2015年12月 3日

Mocha（發音"摩卡"）誕生於2011年，是現在最流行的JavaScript測試框架之一，在瀏覽器和Node環境都可以使用。

所謂"測試框架"，就是執行測試的工具。通過它，可以為JavaScript應用新增測試，從而保證程式碼的質量。

本文全面介紹如何使用Mocha，讓你輕鬆上手。如果你以前對測試一無所知，本文也可以當作JavaScript單元測試入門。值得說明的是，除了Mocha以外，類似的測試框架還有Jasmine、Karma、Tape等，也很值得學習。

一、安裝

我為本文寫了一個示例庫Mocha-demos，請先安裝這個庫。

$ git clone https://github.com/ruanyf/mocha-demos.git

如果你的電腦沒裝Git，可以直接下載zip壓縮包，進行解壓。

然後，進入mocha-demos目錄，安裝依賴（你的電腦必須有Node）。

$ cd mocha-demos
$ npm install

上面程式碼會在目錄內部安裝Mocha，為了操作的方便，請在全面環境也安裝一下Mocha。

$ npm install --global mocha
 

二、測試指令碼的寫法

Mocha的作用是執行測試指令碼，首先必須學會寫測試指令碼。所謂"測試指令碼"，就是用來測試原始碼的指令碼。

下面是一個加法模組add.js的程式碼。

// add.js
function add(x, y) {
  return x + y;
}

module.exports = add;

要測試這個加法模組是否正確，就要寫測試指令碼。

通常，測試指令碼與所要測試的原始碼指令碼同名，但是字尾名為.test.js（表示測試）或者.spec.js（表示規格）。比如，add.js的測試指令碼名字就是add.test.js

。

// add.test.js
var add = require('./add.js');
var expect = require('chai').expect;

describe('加法函式的測試', function() {
  it('1 加 1 應該等於 2', function() {
    expect(add(1, 1)).to.be.equal(2);
  });
});

上面這段程式碼，就是測試指令碼，它可以獨立執行。測試腳本里面應該包括一個或多個describe塊，每個describe塊應該包括一個或多個it塊。

describe塊稱為"測試套件"（test suite），表示一組相關的測試。它是一個函式，第一個引數是測試套件的名稱（"加法函式的測試"），第二個引數是一個實際執行的函式。

it塊稱為"測試用例"（test case），表示一個單獨的測試，是測試的最小單位。它也是一個函式，第一個引數是測試用例的名稱（"1 加 1 應該等於 2"），第二個引數是一個實際執行的函式。

三、斷言庫的用法

上面的測試腳本里面，有一句斷言。

expect(add(1, 1)).to.be.equal(2);

所謂"斷言"，就是判斷原始碼的實際執行結果與預期結果是否一致，如果不一致就丟擲一個錯誤。上面這句斷言的意思是，呼叫add(1, 1)，結果應該等於2。

所有的測試用例（it塊）都應該含有一句或多句的斷言。它是編寫測試用例的關鍵。斷言功能由斷言庫來實現，Mocha本身不帶斷言庫，所以必須先引入斷言庫。

var expect = require('chai').expect;

斷言庫有很多種，Mocha並不限制使用哪一種。上面程式碼引入的斷言庫是chai，並且指定使用它的expect斷言風格。

expect斷言的優點是很接近自然語言，下面是一些例子。

// 相等或不相等
expect(4 + 5).to.be.equal(9);
expect(4 + 5).to.be.not.equal(10);
expect(foo).to.be.deep.equal({ bar: 'baz' });

// 布林值為true
expect('everthing').to.be.ok;
expect(false).to.not.be.ok;

// typeof
expect('test').to.be.a('string');
expect({ foo: 'bar' }).to.be.an('object');
expect(foo).to.be.an.instanceof(Foo);

// include
expect([1,2,3]).to.include(2);
expect('foobar').to.contain('foo');
expect({ foo: 'bar', hello: 'universe' }).to.include.keys('foo');

// empty
expect([]).to.be.empty;
expect('').to.be.empty;
expect({}).to.be.empty;

// match
expect('foobar').to.match(/^foo/);

基本上，expect斷言的寫法都是一樣的。頭部是expect方法，尾部是斷言方法，比如equal、a/an、ok、match等。兩者之間使用to或to.be連線。

如果expect斷言不成立，就會丟擲一個錯誤。事實上，只要不丟擲錯誤，測試用例就算通過。

it('1 加 1 應該等於 2', function() {});

上面的這個測試用例，內部沒有任何程式碼，由於沒有丟擲了錯誤，所以還是會通過。

四、Mocha的基本用法

有了測試指令碼以後，就可以用Mocha執行它。請進入demo01子目錄，執行下面的命令。

$ mocha add.test.js

  加法函式的測試
    ✓ 1 加 1 應該等於 2

  1 passing (8ms)

上面的執行結果表示，測試指令碼通過了測試，一共只有1個測試用例，耗時是8毫秒。

相關推薦