为 Mocha.js 编写自定义的 reporter

先打个广告：欢迎关注我的公众号，参与 文史大挑战 趣味题目。使用方法见 这篇文章 。

正文开始：

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 上注册已有的事件钩子即可。

事件钩子

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

注意，除了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);

如果您对本文有疑问或者寻求合作，欢迎 联系邮箱 。邮箱已到剪贴板

精彩评论