run([options])

• options <Object> 运行测试的配置选项。支持以下属性：
  • concurrency <number> | <boolean> 如果提供了一个数字，那么将会有对应数量的测试进程并行运行，每个进程对应一个测试文件。 如果为 true，则会并行运行 os.availableParallelism() - 1 个测试文件。 如果为 false，则一次只运行一个测试文件。 默认值： false。
  • files: <Array> 包含要运行文件列表的数组。 默认值: 与 从命令行运行测试 相同。
  • forceExit: <boolean> 配置测试运行器在所有已知测试执行完毕后退出进程，即使事件循环本来仍会保持活动状态。默认值: false。
  • globPatterns <Array> 一个包含用于匹配测试文件的 glob 模式列表的数组。此选项不能与 files 一起使用。默认值： 与 从命令行运行测试 相同。
  • inspectPort <number> | <Function> 设置测试子进程的调试端口。这可以是一个数字，或者是一个不带参数且返回数字的函数。如果提供的是空值，则每个进程都会获得自己的端口，该端口从主进程的 process.debugPort 开始递增。如果 isolation 选项设置为 'none'，则会忽略此选项，因为不会生成任何子进程。默认值: undefined。
  • isolation <string> 配置测试隔离类型。如果设置为 'process'，每个测试文件将在一个单独的子进程中运行。如果设置为 'none'，所有测试文件将在当前进程中运行。默认值： 'process'。
  • only <boolean> 如果为真，测试环境将只运行设置了 only 选项的测试
  • setup <Function> 一个接受 TestsStream 实例的函数，可用于在运行任何测试之前设置监听器。 默认值: undefined。
  • execArgv <Array> 当生成子进程时，传递给 node 可执行文件的命令行标志数组。当 isolation 为 'none' 时，此选项无效。默认值: []
  • argv <Array> 一个数组，用于在生成子进程时传递给每个测试文件的命令行标志。当 isolation 为 'none' 时，此选项无效。默认值： []。
  • signal <AbortSignal> 允许中止正在进行的测试执行。
  • testNamePatterns <string> | <RegExp> | <Array> 一个字符串、正则表达式或正则表达式数组，可用于仅运行名称与提供的模式匹配的测试。测试名称模式被解释为 JavaScript 正则表达式。对于执行的每个测试，任何相应的测试钩子（如 beforeEach()）也会运行。默认值： undefined。
  • testSkipPatterns <string> | <RegExp> | <Array> 一个字符串、正则表达式或正则表达式数组，可用于排除运行名称与提供的模式匹配的测试。测试名称模式被解释为 JavaScript 正则表达式。对于执行的每个测试，任何对应的测试钩子（如 beforeEach()）也会运行。默认值： undefined。
  • timeout <number> 测试执行将在指定的毫秒数后失败。如果未指定，子测试将继承其父测试的该值。默认值: Infinity。
  • watch <boolean> 是否以监听模式运行。默认值： false。
  • shard <Object> 在特定分片中运行测试。默认值： undefined。
    • index <number> 是一个介于 1 和 <total> 之间的正整数，用于指定要运行的分片索引。此选项为 必填。
    • total <number> 是一个正整数，用于指定要将测试文件拆分的总分片数。此选项是 必需的。
  • coverage <boolean> 启用 代码覆盖率 收集。 默认值： false。
  • coverageExcludeGlobs <string> | <Array> 使用通配符模式排除特定文件的代码覆盖范围，该模式可以匹配绝对路径和相对路径的文件。此属性仅在 coverage 设置为 true 时适用。如果同时提供 coverageExcludeGlobs 和 coverageIncludeGlobs，文件必须同时满足 两个 条件才能包含在覆盖报告中。默认值： undefined。
  • coverageIncludeGlobs <string> | <Array> 使用通配符模式包含代码覆盖率中的特定文件，该模式可以匹配绝对路径和相对路径。 仅当 coverage 设置为 true 时，此属性才适用。如果同时提供了 coverageExcludeGlobs 和 coverageIncludeGlobs，文件必须同时满足 两个 条件才能被包含在覆盖率报告中。默认值： undefined。
  • lineCoverage <number> 要求覆盖的代码行达到最低百分比。如果代码覆盖率未达到指定阈值，进程将以代码 1 退出。默认值: 0。
  • branchCoverage <number> 要求覆盖的分支最小百分比。如果代码覆盖率未达到指定阈值，进程将以代码 1 退出。默认值: 0。
  • functionCoverage <number> 要求最少的函数覆盖率百分比。如果代码覆盖率未达到指定的阈值，进程将以代码 1 退出。默认值: 0。
• 返回：<TestsStream>

注意： shard 用于在多台机器或多个进程之间水平并行运行测试，非常适合在各种环境下进行大规模执行。它与 watch 模式不兼容，后者用于快速代码迭代，通过在文件更改时自动重新运行测试。

import { tap } from 'node:test/reporters';
import { run } from 'node:test';
import process from 'node:process';
import path from 'node:path';

run({ files: [path.resolve('./tests/test.js')] })
 .on('test:fail', () => {
   process.exitCode = 1;
 })
 .compose(tap)
 .pipe(process.stdout);const { tap } = require('node:test/reporters');
const { run } = require('node:test');
const path = require('node:path');

run({ files: [path.resolve('./tests/test.js')] })
 .on('test:fail', () => {
   process.exitCode = 1;
 })
 .compose(tap)
 .pipe(process.stdout);拷贝