第十一章:mocha单元测试+should断言库+istanbul覆盖率测试+art-template

nodemon 来进行自动重启 app 应用

$ npm i -g nodemon

# 使用:
nodemon app.js

art-template 模板使用

官网: https://aui.github.io/art-template/zh-cn/index.html

第一步: 引入 art-template 的包

npm install --save art-template
npm install --save express-art-template

第二步:项目中设置 express 的应用 art-template 模板引擎

const art_express = require('express-art-template');

const app = express(); // 创建app对象。

// 设置art的模板引擎
app.engine('art', art_express);

app.get('/user/list', (req, res) => {
  res.render('users/userlist2.art', {
    title: '你好啊!',
    users: userService.getUsers()
  });
});

语法

  • 输出标准语法
{{value}}
{{data.key}}
{{data['key']}}
{{a ? b : c}}
{{a || b}}
{{a + b}}

  • 原始语法
<%= value %>
<%= data.key %>
<%= data['key'] %>
<%= a ? b : c %>
<%= a || b %>
<%= a + b %>

模板一级特殊变量可以使用 $data 加下标的方式访问:

{{$data['user list']}}

  • 原文输出标准语法

{{@ value }}
原始语法

<%- value %>

原文输出语句不会对 HTML 内容进行转义处理,可能存在安全风险,请谨慎使用。

  • 条件标准语法
{{if value}} ... {{/if}}
{{if v1}} ... {{else if v2}} ... {{/if}}

原始语法

<% if (value) { %> ... <% } %>
<% if (v1) { %> ... <% } else if (v2) { %> ... <% } %>

  • 循环标准语法
{{each target}}
{{$index}} {{$value}}
{{/each}}

原始语法

<% for(var i = 0; i < target.length; i++){ %>
<%= i %> <%= target[i] %>
<% } %>

target 支持 arrayobject 的迭代,其默认值为 [图片上传失败...(image-bb0fe0-1565081641606)]

value$index可以自定义:{{each target val key}}`。变量标准语法

{{set temp = data.sub.content}}
原始语法

<% var temp = data.sub.content; %>

  • 模板继承标准语法
{{extend './layout.art'}}
{{block 'head'}} ... {{/block}}

原始语法

<% extend('./layout.art') %>
<% block('head', function(){ %> ... <% }) %>

模板继承允许你构建一个包含你站点共同元素的基本模板“骨架”。范例:

<!--layout.art-->
<!doctype html>
<html>
<head>
    <meta charset="utf-8">
    <title>{{block 'title'}}My Site{{/block}}</title>

    {{block 'head'}}
    <link rel="stylesheet" href="main.css">
    {{/block}}

</head>
<body>
    {{block 'content'}}{{/block}}
</body>
</html>
<!--index.art-->
{{extend './layout.art'}}

{{block 'title'}}{{title}}{{/block}}

{{block 'head'}}

<link rel="stylesheet" href="custom.css">
{{/block}}

{{block 'content'}}

<p>This is just an awesome page.</p>
{{/block}}

渲染 index.art 后,将自动应用布局骨架。

  • 子模板标准语法
{{include './header.art'}}
{{include './header.art' data}}

原始语法

<% include('./header.art') %>
<% include('./header.art', data) %>

data 数默认值为 $data;标准语法不支持声明 objectarray,只支持引用变量,而原始语法不受限制。
art-template 内建 HTML 压缩器,请避免书写 HTML 非正常闭合的子模板,否则开启压缩后标签可能会被意外“优化。过滤器注册过滤器

template.defaults.imports.dateFormat = function(date, format){/_[code..]_/};
template.defaults.imports.timestamp = function(value){return value \* 1000};

  • 过滤器函数第一个参数接受目标值。

标准语法

{{date | timestamp | dateFormat 'yyyy-MM-dd hh:mm:ss'}}
{{value | filter}} 过滤器语法类似管道操作符,它的上一个输出作为下一个输入。

原始语法

<%= $imports.dateFormat($imports.timestamp(date), 'yyyy-MM-dd hh:mm:ss') %>

使用 mock.js 模拟数据

官网地址: http://mockjs.com/

安装:
npm install mockjs

// 使用 Mock
var Mock = require('mockjs');
let data = Mock.mock({
  "users|33": [{
    "id|+1": 20000,
    "name": "@cname",
    "email": "@email",
    "phone": "@natural(132000000,133000000)",
    "address": "@county(true)",
    "zip": "@zip",
    "birthday": "@date('yyyy-MM-dd')"
  }]
});
// 输出结果
console.log(JSON.stringify(data, null, 4));

mocha 帮助我们进行单元测试

安装

$ npm install --global mocha

创建测试文件夹 test 目录,然后添加测试脚本文件

// 引用node的默认的断言库
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(4));
    });
  });
});

执行测试:

$ mocha

BDD 的 api

行为驱动开发(英语:Behavior-driven development,缩写 BDD)是一种敏捷软件开发的技术,它鼓励软件项目中的开发者、QA 和非技术人员或商业参与者之间的协作。BDD(行为驱动开发 )是第二代的、由外及内的、基于拉(pull)的、多方利益相关者的(stakeholder)、多种可扩展的、高自动化的敏捷方法。它描述了一个交互循环,可以具有带有良好定义的输出(即工作中交付的结果):已测试过的软件。

mocha 默认的测试接口是 bdd 的方式。

  • describe():描述场景,在里面可以设定 Context,可包括多个测试用例,也可以嵌套场景
  • it():位于场景内,描述测试用例
  • before():所有测试用例的统一前置动作
  • after():所有测试用例的统一后置动作
  • beforeEach():每个测试用例的前置动作
  • afterEach():每个测试用例的后置动作
describe('Array', function() {
  before(function() {
    // ...
  });

  describe('#indexOf()', function() {
    it('should return -1 when not present', function() {
      [1, 2, 3].indexOf(4).should.equal(-1);
    });
  });

  after(function() {
    // ...
  });
});

TDD 的 api

TDD,全称 Test-driven Development,中文测试驱动开发,主要方法:先写测试用例(test case),测试用例写好后,再来实现需要实现的方法或功能。

以下是 TDD 的接口列表

  • suite:定义一组测试用例。

  • suiteSetup:此方法会在这个 suite 所有测试用例执行前执行一次,只一次,这是跟 setup 的区别。

  • setup:此方法会在每个测试用例执行前都执行一遍。

  • test:具体执行的测试用例实现代码。

  • teardown:此方法会在每个测试用例执行后都执行一遍,与 setup 相反。

  • suiteTeardown:此方法会在这个 suite 所有测试用例执行后执行一次,与 suiteSetup 相反。

这些接口都是与 TDD 概念中的接口对应与相关实现,方便组织测试用例。BDD 的接口在这里不予赘述,可参考官方文档。

var assert = require('assert');
var mocha = require('mocha');

var suite = mocha.suite;
var setup = mocha.setup;
var suiteSetup = mocha.suiteSetup;
var test = mocha.test;
var teardown = mocha.teardown;
var suiteTeardown = mocha.suiteTeardown;

//test case
suite('Array', function() {
  suiteSetup(function() {
    //suiteSetup will run only 1 time in suite Array, before all suite
    //...
    console.log('suitSetup...');
  });

  setup(function() {
    //setup will run 1 time before every suite runs in suite Array
    //...
    console.log('setup...');
  });

  suite('indexOf()', function() {
    test('should return -1 when not present', function() {
      assert.equal(-1, [1, 2, 3].indexOf(4));
    });
  });

  suite('indexOf2()', function() {
    test('should return not -1 when present', function() {
      assert.equal(0, [1, 2, 3].indexOf(1));
    });
  });

  teardown(function() {
    //teardown will run 1 time after every suite runs in suite Array
    //...
    console.log('teardown...');
  });

  suiteTeardown(function() {
    //suiteTeardown will run 1 time in suite Array, after all suits run over.
    //...
    console.log('suiteTeardown...');
  });
});

should.js 断言库的用法

安装

$ npm install should -P

构建断言对象

should 提供了一个全局方法,构造一个断言对象。

const should = require('should');
var obj = { a: 123 };
should(obj).eqls({ a: 123 });
should(obj).be.a.Object();

另外 should 劫持了 Object 的原型对象,所以所有的对象都拥有了 should 方法。should.js 源码如下:

/**
 * Expose api via `Object#should`.
 *
 * @api public
 */
Object.defineProperty(Object.prototype, 'should', {
  set: function() {},
  get: function() {
    return should(this);
  },
  configurable: true
});

所以代码中可以直接用 should 方法构建断言对象。

const a = { b: 123 };

a.should.be.a.Object();
a.b.should.above(3);

常用的 api

  • eql(别名:eqls) 相等,不严格相等。对象比较属性值,而非地址: should(3).eql(3)
  • notEqual : should(3).notEqual(45)
  • equal (同 Nodejs 的 assert.equal 方法): should(3).equal(3)
  • should.ok(value, [message])
  • true([message]): should(3>1).true()
  • containEql(other) [1, 2, 3].should.containEql(1);
  • above() :(10).should.be.above(0);
  • belowOrEqual(n, [description]): (0).should.be.belowOrEqual(10);
  • NaN: (10).should.not.be.NaN();
  • length: [1, 2].should.have.length(2);

其他

'abca'.should.endWith('a');
'abc'.should.startWith('a');
({ a: 10 }.should.have.value('a', 10));
({ a: 10 }.should.have.property('a'));
'ab'.should.be.equalOneOf('a', 10, 'ab');

链式调用

should 实现了可以直接链式编程的效果,这些方法内部都是返回断言对象自身,但是语义化却厉害了,其中可以直接应用链式编程的有:['an', 'of', 'a', 'and', 'be', 'has', 'have', 'with', 'is', 'which', 'the', 'it']

应用:

const should = require('should');
describe('#getUsers 测试获取用户所有数据', function() {
  it('service.getUsers() should be Array', function() {
    should(service.getUsers()).be.a.Array();
  });
  it('service.getPageUsers(2, 5) should return Array[]', function() {
    let data = service.getPageUsers(2, 5);
    // should(users).be.a.Object();
    (data.users.length <= 5).should.be.true();

    let returnUser = service.addUser(addUser);
    returnUser.should.containEql(addUser);

    returnMsg.should.be.eql({
      status: 1,
      msg: '删除成功'
    });
    service.getUserById(10008).should.be.containEql({
      status: 1,
      msg: 'ok'
    });
  });
});

istanbul 测试覆盖率(新版已经改名为nyc)

代码覆盖率code coverage)。它有四个测量维度。

  • 行覆盖率(line coverage):是否每一行都执行了?
  • 函数覆盖率(function coverage):是否每个函数都调用了?
  • 分支覆盖率(branch coverage):是否每个 if 代码块都执行了?
  • 语句覆盖率(statement coverage):是否每个语句都执行了?

nyc 是 JavaScript 程序的代码覆盖率工具

安装

# 全局安装命令行工具
$ npm i -g nyc
# 本地安装一下
$ npm i -D nyc

配合 mocha 测试覆盖率统计

$ nyc mocha

  Array
    #indexOf()
      √ should return -1 when the value is not present

  1 passing (8ms)

----------|----------|----------|----------|----------|-------------------|
File      |  % Stmts | % Branch |  % Funcs |  % Lines | Uncovered Line #s |
----------|----------|----------|----------|----------|-------------------|
All files |        0 |        0 |        0 |        0 |                   |
----------|----------|----------|----------|----------|-------------------|

登录mongodb

 sudo mongo

一些操作命令

show dbs //展示所有数据库
use db //使用该数据库,未创建则直接创建
db.documents.drop() //删除该collection中所有数据(或者使用.remove()通过条件删除)
db.documents.find() //查询该collection中所有数据
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,905评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,140评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,791评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,483评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,476评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,516评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,905评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,560评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,778评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,557评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,635评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,338评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,925评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,898评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,142评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,818评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,347评论 2 342

推荐阅读更多精彩内容