reporters.md

扩展默认报告器 {#extending-reporters}

::: warning 这是一个高级 API。如果我们只是想配置内置报告器，请阅读 报告器 指南。 :::

我们可以从 vitest/reporters 导入报告器并扩展它们来创建自定义报告器。

扩展内置报告器 {#extending-built-in-reporters}

一般来说，我们不需要从头开始创建报告器。vitest 附带了几个可以扩展的默认报告程序。

import { DefaultReporter } from 'vitest/reporters'

export default class MyDefaultReporter extends DefaultReporter {
  // 执行操作
}

当然，我们可以从头开始创建报告器。只需扩展 BaseReporter 类并实现我们需要的方法即可。

这是自定义报告器的示例：

import { BaseReporter } from 'vitest/reporters'

export default class CustomReporter extends BaseReporter {
  onTestModuleCollected() {
    const files = this.ctx.state.getFiles(this.watchFilters)
    this.reportTestSummary(files)
  }
}

或者实现 Reporter 接口：

import type { Reporter } from 'vitest/node'

export default class CustomReporter implements Reporter {
  onTestModuleCollected() {
    // 打印内容
  }
}

然后我们可以在 vitest.config.ts 文件中使用自定义报告器：

import { defineConfig } from 'vitest/config'
import CustomReporter from './custom-reporter.js'

export default defineConfig({
  test: {
    reporters: [new CustomReporter()],
  },
})

报告的任务 {#reported-tasks}

建议使用 Reported Tasks API，而不是使用报告器接收到的任务。

我们可以通过调用 vitest.state.getReportedEntity(runnerTask) 访问此 API：

import type { Reporter, TestModule } from 'vitest/node'

class MyReporter implements Reporter {
  onTestRunEnd(testModules: ReadonlyArray<TestModule>) {
    for (const testModule of testModules) {
      for (const task of testModule.children) {
        //                          ^?
        console.log('test run end', task.type, task.fullName)
      }
    }
  }
}

导出报告器 {#exported-reporters}

vitest 附带了一些 内置报告器，我们可以开箱即用。

内置报告器: {#built-in-reporters}

1. DefaultReporter
2. DotReporter
3. JsonReporter
4. VerboseReporter
5. TapReporter
6. JUnitReporter
7. TapFlatReporter
8. HangingProcessReporter
9. TreeReporter

基础抽象报告器: {#base-abstract-reporters}

1. BaseReporter

接口报告器: {#interface-reporters}

1. Reporter