修复项目切换清单竞态测试超时

等待事件监听注册后再触发 manifest 失效并以有界断言确认读取启动将迟到响应收尾纳入异步 act 避免测试时序悬挂补充 React 异步事件测试准则
2026-08-07 14:26:49 +08:00
parent ab5ec2c40f
commit 4911801ed6
2 changed files with 27 additions and 12 deletions
@@ -1,6 +1,6 @@
 # React 组件测试准则

-更新时间：`2026-06-26`
+更新时间：`2026-08-07`

 ## 背景

@@ -36,6 +36,7 @@
 - `data-testid` 名称必须描述用户或稳定渲染边界，例如 `image-canvas-editor-snap-guide-vertical`；不要描述 React 私有 state 名称。
 - 测试用 fixture 只包含本行为需要的字段。演化中的 payload 使用 `expect.objectContaining(...)` 或 helper 生成默认对象，避免一处契约加字段导致大量无关用例碎裂。
 - 当测试是为防止历史回归，应在测试名或邻近注释中说明防的是什么行为，而不是记录实现步骤。
+- 测试 React effect 中注册的事件监听时，触发事件前先用可观测的 listener 调用确认注册已完成；异步请求已开始应用有界 `waitFor` 断言确认，不要用无界手工 Promise 等待一次性信号。解除挂起请求时将 Promise 收尾纳入异步 `act`，确保后续 React 更新在断言前已冲刷。

 ## 试点调整