不装 Jest 也能跑测试:Node 22 内置 test runner 实测,附并发度与覆盖率数据
要给一个只有四个函数的小工具库补测试,我的第一反应是 npm i -D jest。但这次的被测对象就是几百行纯 Node 代码,为了它装一整套测试框架(连带 babel、ts 变换、环境模拟)总觉得不划算。Node 18 起内置了 node:test,到 22 已经是稳定 API。于是这次一个依赖都没装,直接用内置的跑。结论是够用,而且有几个数字值得记下来。
一、最小可用:require 两个模块就能开始
被测代码照常写,不用为了测试改结构:
// lib/async-tools.js
async function mapLimit(items, limit, worker) {
if (!Number.isInteger(limit) || limit < 1) throw new RangeError('limit 必须是 >=1 的整数');
const results = new Array(items.length);
let cursor = 0;
const runners = Array.from({ length: Math.min(limit, items.length) }, async () => {
while (true) {
const i = cursor++;
if (i >= items.length) return;
results[i] = await worker(items[i], i);
}
});
await Promise.all(runners);
return results;
}
module.exports = { mapLimit, debounce };
测试文件里只需要 node:test 和 node:assert,都是内置的:
const test = require('node:test');
const assert = require('node:assert');
const { mapLimit } = require('../lib/async-tools.js');
test('mapLimit 保持输入顺序', async () => {
const out = await mapLimit([5, 1, 3], 2, async (n) => {
await new Promise((r) => setTimeout(r, n * 10));
return n * 2;
});
assert.deepStrictEqual(out, [10, 2, 6]);
});
test('mapLimit 非法 limit 抛 RangeError', async () => {
await assert.rejects(() => mapLimit([1], 0, async (x) => x), RangeError);
});
然后直接 node --test。我这个目录 25 个文件、76 个用例,全部通过,报告里给出 duration_ms 1794。不需要配置文件,package.json 里也什么都不用加(想省事就加一行 "test": "node --test")。
二、并发度:这次实测里收益最大的一项
每个测试文件是一个独立的子进程,并发度由 --test-concurrency 控制,默认是 availableParallelism() - 1(我这台 8 核,算出来是 7)。用上面那个目录实测,改这一个参数的差别非常大:
--test-concurrency=1 6896 ms
--test-concurrency=2 3747 ms
--test-concurrency=4 2422 ms
--test-concurrency=8 2337 ms
默认(7) 2256 ms
从 1 提到 4 直接省掉 65% 的时间;再往上堆收益就很小了,因为瓶颈已经不是并行度,而是每个子进程的启动开销。
这里有个反直觉的结论:测试文件拆得越细,串行时反而越慢。我量了一下本机的基线——空跑 node -e "" 要 510ms 左右(这个 Node 是带一层 shim 的托管版本,比官方发行版启动慢),跑一个含 3 个用例的测试文件约 758ms。也就是说每个文件大约有 250ms 花在进程启动和结果上报上,跟里面有几个用例关系不大。所以不要盲目把测试切得很碎,或者至少别把并发度留在 1。
三、覆盖率:一个会骗人的汇总数字
加 --experimental-test-coverage 就能直接出覆盖率表,同样不用装任何东西。但我第一次看汇总差点以为代码有大问题:
all files 40.55% 行 / 47.46% 分支 / 35.29% 函数
而我自己的 async-tools.js 明明是三个 100%。原因在统计范围:覆盖率会把所有被加载到的文件都算进汇总,包括工作目录之外的。我这里是托管 Node 启动时加载的 shim 包装脚本,光它自己就有八百多行未覆盖,我的文件只占汇总里的一行,被平均掉了。
解决办法是用 --test-coverage-exclude 明确范围:
node --test --experimental-test-coverage \
--test-coverage-exclude='test/' \
--test-coverage-exclude='/*.test.js'
排除之后报告里只剩下被测文件:行 100.00、分支 100.00、函数 100.00。所以看覆盖率之前先确认统计范围,否则那个汇总数字没有任何意义。
四、能直接拿去卡 CI 的阈值
只看数字没用,得能让流水线失败。三个参数分别卡行、分支、函数:
--test-coverage-lines / --test-coverage-branches / --test-coverage-functions
实测设 --test-coverage-lines=90,覆盖率不达标时进程退出码是 1,达标是 0。也就是说 CI 里不需要额外插件,一条命令就能当门禁。
五、文件发现规则:Jest 用户最容易踩的一个
我特意试了三种命名:
· test/ 目录下的任意 .js 都会被收进来,哪怕文件名叫 plain.js;
· x-test.js 这种连字符命名会被收;
· y.spec.js 不会被收——Jest 里 *.spec.js 的默认约定在这里不成立。
排查方法很简单,跑完看报告里的 # tests 计数对不对,或者用 --test-reporter=dot 先看收敛情况。
总结
这次的结果是:新增依赖 0 个,配置文件 0 个,25 个文件 76 个用例在并发度 4 时 2.4 秒跑完,覆盖率一条命令出表且能直接当 CI 门禁。需要注意的就三件事:并发度别留在 1、覆盖率一定要排除统计范围、spec 命名不认。
内置 runner 没打算替代 Jest 的全部能力——快照测试、DOM 环境、变换链这些仍然得靠生态。但如果测的是纯 Node 的工具库、脚本、服务端逻辑,它现在就够用了,而且省下来的那层依赖和配置,本身就是收益。
- 点赞
- 收藏
- 关注作者
评论(0)