适配器Node IPC
测试
验证 Node IPC 适配器行为及真实套接字集成。
Node IPC 包包含单元测试和基于真实 Unix 套接字的集成测试。
运行该包的测试:
pnpm --filter @nexus-js/node-ipc test使用 Mock Nexus 的单元测试
如果应用单元测试只需验证代码如何调用 Nexus 服务,可以使用 @nexus-js/testing。
const mock = createMockNexus();
mock.service(EchoToken, echoService);
const connection = await mock.nexus.connect({
target: {
context: "node-ipc-daemon",
appId: "example-app",
},
});
const echo = connection.get(EchoToken);这不验证 Node IPC 适配器本身。测试替身不会打开套接字、解析路径、执行消息分帧、运行共享密钥认证、检测残留套接字,也不覆盖守护进程重启行为。
测试范围
该包的测试覆盖:
- 二进制帧的半包和粘包处理
- 地址解析与路径校验
- Unix 套接字端口的读写和断开行为
- 残留套接字清理与已有守护进程保护
- 创建辅助函数的配置行为
- 共享密钥认证协议的健壮性
- 真实守护进程与客户端之间的 RPC
- Core
canConnect和canCall的集成 - 守护进程关闭与重建
- 构建产物的导入冒烟测试
集成测试结构
优先使用真实套接字集成测试验证适配器行为。
好的 node-ipc 集成测试应:
- 使用
mkdtemp创建临时套接字根目录 - 使用
usingNodeIpcDaemon启动守护进程 - 使用
usingNodeIpcClient启动客户端 - 通过 Nexus Core 注册真实服务
- 使用
nexus.connect()和connection.get()连接并获取服务 - 关闭两个运行时并删除临时目录
这些测试能发现模拟端点无法覆盖的适配器与 Core 集成问题。createMockNexus() 不负责这一层,应保留真实套接字测试。
避免不稳定的套接字测试
有明确的完成信号时,应等待该信号,而不是随意休眠一段时间。
优先:
- 等待套接字文件出现
- 等待
listen返回的 Promise 完成 - 等待回调触发
- 在超时测试中显式设置较短的适配器超时
在 os.tmpdir() 下创建临时路径,并在每个测试结束后清理。
测试认证失败
认证测试应同时验证认证行为和资源清理。
共享密钥预认证需要覆盖:
- 正确令牌通过认证
- 错误令牌认证失败
- 格式错误的认证消息被拒绝
- 正确缓存拆分到多个数据块中的消息
- 对端无响应时超时
- 过大的认证消息行被拒绝
- 客户端认证失败后销毁套接字
Core 授权策略需要覆盖:
canConnect允许与拒绝连接canCall允许与拒绝调用canCall拒绝时不会执行服务实现
测试守护进程重启
重启测试应验证句柄与会话的绑定行为:
- 获取代理并成功调用
- 关闭守护进程
- 验证旧代理调用失败
- 启动新的守护进程
- 获取新的代理
- 验证新代理调用成功