代码 8.1.1 add函数
    小明之前没有接触过单元测试,于是乎他写出的测试用例是这样的:

    1. if (s == 3) {
    2. console.log('恭喜你,加法测试成功了');
    3. } else {
    4. console.error('哎呦,加法测试出错了啊');
    5. }

    代码 8.1.2 不使用测试框架的测试用例
    接着他又写了减法函数、乘法函数、除法函数,但是随着模块的增加,他逐渐的意识到一个问题,如果按照代码8.1.2的模式的话,一则输出格式比较乱,而且测试结果没有最终统计信息,不能一下子得出成功数和失败数。于是乎他去网上找资料,然后他就发现了大名鼎鼎的 mocha
    研究了一番,小明发现 mocha 提供了测试结果输出格式化和测试结果统计的功能,也就是说对于上面那个加法测试用例,就可以这么写了:

    1. var assert = require('assert');
    2. describe('Calculator', function() {
    3. describe('#add()', function() {
    4. it('should get 3 when 1 add 2', function() {
    5. assert.equal(3, add(1,2));
    6. });
    7. });
    8. });

    代码 8.1.3 使用mocha改写测试用例
    官网上说, mocha 在使用的时候,可以使用全局安装的模式,也可以安装为当前项目的开发依赖包(即在安装的时候使用--save-dev参数),不过小明考虑到以后各个项目都要用得到,于是决定进行全局安装(npm install mocha -g)。
    安装完之后,小明兴奋的新建了文件calculator_test.js:

    1. var assert = require('assert');
    2. var calculator = require('./calculator');
    3. describe('Calculator', function() {
    4. describe('#add()', function() {
    5. it('should get 3 when 1 add 2', function() {
    6. assert.equal(3, calculator.add(1,2));
    7. });
    8. });
    9. });

    代码 8.1.4 文件calculator_test.js部分代码
    接着他运行node calculator_test.js,没想到结果打出他的意料,报错了:

    1. e:\kuaipan\code\node\myapp\chapter7\src\test\mocha>node calculator_test.js
    2. e:\kuaipan\code\node\myapp\chapter7\src\test\mocha\calculator_test.js:4
    3. describe('Calculator', function() {
    4. ^
    5. ReferenceError: describe is not defined
    6. at Object.<anonymous> (e:\kuaipan\code\node\myapp\chapter7\src\test\mocha\calculator_test.js:4:1)
    7. at Module._compile (module.js:456:26)
    8. at Object.Module._extensions..js (module.js:474:10)
    9. at Module.load (module.js:356:32)
    10. at Function.Module._load (module.js:312:12)
    11. at Function.Module.runMain (module.js:497:10)
    12. at startup (node.js:119:16)
    13. at node.js:929:3

    输出 8.1.1 命令node calculator_test.js的输出
    一定是小问题,小明心里嘀咕着,然后顺手打开了google,直接搜索ReferenceError: describe is not defined在第一页就发现了答案,原来要运行mocha calculator_test.js(还是谷歌靠谱)。运行完正确的命令后,果然看到想要的结果了:

    输出 8.1.2 命令mocha calculator_test.js的输出
    小明发现,这里之所以使用 node 自带的 assert 包,是由于 mocha 仅仅本身没有提供断言(Assertion)库,所以他又尝试了几种常用的断言库。
    1.should.js
    他使用的格式是 (something).should 或者 should(something),更多使用方法还得参阅其 ,例如上面我们使用 assert 进行判断的代码就可以写成:

    1. var should = require('should');

    代码 8.1.5 should判断1
    或者:

    1. should(calculator.add(1,2)).be.exactly(3).and.be.a.Number();

    代码 8.1.6 should判断2

    2.expect.js
    首先给出expect.js的github地址 ,下面是用expect重写的测试用例:

    1. var expect = require('expect.js');
    2. expect(calculator.add(1,2)).to.be(3);

    代码 8.1.7 expect判断
    3.chai
    将前面提到的assert should expect融合到了一起,你仅仅需要使用 chai 这一个包就能享用以上三者的功能,所以前面讲到的三种判断在chai中是这么实现的:

    1. var chai = require('chai');
    2. var assert = chai.assert;//use assert
    3. assert.equal(3, calculator.add(1,2));
    4. chai.should();//use should
    5. (calculator.add(1,2)).should.be.equal(3).and.be.a('number');
    6. var expect = chai.expect;//use expect
    7. expect(calculator.add(1,2)).to.equal(3);

    代码 8.1.8 使用chai判断
    这个 chai 还真是个大杀器呢。不过注意,在 chai 中

    只能作为属性使用,不能作为函数使用(除非你自己写代码把这些属性覆盖掉),所以to.be(3)要写作to.equal(3),另外 chai 中也没有exactly 这个函数,所以这里也是用equal来替代,同时在 chai 中a只能作为函数使用,其函数声明为a(type),所以这里用了a('number'),其他技术细节,请移步官方API BDD部分

    4.supertest
    小明将计算器的任务完成了,测试用例写的也很完备,经理对其进行了表扬。不过他同时分配了下一期的任务,公司要提供一个计算器云的业务,要将小明之前做的功能以接口的形式提供给用户调用,不过这个项目同样要给出测试用例。
    HTTP请求和本地调用从流程是有很多不一样的地方的:调用的过程中服务器可能会出现异常,返回数据有可能格式不正确,传递参数有可能出现偏差;而本地代码测试只要关心调用得到的结果是否正常就够了。不过,还好,小明找到了 这个mocha 断言工具。

    这里先给出小明写的一个HTTP接口:

    1. exports.doAdd = function(req, res) {
    2. var _body = req.body;
    3. var a = parseInt(_body.a, 10);
    4. if (isNaN(a)) {
    5. return res.send({code:1,msg:'a值非法'});
    6. }
    7. var b = parseInt(_body.b, 10);
    8. if (isNaN(b)) {
    9. return res.send({code:2,msg:'b值非法'});
    10. }
    11. res.send({code:0,data:a+b});
    12. };

    代码 8.1.9 加法运算的HTTP接口

    对应的supertest的测试用例代码就是这样的:

    1. var request = require('supertest');
    2. var app = require('../../app');
    3. describe('POST /calculator/add', function() {
    4. it('respond with json', function(done) {
    5. request(app)
    6. .post('/calculator/add')
    7. .send({a: 1,b:2})
    8. .expect(200, {
    9. code:0,data:3
    10. },done);
    11. });
    12. });

    完成了这个所谓的计算器云的项目后,小明又接到了新的任务,要做一个开发者平台,这个平台允许开发者创建基于计算云的开发者帐号和应用,然后登录进去管理自己的应用。
    为了简化我们的教程,我们姑且认为这个平台使用的登录请求是我们之前用过的请求,管理后台首页是/user/admin。我们现在来测试登录到后台这个动作。

    登录过程要牵扯到我们在第6章讲过的session的知识,但是session在前端要有sessionid写入cookie中,我们的测试运行环境是命令行,不是浏览器,这就需要我们自己来维护cookie的读写操作。同时我们还需要用到 mocha 中的钩子(Hook)函数。由于我们的后台在进入之前需要先登录,所以我们要用到 mocha 中的 before 函数,它表示在所有测试用例之前执行,当然还有 beforeEach 函数,它表示在每次测试用例执行前都执行一次。显然两者的区别是前者只在所有测试用例前执行一次,而后者要在每个测试用例执行前都要重新执行。先看这个钩子函数:

    1. var request = require('supertest');
    2. var cookie = exports.cookie = '';
    3. before(function(done) {
    4. request(app)
    5. .post('/user/login')
    6. .send({username:'admin', password:'admin'})
    7. .expect(200,{code:0})
    8. .end(function(err,res) {
    9. if (err) {
    10. return done(err);
    11. }
    12. var header = res.header;
    13. var setCookieArray = header['set-cookie'];
    14. for (var i=0,len=setCookieArray.length;i<len;i++) {
    15. var value = setCookieArray[i];
    16. var result = value.match(/^express_chapter7=([a-zA-Z0-9%\.\-_]+);\s/);
    17. if (result && result.length > 1) {
    18. exports.cookie = cookie = result[1];
    19. break;
    20. }
    21. }
    22. if (!cookie) {
    23. return done(new Error('查找cookie失败'));
    24. }
    25. done();
    26. });
    27. });

    代码 8.1.11 钩子函数
    这里我们使用全局变量cookie来存储我们提到的 sessionid ,在 supertest 的 end 函数中,我们读取响应体变量res中的 set-cookie 头信息,通过正则把 sessionid 读取出来。注意我们这里将 cookie 这个变量还专门做导出了,这样子我们就可以在其他测试文件中引用这个变量了。
    接着就可以使用这个读取到的cookie来进入后台了:

    1. var request = require('supertest');
    2. var app = require('../../app');
    3. var before = require('./login_before');
    4. describe('Backend',function() {
    5. it('first test',function(done) {
    6. request(app)
    7. .get('/user/admin')
    8. .set('Cookie','express_chapter7=' + before.cookie)
    9. .expect(200,/<title>admin<\/title>/,done);
    10. });
    11. });

    代码 8.1.12 请求中使用cookie
    我们在模板 user/admin.ejs 有这么一句:<title><%=user.account%></title>,所以我们这里在测试时使用正则 /<title>admin<\/title>/ 来验证是否真的进入后台了。 还有就是在读取 变量的时候没有直接在 require 完成之后立即读取,因为那个时候,这个变量还没有被赋值,而是在测试用例内部通过 before.cookie 读取。

    经过一番实践,小明的熟练掌握了各种测试技能,不过某天经理找打了他,“小明啊,要不你转到测试组吧”,……