精华 初识 mocha in NodeJS
发布于 4 年前 作者 lhfcws 52323 次浏览 最后一次编辑是 1 年前 来自 分享

囧,cnodejs不能上传图。有图版请见 无图无真相!

NodeJS里最常用的测试框架估计就是mocha了。它支持多种node的assert libs, 同时支持异步和同步的测试,同时支持多种方式导出结果,也支持直接在browser上跑Javascript代码测试。

本文示例大多源于官网示例,部分示例结合需要或自己的感想有所改动。更多介绍请看 官方网址:Mocha on Github

Installation:

当你成功安装nodejs v0.10 和 npm后执行下面这条命令。

# npm install -g mocha

p.s. Ubuntu的注意apt源里的nodejs版本会比较旧,某些module会不支持,请从nodejs官网进行源码安装。

First step to Mocha:

以下为最简单的一个mocha示例:

var assert = require("assert");
describe('Array', function(){
	describe('#indexOf()', function(){
  		it('should return -1 when the value is not present', function(){
        	assert.equal(-1, [1,2,3].indexOf(5));
		    assert.equal(-1, [1,2,3].indexOf(0));
		})
	})
});
  • describe (moduleName, testDetails) 由上述代码可看出,describe是可以嵌套的,比如上述代码嵌套的两个describe就可以理解成测试人员希望测试Array模块下的#indexOf() 子模块。module_name 是可以随便取的,关键是要让人读明白就好。
  • it (info, function) 具体的测试语句会放在it的回调函数里,一般来说info字符串会写期望的正确输出的简要一句话文字说明。当该it block内的test failed的时候控制台就会把详细信息打印出来。一般是从最外层的describe的module_name开始输出(可以理解成沿着路径或者递归链或者回调链),最后输出info,表示该期望的info内容没有被满足。一个it对应一个实际的test case
  • assert.equal (exp1, exp2) 断言判断exp1结果是否等于exp2, 这里采取的等于判断是== 而并非 === 。即 assert.equal(1, ‘1’) 认为是True。这只是nodejs里的assert.js的一种断言形式,下文会提到同样比较常用的should.js。

如果exp1和exp2均为字符串,字符串比较出错时则控制台会用颜色把相异的部分标出来。

Asynchronous

Frist step 中的代码显然是个 Synchronous 的代码,那么对于异步代码应该怎么做呢?很简单,在你最深处的回调函数中加done()表示结束。

fs = require('fs');
describe('File', function(){
	describe('#readFile()', function(){
    	it('should read test.ls without error', function(done){
	    	fs.readFile('test.ls', function(err){
				if (err) throw err;
				done();
			});
		})
	})
})
  • done ()<br> 按照瀑布流编程习惯,取名done是表示你回调的最深处,也就是结束写嵌套回调函数。但对于回调链来说done实际上意味着告诉mocha从此处开始测试,一层层回调回去。

上例代码是test pass的,我们尝试把test.ls改成不存在的test.as。便会返回具体的错误位置。

这里可能会有个疑问,假如我有两个异步函数(两条分叉的回调链),那我应该在哪里加done()呢?实际上这个时候就不应该在一个it里面存在两个要测试的函数,事实上一个it里面只能调用一次done,当你调用多次done的话mocha会抛出错误。所以应该类似这样:

fs = require('fs');
describe('File', function(){
	describe('#readFile()', function(){
    	it('should read test.ls without error', function(done){
	    	fs.readFile('test.ls', function(err){
				if (err) throw err;
				done();
			});
		})
    	it('should read test.js without error', function(done){
	    	fs.readFile('test.js', function(err){
				if (err) throw err;
				done();
			});
		})
	})
})

Pending

即省去测试细节只保留函数体。一般适用情况比如负责测试框架的写好框架让组员去实现细节,或者测试细节尚未完全正确实现先注释以免影响全局测试情况。这种时候mocha会默认该测试pass。 作用有点像Python的pass。

describe('Array', function(){
	describe('#indexOf()', function(){
  		it('should return -1 when the value is not present', function(){
		})
	})
});

Exclusive && Inclusive

其实很好理解,分别对应only和skip函数。

fs = require('fs');
describe('File', function(){
	describe('#readFile()', function(){
    	it.skip('should read test.ls without error', function(done){
	    	fs.readFile('test.ls', function(err){
				if (err) throw err;
				done();
			});
		})
    	it('should read test.js without error', function(done){
		})
	})
})

上面的代码只会有一个test complete, 只有only的会被执行,另一个会被忽略掉。每个函数里只能有一个only。如果是it.skip ,那么该case就会被忽略。

only和skip共用没有什么实际意义,因为only的作用会把skip屏蔽掉。

fs = require('fs');
describe('File', function(){
	describe('#readFile()', function(){
    	it.skip('should read test.ls without error', function(done){
	    	fs.readFile('test.as', function(err){
				if (err) throw err;
				done();
			});
		})
    	it('should read test.js without error', function(done){
		})
	})
})

上面的代码尽管test.as不存在,但是由于skip,依然会显示test complete。

Before && After

单元测试里经常会用到before和after。mocha同时还提供了beforeEach()和afterEach()。 这里为方便阅读用livescript表示,!->可理解成function(){}。细节无需细读,只需通过框架了解这几个函数如何使用便可。

require! assert
require! fs
can = it


describe 'Array', !->
	beforeEach !->
		console.log 'beforeEach Array'

	before !->
		console.log 'before Array'
	
	before !->
		console.log 'before Array second time'

	after !->
		console.log 'after Array'

	describe '#indexOf()', !->
		can 'should return -1 when the value is not present', !->
			assert.equal -1, [1,2,3].indexOf 0
		can 'should return 1 when the value is not present', !->

	describe 'File', !->

		beforeEach !->
			console.log 'beforeEach file test!'

		afterEach !->
			console.log 'afterEach File test!'

		describe '#readFile()', !->
			can 'should read test.ls without error', !(done)->
				fs.readFile 'test.ls', !(err)->
					if err
						throw err
					done!
			can 'should read test.js without error', !(done)->
				fs.readFile 'test.js', !(err)->
					if err
						throw err
					done!

由结果可知(after的使用与before同理),

  • beforeEach会对当前describe下的所有子case生效。
  • before和after的代码没有特殊顺序要求。
  • 同一个describe下可以有多个before,执行顺序与代码顺序相同。
  • 同一个describe下的执行顺序为before, beforeEach, afterEach, after
  • 当一个it有多个before的时候,执行顺序从最外围的describe的before开始,其余同理。

Test Driven Develop (TDD)

mocha默认的模式是Behavior Driven Develop (BDD),要想执行TDD的test的时候需要加上参数,如

mocha -u tdd test.js

前文所讲的describe, it, before, after等都属于BDD的范畴,对于TDD,我们用suite, test, setup, teardown。样例代码如下:

suite 'Array', !->
	setup !->
		console.log 'setup'

	teardown !->
		console.log 'teardown'

	suite '#indexOf()', !->
		test 'should return -1 when not present', !->
			assert.equal -1, [1,2,3].indexOf 4

<hr>

TDD的一些相关资料:

  1. What is TDD :

http://stackoverflow.com/questions/2327119/what-is-test-driven-development-does-it-require-to-have-initial-designs

  1. Difference between TDD && BDD :

http://stackoverflow.com/questions/4395469/tdd-and-bdd-differences

38 回复

好文,收藏~

学习下。支持

今天刚好准备学习nodejs测试,果断收藏

顶起, 还了解到livescript.

不错文章,社区支持图片就好了

让你爱上写测试的感觉哈哈

md不能直接上传图片,所以要等社区添加个上传图片的功能啦

md可以贴图… 大家都是搞技术的…找个传图片的地方不难吧… 真找不到就用这个 upload

原来还有这玩意。。是私有接口,还是大家都可以用的。可以宣传一下。。

写得很好。

不过Pending tests这个有点问题。不是像你所说的“省去测试细节只保留函数体”,而是不指定回调函数:

describe('Array', function(){
    describe('#indexOf()', function(){
        it('should return -1 when the value is not present');
    });
});

感谢指正。确实是的,应该是without callback。但CnodeJS好像日志时间久了就不给修改了?

求问,为什么我按上面的步骤安装完mocha后,复制第一个实例,运行后报错: describe is not defined??求问

我的node版本是v.10.5

你require了相应的模块吗?第一个demo可是官方demo啊~

问下楼主,it前后可以写before或者after吗?(也就是在describe里边)

发现单元测试真的很重要,找时间把这块做起来

我觉得这个论坛程序必须要采取些防挖坟措施了,老是看到几年前的帖子被顶上来。。。

目前支持 ecs6的特性嘛 最近新安装了一个co-mocha说是支持的,但是在实际应用中,却不支持,会报类似这样的错误:

import Fetcher from ‘…/lib/mail_fetcher/126’; ^^^^^^ SyntaxError: Unexpected token import

以前一直都是一知半解,看完此文犹如醍醐灌顶!!!!

@davidzhang import v8还没有实现,所以目前还用不了……

我是windows系统 npm install -g mocha 成功了 node app.test 提示 describe is not defined mocha app.test 提示 ‘mocha’ 不是内部或外部命令,也不是可运行的程序或批处理文件。 我的node版本 是 v0.12.7 这个怎么破 求帮忙

回到顶部