不装 Jest 也能跑测试:Node 22 内置 test runner 实测,附并发度与覆盖率数据

举报
yd_250310792 发表于 2026/11/15 11:37:26 2026/11/15
【摘要】 要给一个只有四个函数的小工具库补测试,我的第一反应是 npm i -D jest。但这次的被测对象就是几百行纯 Node 代码,为了它装一整套测试框架(连带 babel、ts 变换、环境模拟)总觉得不划算。Node 18 起内置了 node:test,到 22 已经是稳定 API。于是这次一个依赖都没装,直接用内置的跑。结论是够用,而且有几个数字值得记下来。一、最小可用:require 两个...

要给一个只有四个函数的小工具库补测试,我的第一反应是 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 的工具库、脚本、服务端逻辑,它现在就够用了,而且省下来的那层依赖和配置,本身就是收益。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。