今天给大家一起来学习下 mocha 的一些特性吧 Mocha 一个最简单的例子是这样的。它使用 describe 来描述测试场景,使用 it 来表示测试用例, 断言可以使用内置,也可以使用一些第三方的断言库。
// test/mocha.spec.js const assert = require('assert');
// the function to be tested function pow(a, b) {return a ** b};
// tests describe("pow", () => { it('pow of 2 and 3', () => { let actual = pow(2, 3); assert.equal(actual, 8); })
it('pow of string and 3', () => { let actual = pow("a", 3); assert.equal(actual, 8); }) })
实际上,mocha 官方不推荐用箭头函数(匿名函数)来表示测试过程,而是使用普通的 function 函数表达式,因为箭头函数不能通过 this 访问 mocha 的上下文。
使用箭头函数在不用 this 获取 mocha 上下文时不会有问题,但是一旦需要 this 访问上下文,箭头函数会报错。 // 错误写法 const assert = require('assert');
describe('my suite', () => { it('my test', () => { // should set the timeout of this test to 1000 ms; // instead will fail this.timeout(1000) assert.ok(true); }); 此时必须使用 function 函数表达式: // 正确写法 const assert = require('assert');
describe('my suite', function() { it('my test', function() { this.timeout(1000) assert.ok(true); }); });
1. hook Mocha 提供了 before、after、beforeEach、afterEach 执行前置条件和后置清理工作。 1.before 在这个描述的开始执行一次 2.after 在这个描述的结束执行一次 3.beforeEach 在每个用例之前都执行一次 4.afterEach 在每个用例之后都执行一次 const assert = require('assert');
describe('hooks', function() { before(function() { // runs once before the first test in this block console.log("before") });
after(function() { // runs once after the last test in this block console.log("after") });
beforeEach(function() { // runs before each test in this block console.log("before each") });
afterEach(function() { // runs after each test in this block console.log("after each") });
// test cases it('pow of 2 and 3', () => { assert(true) });
it('pow of string and 3', () => { assert(true) });
}); Hook 也可以加说明,解释需要做什么事情: beforeEach('some description', function() { // beforeEach:some description });
- 运行指定用例 在 it 用例后添加 only 函数就可以指定用例,标记了 only 的用例会运行,没有标记的不会运行。 describe('#indexOf()', function() { it.only('should return -1 unless present', function() { // this test will be run });
it.only('should return the index when present', function() { // this test will also be run });
it('should return -1 if called with a non-Array context', function() { // this test will not be run }); }); 不仅可以在 it 用例上使用 only,而且可以在嵌套的 describe 中使用: describe('Array', function() { describe.only('#indexOf()', function() { it('should return -1 unless present', function() { // this test will be run });
it('should return the index when present', function() { // this test will also be run }); });
describe.only('#concat()', function() { it('should return a new Array', function() { // this test will also be run }); });
describe('#slice()', function() { it('should return a new Array', function() { // this test will not be run }); }); }); 3. 跳过用例 在 mocha 中,可以通过 only 指定需要执行的用例,也可以通过 skip 跳过用例,用法和 only 基本一致,你可以通过 it.skip 跳过一个用例,也可以通过 describe.skip 跳过整个描述。
除此之外,你还可以根据环境变量的值判断,当满足条件时,再跳过用例。
it('should only test in the correct environment', function() { if (Cypress.env('host') === 'local') { // make assertions } else { this.skip(); } });
你甚至可以在 describe 或者 before 函数中,跳过整个块中的所有用例: before(function() { if (Cypress.env('host') === 'local') { // setup code } else { this.skip(); } });
- 重复执行 在一些脆弱的测试中,一次执行可能并不能成功执行用例。在 Web 测试过程中,因为网络环境和其他因素影响,会造成用例执行不稳定,此时你需要对失败用例重复执行。在 mocha 当中,你可以通过 this.retries 在 describe 和 it 中设置失败执行次数,你也可以在 before 函数中设置,但是在 beforeEach 是不可以的。 describe('retries', function() { // Retry all tests in this suite up to 4 times this.retries(4);
beforeEach(function() { browser.get('www.yahoo.com'); });
it('should succeed on the 3rd try', function() { // Specify this test to only retry up to 2 times this.retries(2); expect($('.foo').isDisplayed()).to.eventually.be.true; }); });
- 动态生成用例 你已经有了 3 组测试数据,这 3 组数据的测试步骤都是一样的,那就没有必要重复去编写 3 个测试函数,没错,用数据驱动,根据 3 组数据动态生成 3 个用例。 const assert = require('chai').assert;
function add(args) { return args.reduce((prev, curr) => prev + curr, 0); }
describe('add()', function() { const tests = [ {args: [1, 2], expected: 3}, {args: [1, 2, 3], expected: 6}, {args: [1, 2, 3, 4], expected: 10} ];
tests.forEach(({args, expected}) => {
it(correctly adds ${args.length} args, function() {
const res = add(args);
assert.equal(res, expected);
});
});
});
总结 在使用 mocha 时,有一些特性会经常使用,尤其是在具体的实战项目中: 1.尽量使用普通的函数声明,避免使用箭头函数,因为箭头函数无法通过 this 获取 mocha 上下文。 2.可以通过 hook 函数设置前置条件和后置清理工作。 3.通过 only 指定用例运行。 4.通过 skip 跳过用例运行。 5.通过 retries 设置重复运行次数。 6.使用数据驱动测试思想动态生成用例。