2018-05-11

Mocha浏览器测试入门教程

摘要： 如何使用Mocha在浏览器中测试JavaScript代码？

在玩转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命令就可以运行测试。

关于Fundebug

Fundebug专注于JavaScript、微信小程序、微信小游戏、支付宝小程序、React Native、Node.js和Java线上应用实时BUG监控。自从2016年双十一正式上线，Fundebug累计处理了30亿+错误事件，付费客户有阳光保险、达令家、核桃编程、荔枝FM、微脉等众多品牌企业。欢迎大家免费试用！

版权声明:
转载时请注明作者KiwenLau以及本文地址：
https://kiwenlau.com/2018/05/11/mocha-browser-tutorial/

您的用户遇到BUG了吗？

体验Demo 免费使用