使用 node.js 内置的 assert 模块结合 es modules 语法,通过 import 引入被测代码和断言库,利用顶层 await 处理异步逻辑并执行测试。在 package.json 中设置 "type": "module" 以启用原生 esm 支持,直接运行测试脚本即可验证功能。

如何配置项目以支持 ESM 测试
在 Node.js 环境中运行 ES Modules 测试,核心在于正确配置 package.json 文件。将 type 字段设置为 module 后,所有 .js 后缀的文件都会被解析为 ES Module,从而允许使用 import 和 export 语法。无需额外的 Babel 或 Webpack 转换步骤,Node.js 原生支持这种模式。确保测试脚本与源文件位于同一项目目录下,以便路径导入正常工作。

{
"name": "esm-test-project",
"version": "1.0.0",
"type": "module",
"scripts": {
"test": "node test.mjs"
}
}
上述 JSON 配置是基础。保存该文件后,你可以创建名为 test.mjs 或 test.js 的测试文件。Node.js 会识别 "type": "module" 并加载 ESM 环境。如果项目中同时存在 CommonJS 和 ESM 文件,建议将 ESM 文件重命名为 .mjs,或者保持 package.json 统一配置并仅使用 .mjs 后缀以避免混淆。对于纯 ESM 项目,统一使用 package.json 声明是最简洁的做法。
如何使用 assert 进行同步与异步断言
Node.js 的 assert 模块提供了丰富的断言方法,如 strictEqual、deepStrictEqual 和 rejects。在 ESM 中,你需要从 node:assert 导入这些函数。对于同步函数,直接调用断言即可;对于返回 Promise 的异步函数,必须使用顶层 await 包裹断言调用,或在 try...catch 块中使用 assert.rejects。这种写法保持了代码的线性结构,避免了回调地狱。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

// source.js
export function add(a, b) {
return a + b;
}
export async function fetchData() {
return { status: 200 };
}
// test.mjs
import assert from 'node:assert';
import { add, fetchData } from './source.js';
// 同步测试
const result = add(1, 2);
assert.strictEqual(result, 3, '加法结果应为 3');
// 异步测试
const data = await fetchData();
assert.deepStrictEqual(data, { status: 200 }, '数据应匹配');
console.log('All tests passed');
在 test.mjs 中,首先导入源模块和断言库。同步测试部分,调用 add(1, 2) 并立即用 assert.strictEqual 检查结果。异步测试部分,使用顶层 await 等待 fetchData() 完成,然后对返回对象进行深度比较。如果断言失败,Node.js 会抛出异常并终止脚本,输出错误信息。这种模式简单直观,适合小型项目的单元测试。
如何处理模块导入路径与相对路径解析
在 ESM 测试中,导入本地模块时必须使用相对路径,且必须以 ./ 或 ../ 开头。例如,导入同目录下的 source.js 应写为 import { ... } from './source.js'。省略扩展名在某些环境下可能有效,但推荐显式指定 .js 后缀以确保兼容性。如果路径错误,Node.js 会抛出 ERR_MODULE_NOT_FOUND 错误。此外,避免使用绝对路径,除非你配置了 NODE_PATH 环境变量,但这通常不推荐用于可移植的测试套件。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










