这篇是前段时间总结给自己备忘的,要用到的工具实在太多,没法一一记住。
个人感觉,作为一个测试的工具,只要会用就好了。
所以这里稍微做了一些修改,简单介绍一下常用的写法和命令,其次将之前的一些示例改成 javascript 版本,方便没有 coffee 基础的同学浏览。
介绍
mocha 是一个拥有丰富功能的 javascript 测试框架,可以用于 nodejs 和浏览器。支持同步/异步测试用例,有多种报告形式。
官网介绍了很多的特性,个人感觉实用的就几点:
一个是 nodejs 和浏览器都可以用,不用再记那么多奇怪的 api 和写法了。
其次是编写同步/异步测试用例非常简单。
安装
1 2 |
$ npm install mocha -g |
成功安装后就可以使用 mocha
命令了。
使用
运行./test/
目录所有 js
1 2 |
$ mocha |
指定 js 文件
1 2 |
$ mocha xxx.js |
监听文件变化
1 2 |
$ mocha xxx.js -w |
指定 coffee 编译
for coffescript 1.6
1 2 |
$ mocha --compilers coffee:coffee-script test.coffee |
for coffeescript 1.7+
1 2 |
$ mocha --compilers coffee:coffee-script/register test.coffee |
浏览器的使用
1 2 |
$ mocha init <path> |
指定一个目录,初始化一个用于浏览器的测试目录。执行后会在该目录生成 index.html
、mocha.js
、mocha.css
和一个空白的 test.js
,可以直接在 test.js
中添加测试用例。
当然,也可以不敲命令直接复制引用 mocha.js
到 html。
编写用例
常用的断言库都可以运行的很好。以下列出几个:
should.js
BDD style shown throughout these docs.chai
expect() assert() and should style assertionsexpect.js
expect() style assertionsbetter-assert
c-style self.documenting assert()
个人一般用 nodejs 自带的 assert
(方便不用安装)和 should.js
(功能强大很好用)
同步代码
1 2 3 4 5 6 7 8 9 10 |
<span class="keyword">require</span>(<span class="string">'should'</span>); describe(<span class="string">'测试数组Array'</span>,<span class="keyword">function</span>(){ describe(<span class="string">'测试#indexOf方法'</span>,<span class="keyword">function</span>(){ it(<span class="string">'不存在的元素会返回-1'</span>,<span class="keyword">function</span>(){ [<span class="number">1</span>,<span class="number">2</span>,<span class="number">3</span>].indexOf(<span class="number">5</span>).should.equal(-<span class="number">1</span>); [<span class="number">1</span>,<span class="number">2</span>,<span class="number">3</span>].indexOf(<span class="number">0</span>).should.equal(-<span class="number">1</span>); }); }); }); |
异步代码
写法和同步代码类似,只是在 it()
的第二个参数的函数参数中传入一个 done
函数,用于控制异步函数的结束。
1 2 3 4 5 6 7 8 9 10 11 12 |
describe(<span class="string">'测试User模块'</span>,<span class="keyword">function</span>(){ describe(<span class="string">'测试#save()方法'</span>,<span class="keyword">function</span>(){ it(<span class="string">'此处不应出错'</span>,<span class="keyword">function</span>(done){ <span class="keyword">var</span> user = <span class="keyword">new</span> User({name:<span class="string">'董小姐'</span>}); user.save(<span class="keyword">function</span>(err){ assert.ifError(err); done(); }); }); }); }); |
其中,done()
函数也可以接受一个 error 作为参数,所以上面其实可以简化为:
1 2 3 4 5 6 7 8 9 |
describe(<span class="string">'测试User模块'</span>,<span class="keyword">function</span>(){ describe(<span class="string">'测试#save()方法'</span>,<span class="keyword">function</span>(){ it(<span class="string">'此处不应出错'</span>,<span class="keyword">function</span>(done){ <span class="keyword">var</span> user = <span class="keyword">new</span> User({name:<span class="string">'董大爷'</span>}); user.save(done); }); }); }); |
hooks
mocha 支持多种体位的 hook,用法做一些或者干掉一些东东。如下:
before()
开始前 1 次after()
结束后做 1 次beforeEach()
开始前每次都做afterEach()
每次结束后都做
所有的 hooks 都可以接收 done()
参数用于异步结束。甚至可以不使用 done
参数,而是直接返回一个 promise
对象,例如:
1 2 3 4 5 6 |
beforeEach(<span class="keyword">function</span>(){ <span class="keyword">return</span> db.clear().then(<span class="keyword">function</span>() { <span class="keyword">return</span> db.save([tobi, loki, jane]); }); }); |
不过建议还是加上 done
参数,看起来清晰,习惯统一。
BDD 和 TDD
现在一般都用 BDD。
BDD interface 提供了 describe(),context(),it(),before(),after(),beforeEach(),afterEach()。
context() 和 describe() 没区别。
TDD interface 提供了 suite(),test(),suiteSetup(),suiteTeardown(),setup(),teardown()
其他常用
-b 参数 只显示第一个异常
一般测试用例多的时候非常有用,不然某个接口变化全屏报错就悲剧了
-t 参数 指定单个测试用例的超时时间
默认单个测试用例超时时间为 2000ms。
命令行中添加为全局的设置,也可以在测试用例内部调用 timeout()
方法单独控制。
ok,介绍到此就结束了,最后附上其他命令速查
其他命令行
- -h,—help
- -V,—version
- -A,—async-only 强制为异步模式,即所有测试必须包含一个 done() 回调。
- -c,—colors
- -C,—no-colors
- -G,—growl
- -O,—reporter-options
- -R,—reporter
- -S,—sort
- -b,—bail
- -d,—debug
- -g,—grep
- -f,—fgrep
- -gc,—expose-gc
- -i,—invert
- -r,—require
- -s,—slow
- -t,—timeout 设置超时,默认为 2000ms,如果是长时间运算需要设置。
- -u,—ui
- -w,—watch 监视文件变化
- —check-leaks
- —compilers :,… 使用指定模块编译文件,经常会用到编译 coffee
- —debug-brak
- —globals
- —inline-diffs
- —interfaces
- —no-deprecation
- —no-exit
- —no-timeouts
- —opts
- —prof
- —recursive
- —reporters
- —throw-deprecation
- —trace
- —trace-deprecation
- —watch-extensions ,…
- —delay