ava-practice

ava 是什么？

面向未来的测试运行器

https://github.com/avajs/ava

简单的说ava是mocha的替代品，

• es6语法支持更好，对aysnc/await有支持
• 执行效率更高，使用io并发，就必须保证测试的原子性
• 语义上更简单，集众家之长

虽然 JavaScript 是单线程，但在 Node.js 里由于其异步的特性使得 IO 可以并行。AVA 利用这个优点让你的测试可以并发执行，这对于 IO 繁重的测试特别有用。另外，测试文件可以在不同的进程里并行运行，让每一个测试文件可以获得更好的性能和独立的环境。在 Pageres 项目中从 Mocha切换 到 AVA 让测试时间从 31 秒下降到 11 秒。测试并发执行强制你写原子测试，意味着测试不需要依赖全局状态或者其他测试的状态，这是一件非常好的事情。

为什么要用 AVA?

• 轻量和高效
• 简单的测试语法
• 并发运行测试
• 强制编写原子测试
• 没有隐藏的全局变量
• 为每个测试文件隔离环境
• 用 ES2015 编写测试
• 支持 Promise
• 支持 Generator
• 支持 Async
• 支持 Observable
• 强化断言信息
• 可选的 TAP 输出显示
• 简明的堆栈跟踪

AVS VS Mocha

origin

断言

ava支持的断言都比较简单，总体来说是抄自tap和tape，除了plan方法外。

• .pass([message])

Passing assertion.

• .fail([message])

Failing assertion.

• .truthy(value, [message])

Assert that value is truthy.

• .falsy(value, [message])

Assert that value is falsy.

• .true(value, [message])

Assert that value is true.

• .false(value, [message])

Assert that value is false.

• .is(value, expected, [message])

Assert that value is equal to expected.

• .not(value, expected, [message])

Assert that value is not equal to expected.

• .deepEqual(value, expected, [message])

Assert that value is deep equal to expected.

• .notDeepEqual(value, expected, [message])

Assert that value is not deep equal to expected.

• .throws(function|promise, [error, [message]])

Assert that function throws an error, or promise rejects with an error.

error can be a constructor, regex, error message or validation function.

Returns the error thrown by function or the rejection reason of promise.

• .notThrows(function|promise, [message])

Assert that function doesn’t throw an error or promise resolves.

• .regex(contents, regex, [message])

Assert that contents matches regex.

• .ifError(error, [message])

Assert that error is falsy.

自定义断言

使用node.js sdk里默认的assert

import assert from 'assert';

test(t => {
    assert(true);
});

使用chai断言库，支持3种风格

import test from 'ava';

var assert = require('chai').assert;
var expect = require('chai').expect;
var should = require('chai').should();

test('expect with chai', t => {
  // typeof
  expect('test').to.be.a('string');
  expect({ foo: 'bar' }).to.be.an('object');
  expect(null).to.be.a('null');
  expect(undefined).to.be.an('undefined');
  expect(new Error).to.be.an('error');
  expect(new Float32Array()).to.be.a('float32array');
  expect(Symbol()).to.be.a('symbol');
});

test('should with chai', t => {
  var foo = 'bar'
  var tea = {
    flavors:[1,2,2]
  }
  foo.should.be.a('string');
  foo.should.equal('bar');
  foo.should.have.length(3);
  tea.should.have.property('flavors')
    .with.length(3);
});

test('assert with chai', t => {
  var foo = 'bar'
  var tea = {
    flavors:[1,2,2]
  }
  assert.typeOf(foo, 'string');
  assert.equal(foo, 'bar');
  assert.lengthOf(foo, 3)
  assert.property(tea, 'flavors');
  assert.lengthOf(tea.flavors, 3);
});

hook

test方法默认是顺序执行，如果里面是顺序执行的，那么它是正常的。如果里面是异步方法呢？结果是test执行完了，而异步方法还在跑，这样的结果是，这个测试怎么跑都是正确的，因为没有走断言。。。。

演示代码如下

test('#register()', t => {
  // 此方法是异步的，保存需要时间
  user.save((err, u) => {
    console.log(err)
    console.log('u=' + u)
    t.true(u.password.length > 50)
  })
});

当test完成，user.save还没完成，结果0断言，测试结果显示成功。。。这是非常典型的例子。

最简单的回调，注意写法，test.cb意味着这是需要调用t.end()才能结束，对于测试异步方法非常好用

test.cb('#register()', t => {
  // 此方法是异步的，保存需要时间
  user.save((err, u) => {
    console.log(err)
    console.log('u=' + u)
    t.true(u.password.length > 50)
    t.end()
  })
});

• t.end() 结束异步调用，仅仅在test.cb()方法里有效

下面例子中，保证在测试save方法之前，执行完成before。也就是说，执行before等待2秒，然后再开始跑其他测试。

test.before.cb((t) => {
  setTimeout(() => {
    t.end();
  }, 2000);
});

test('#save()', t => {
  let user = new User({
    username: 'i5ting',
    password: '0123456789'
  });
  
  user.save((err, u) => {
    if (err) log(err)
    t.is(u.username, 'i5ting');
  });
});

其他cb方法可依此类推

Control flow

• Promise
• Generator
• Async/await

Promise 支持

If you return a promise in the test you don’t need to explicitly end the test as it will end when the promise resolves.

test(t => {
    return somePromise().then(result => {
        t.is(result, 'unicorn');
    });
});

Generator 函数支持

AVA comes with built-in support for generator functions.

test(function * (t) {
    const value = yield generatorFn();
    t.true(value);
});

具体在mongoose里的generator里使用

test('#save()', function * (t) {
  var u = yield User.create(user)
  t.is(u.username, 'i5ting');
});

测试console.log或者其他终端输出内容，推荐使用co-exec，然后将结果正则匹配就好了

import test from 'ava';

var exec = require('co-exec');

test('exec()', function * (t) {
    var commit = yield exec('ls -alt|grep .gitignore|wc -l');
    console.log(commit)
    t.true(commit == 1);
});

test('exec2()', function * (t) {
  var result = yield exec('ls -alt')
  
  console.log(result.trim().match(/(gitignore)/))
  
  t.true(result.trim().match(/(gitignore)/).length > 1);
  t.regex(result, /(gitignore)/);
});

还有一个断言t.regex,不过不太容易判断

Async/await支持

AVA comes with built-in support for async functions (async/await).

test(async function (t) {
    const value = await promiseFn();
    t.true(value);
});

// async arrow function
test(async t => {
    const value = await promiseFn();
    t.true(value);
});

db

每次连接数据库成功后，最好是dropDatabase

var mongoose = require("mongoose");

// 核心代码，是否开启测试
mongoose.set('debug', false);

var db = mongoose.connect("mongodb://127.0.0.1:27017/db_helloworld"); 

db.connection.on("error", function (error) {  
  console.log("数据库连接失败：" + error); 
}); 

db.connection.on("open", function () {  
  console.log("数据库连接成功");
  mongoose.connection.db.dropDatabase();
});

测试覆盖率

https://github.com/bcoe/nyc

Just install both:

$ npm install --save-dev nyc ava

They you can add this to package.json:

"scripts": {
  "test": "nyc ava"
}

集成其他badge也很简单，看它的文档即可

使用ava的开源项目推荐

找这类的项目最好是从ava开始，找贡献的相关作者，从这些作者的项目里找，基本上是十有八九。

• pageres
• postcss
• cssnano
• postcss-discard-comments
• postcss-selector-parser

文档地址

• ava-practice带左侧目录网页版本
• ava-practice源码，以后文档会在github上持续更新

欢迎反馈，pr、star

全文完

欢迎关注我的公众号【node全栈】

联系我，更多交流