Mocha浏览器测试入门教程
摘要: 如何使用Mocha在浏览器中测试JavaScript代码?
本文所有代码都在Fundebug/mocha-browser-test仓库中。
在玩转Node.js单元测试博客中,我介绍了测试框架Mocha,对后端Node.js代码进行测试。在这篇博客,我将介绍如何使用Mocha在浏览器中测试JavaScript代码。
mocha init:初始化测试代码
安装mocha(在国内使用cnpm比npm更快):
sudo cnpm install -g mocha
执行mocha init命令,可以自动生成浏览器端的测试文件:
mocha init test
mocha会自动创建一个test目录,其中有4个文件,分别是:
- mocha.js:Mocha源码
- mocha.css:Mocha源码
- tests.js:测试代码
- index.html:浏览器测试入口页面
mocha.js与mocha.css是Mocha模块自身的源代码,因为需要在浏览器中展示测试结果,因此需要Mocha的CSS文件;tests.js为测试代码,为空文件,需要我们编写;index.html为运行测试的入门页面,使用浏览器大概它就会运行测试,并且展示测试结果。
index.html是理解Mocha浏览器测试的关键:
<!DOCTYPE html> <html> <head> <title>Mocha</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <link rel="stylesheet" href="mocha.css" /> </head> <body> <div id="mocha"></div> <script src="mocha.js"></script> <script>mocha.setup('bdd');</script> <script src="tests.js"></script> <script> mocha.run(); </script> </body> </html>
可知:
- index.html中导入了mocha.js, mocha.css和tests.js文件;
- id为mocha的div是空的,测试结果的元素会插入到这个div;
- mocha.setup('bdd')指定使用Mocha的BDD接口,mocha.run()表示运行测试,测试代码tests.js必须放在两者之间,否则不会运行测试;
运行测试案例
add.js
使用mocha init生成的测试代码中没有实际的测试案例,不妨添加一个简单的add.js:
function add(a, b) { return a + b; }
可知,add是一个非常简单的加法函数。
tests.js
在tests.js添加针对add函数的测试代码:
var should = chai.should(); describe("测试add函数", function() { it("1加1等于2", function() { var sum = add(1, 2); should.equal(sum, 3); }); it("1加2等于3", function() { var sum = add(1, 2); should.equal(sum, 3); }); });
在测试代码中,我使用了断言库Chai。
index.html
在index.html中,需要添加源代码add.js以及断言库chai.js:
<!DOCTYPE html> <html> <head> <title>Mocha</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <meta name="viewport" content="width=device-width, initial-scale=1.0"> <link rel="stylesheet" href="mocha.css" /> </head> <body> <div id="mocha"></div> <script src="mocha.js"></script> <script>mocha.setup('bdd');</script> <script src="https://cdn.staticfile.org/chai/4.0.0-canary.1/chai.js"></script> <script src="../add.js"></script> <script src="tests.js"></script> <script> mocha.run(); </script> </body> </html>
运行测试
使用浏览器打开index.html,就会运行测试,并且看到运行结果:
可知,测试通过:)
mocha-phantomjs:使用命令行测试
对于习惯在终端敲命令行的程序员来说,用浏览器打开index.html去进行测试显得非常不合时宜。
还好,有所谓的headless的浏览器PhantomJS,它没有图形界面,却可以运行前端代码,方便用来测试。
mocha-phantomjs命令
安装phantomjs和mocha-phantomjs(phantomjs模块更名为phantomjs-prebuilt):
sudo cnpm install -g phantomjs-prebuilt mocha-phantomjs
将Mocha和PhontomJS结合起来的是mocha-phantomjs,在终端执行mocha-phantomjs命令,它会在PhantomJS中执行Mocha测试代码,并将结果展示在终端,非常方便:
mocha-phantomjs --path /usr/local/bin/phantomjs ./test/index.html 测试add函数 ✓ 1加1等于2 ✓ 1加2等于3 2 passing (7ms)
--path选项指定了phantomjs的安装路径。这个必须指定,否则会报错"phantomjs terminated with signal SIGSEGV"。
另外,测试代码tests.js中必须有describe语句,否则使用mocha-phantomjs执行时会报错"mocha.run() was called with no tests"。
npm test命令
mocha-phantomjs的测试命令比较长,可以在package.json中配置npm的test脚本:
"scripts": { "test": "mocha-phantomjs --path /usr/local/bin/phantomjs ./test/index.html" },
这样,执行npm test命令就可以运行测试。