为 Mocha.js 编写自定义的 reporter

2019-07-23
标签: PUPPETEER

Mocha.js 有一些自带的 reporter,但是这些有时候不能完全满足自己的需求,有些信息冗余,有些信息缺失。其实我们可以自己编写reporter。

自定义reporter

如果你对 Mocha 文档里介绍的一些 自带的reporter 不满意,还可以发挥创造力,自己编写 reporter 的函数。使用下面的方式调用

mocha ---reporter reporter.js

或者用 mocharc 配置文件:

"reporter": "reporter.js"

官方例子

这篇官方 wiki 介绍了一个基本可用的例子:

var mocha = require('mocha');
module.exports = MyReporter;

function MyReporter(runner) {
  mocha.reporters.Base.call(this, runner);
  var passes = 0;
  var failures = 0;

  runner.on('pass', function(test) {
    passes++;
    console.log('pass: %s', test.fullTitle());
  });

  runner.on('fail', function(test, err) {
    failures++;
    console.log('fail: %s -- error: %s', test.fullTitle(), err.message);
  });

  runner.on('end', function() {
    console.log('end: %d/%d', passes, passes + failures);
  });
}

如此看来,自定义reporter的编写其实很简单:只要自定义一个函数,在函数的参数 runner 上注册已有的事件钩子即可。

事件钩子

支持的事件钩子有如下几种:

事件名称触发条件回调函数的参数属性
“start”整个测试开始执行时
“end”整个测试执行结束时
“suite”测试集(describe 所定义的用例集合)开始执行时触发suitesuite.title suite的名称,也就是describe 里规定的描述
“suite end”测试集(以及所有的子集)执行结束suite
“test”单个测试用例(it 所定义的用例集合)执行开始testtest.title test的名称,也就是 it 里规定的描述文字
test.fullTitle() 包含所属 suite 的 test的名称
“test end”单个测试用例执行结束
“pass”单个测试用例执行通过test
“fail”单个测试用例执行失败test, err
“pending”单个测试用例执行暂不执行test

注意,除了describe 定义的suite以外,还有一个默认的"顶级"suite,包含所有要执行的 describe 的顶级集合。虽然在用例执行过程中不可见,但是会触发 “suite” 和 “suite end” 事件。“顶级"suite有一个字段 root=true ,可以用于排除,例如:

runner.on("suite", function(suite) {
    if (suite.root) {
      return;
    }
    ....
}

runner的属性

函数的参数 runner,是测试的执行器,包含了测试过程相关的信息:比如 runner.stats 包含了统计信息

stats: { 
    suites: 0, 
    tests: 0, 
    passes: 0, 
    pending: 0, 
    failures: 0
} 

继承 reporter

官方例子 的最后,还有一句如何继承已有 reporter 的方法:

// To have this reporter "extend" a built-in reporter uncomment the following line:
// mocha.utils.inherits(MyReporter, mocha.reporters.Spec);

比如我想继承默认的失败原因列表,这个列表来自 reporter 基类的 epilogue() 函数,如果自己写会很麻烦,但是只需要一行语句就可以继承下来:

runner.once("end", this.epilogue.bind(this));
mocha.utils.inherits(MyReporter, mocha.reporters.Base);

如果您对本站内容有疑问或者寻求合作,欢迎 联系邮箱邮箱已到剪贴板

标签: PUPPETEER

欢迎转载本文,惟请保留 原文出处 ,且不得用于商业用途。
本站 是个人网站,若无特别说明,所刊文章均为原创,并采用 署名协议 CC-BY-NC 授权。