Mocha

测试框架Mocha
现在流行的JavaScript测试框架之一,在浏览器和Node环境中都可以使用。
一、安装
我为本文写了一个示例库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
function add(x,y){
return x+y;
}
module.exports=add;
测试脚本
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"),第二个参数是一个实际执行的函数。
三、断言库的用法
断言:判断源码的实际执行结果与预期结果是否一致,如果不一致则抛出一个错误。
所有的测试用例(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连接。
四、Mocha的基本用法
$ mocha add.test.js

加法函数的测试
✓ 1 加 1 应该等于 2

1 passing (8ms)
mocha命令后紧跟脚本的路径和文件名,可以指定多个测试脚本。
$mocha file1 file2 file3

Mocha默认运行test子目录里面的测试脚本,所以,一般都会把测试脚本放到test目录里面,然后执行mocha就不需要参数了。

这时可以看到,test子目录里面的测试脚本执行了。但是,你打开test子目录,会发现下面还有一个test/dir子目录,里面还有一个测试脚本multiply.test.js,并没有得到执行。原来,Mocha默认只执行test子目录下面第一层的测试用例,不会执行更下层的用例。
为了改变这种行为,就必须加上--recursive参数,这时test子目录下面所有的测试用例----不管在哪一层----都会执行。
$ mocha --recursive//回归的,递归的

五、通配符
命令行指定测试脚本时,可以使用通配符,同时指定多个文件。
mocha spec/{my,awesome}.js mocha test/unit/*.js

六、命令行参数
除了前面介绍的--recursive,Mocha还可以加上其他命令行参数。
6.1 --help, -h
--help或-h参数,用来查看Mocha的所有命令行参数。
6.2 --reporter, -R
--reporter参数用来指定测试报告的格式,默认是spec格式。
6.3 --growl, -G
打开--growl参数,就会将测试结果在桌面显示。
6.4 --watch,-w
--watch参数用来监视指定的测试脚本。只要测试脚本有变化,就会自动运行Mocha。

$ mocha --watch
上面命令执行以后,并不会退出。你可以另外打开一个终端窗口,修改test目录下面的测试脚本add.test.js,比如删除一个测试用例,一旦保存,Mocha就会再次自动运行。
6.6 --grep, -g
--grep参数用于搜索测试用例的名称(即it块的第一个参数),然后只执行匹配的测试用例。

$ mocha --grep "1 加 1"
上面代码只测试名称中包含"1 加 1"的测试用例。
6.7 --invert, -i
--invert参数表示只运行不符合条件的测试脚本,必须与--grep参数配合使用。

$ mocha --grep "1 加 1" --invert

七,配置文件mocha.opts
Mocha允许在test目录下面,放置配置文件mocha.opts,把命令行参数写在里面。请先进入demo03目录,运行下面的命令。

$ mocha --recursive --reporter tap --growl
上面这个命令有三个参数--recursive、--reporter tap、--growl。
然后,把这三个参数写入test目录下的mocha.opts文件。

--reporter tap
--recursive
--growl
然后,执行mocha就能取得与第一行命令一样的效果。

$ mocha
如果测试用例不是存放在test子目录,可以在mocha.opts写入以下内容。

server-tests
--recursive
上面代码指定运行server-tests目录及其子目录之中的测试脚本。

八、ES6测试
如果测试脚本是用ES6写的,那么运行测试之前,需要先用Babel转码。
test/add.test.js
import add from '../src/add.js';
import chai from 'chai';

let expect = chai.expect;

describe('加法函数的测试', function() {
it('1 加 1 应该等于 2', function() {
expect(add(1, 1)).to.be.equal(2);
});
});
ES6转码,需要安装Babel。
$ npm install babel-core babel-preset-es2015 --save-dev
然后,在项目目录下面,新建一个.babelrc配置文件。

{
"presets": [ "es2015" ]
}
最后,使用--compilers参数指定测试脚本的转码器。

$ ../node_modules/mocha/bin/mocha --compilers js:babel-core/register
上面代码中,--compilers参数后面紧跟一个用冒号分隔的字符串,冒号左边是文件的后缀名,右边是用来处理这一类文件的模块名。上面代码表示,运行测试之前,先用babel-core/register模块,处理一下.js文件。由于这里的转码器安装在项目内,所以要使用项目内安装的Mocha;如果转码器安装在全局,就可以使用全局的Mocha。
下面是另外一个例子,使用Mocha测试CoffeeScript脚本。测试之前,先将.coffee文件转成.js文件。

$ mocha --compilers coffee:coffee-script/register
注意,Babel默认不会对Iterator、Generator、Promise、Map、Set等全局对象,以及一些全局对象的方法(比如Object.assign)转码。如果你想要对这些对象转码,就要安装babel-polyfill。

$ npm install babel-polyfill --save
然后,在你的脚本头部加上一行。

import 'babel-polyfill'
九、异步测试
Mocha默认每个测试用例最多执行2000毫秒,如果到时没有得到结果,就报错。对于涉及异步操作的测试用例,这个时间往往是不够的,需要用-t或--timeout参数指定超时门槛。
进入demo05子目录,打开测试脚本timeout.test.js。

it('测试应该5000毫秒后结束', function(done) {
var x = true;
var f = function() {
x = false;
expect(x).to.be.not.ok;
done(); // 通知Mocha测试结束
};
setTimeout(f, 4000);
});
上面的测试用例,需要4000毫秒之后,才有运行结果。所以,需要用-t或--timeout参数,改变默认的超时设置。

$ mocha -t 5000 timeout.test.js
上面命令将测试的超时时限指定为5000毫秒。
另外,上面的测试用例里面,有一个done函数。it块执行的时候,传入一个done参数,当测试结束的时候,必须显式调用这个函数,告诉Mocha测试结束了。否则,Mocha就无法知道,测试是否结束,会一直等到超时报错。你可以把这行删除试试看。
Mocha默认会高亮显示超过75毫秒的测试用例,可以用-s或--slow调整这个参数。

$ mocha -t 5000 -s 1000 timeout.test.js
上面命令指定高亮显示耗时超过1000毫秒的测试用例。
下面是另外一个异步测试的例子async.test.js。

it('异步请求应该返回一个对象', function(done){
request
.get('https://api.github.com')
.end(function(err, res){
expect(res).to.be.an('object');
done();
});
});
运行下面命令,可以看到这个测试会通过。

$ mocha -t 10000 async.test.js
另外,Mocha内置对Promise的支持,允许直接返回Promise,等到它的状态改变,再执行断言,而不用显式调用done方法。请看promise.test.js。

it('异步请求应该返回一个对象', function() {
return fetch('https://api.github.com')
.then(function(res) {
return res.json();
}).then(function(json) {
expect(json).to.be.an('object');
});
});
十、测试用例的钩子
Mocha在describe块之中,提供测试用例的四个钩子:before()、after()、beforeEach()和afterEach()。它们会在指定时间执行。

describe('hooks', function() {

before(function() {
// 在本区块的所有测试用例之前执行
});

after(function() {
// 在本区块的所有测试用例之后执行
});

beforeEach(function() {
// 在本区块的每个测试用例之前执行
});

afterEach(function() {
// 在本区块的每个测试用例之后执行
});

// test cases
});
进入demo06子目录,可以看到下面两个例子。首先是beforeEach的例子beforeEach.test.js。

// beforeEach.test.js
describe('beforeEach示例', function() {
var foo = false;

beforeEach(function() {
foo = true;
});

it('修改全局变量应该成功', function() {
expect(foo).to.be.equal(true);
});
});
上面代码中,beforeEach会在it之前执行,所以会修改全局变量。
另一个例子beforeEach-async.test.js则是演示,如何在beforeEach之中使用异步操作。

// beforeEach-async.test.js
describe('异步 beforeEach 示例', function() {
var foo = false;

beforeEach(function(done) {
setTimeout(function() {
foo = true;
done();
}, 50);
});

it('全局变量异步修改应该成功', function() {
expect(foo).to.be.equal(true);
});
});
十一、测试用例管理
大型项目有很多测试用例。有时,我们希望只运行其中的几个,这时可以用only方法。describe块和it块都允许调用only方法,表示只运行某个测试套件或测试用例。
进入demo07子目录,测试脚本test/add.test.js就使用了only。

it.only('1 加 1 应该等于 2', function() {
expect(add(1, 1)).to.be.equal(2);
});

it('任何数加0应该等于自身', function() {
expect(add(1, 0)).to.be.equal(1);
});
上面代码中,只有带有only方法的测试用例会运行。

$ mocha test/add.test.js

加法函数的测试
✓ 1 加 1 应该等于 2

1 passing (10ms)
此外,还有skip方法,表示跳过指定的测试套件或测试用例。

it.skip('任何数加0应该等于自身', function() {
expect(add(1, 0)).to.be.equal(1);
});
上面代码的这个测试用例不会执行。
http://www.ruanyifeng.com/blog/2015/12/a-mocha-tutorial-of-examples.html

npm install --save-dev chai

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350

推荐阅读更多精彩内容