docs(tests): 说明浏览器驱动、React fixture 与渲染探针 #10

2026-11-12T03:14:15Z

codex-bot commented

2026-11-12 03:14:15 +00:00

浏览器测试驱动和 React fixture 的职责、状态边界及验证含义缺少说明。此次仅补充中文注释，帮助读者区分真实浏览器能力、内存替身与性能观测。

实际改动：

cdp-client.mjs / cdp-client.test.mjs：请求 ID 路由、pending 和截止定时器、普通协议错误与连接/目标终态，四个对应单测。
browser-storage.mjs：隔离 profile、源码/发布包 HTTP、可控 NDJSON、内联 CDP 与退出清理；明确该简化实现没有独立调用器的连接级超时保护。
blob-checkpoint-browser-cases.mjs：旧 DB 升级、Blob 精确字节、未来格式、事务故障、owner 失效及 blocked upgrade。
pointer-capture.test.mjs：指针/捕获目标归属和安全释放；明确使用对象替身。
renderers.test.mjs：目录捕获、React 别名与 preview、模型契约、投影和共享原记录。
react-hooks-fixture.tsx：窄订阅、命令 facade、手势租约、mode、资源引用、Provider owner 变化、durability 与部分加载；明确存储/上传为替身。
renderer-extension.tsx：自定义插件模型、渲染计数、scoped editing 桥接和事务化按钮编辑。
selection-listener-fixture.tsx：按需安装的原生 ReactFlow selection 观察、控制对象与清理。
renderer-performance.mjs：原生输入/IME、离屏保留、面板/portal、大复制和 rAF/longtask/堆采样报告；明确下一 rAF 是观测近似而非 compositor 上屏证明。

检查：

十文件相对最新 origin/main 的 AST 一致，仅注释变化；内嵌页面脚本原字节未改。
822 项现有 Node 测试全部通过。
git diff --check 通过。
本轮未运行浏览器场景、性能探针或构建。

PR #9 已合并后，从最新 main 建立本分支，只包含本批十个文件（e0e4276）。全项目注释任务仍在第四阶段，本 PR 是可独立评审的已验证批次。等待用户手动合并。

追加：浏览器存储场景前半部分与编排（f08310b）

browser-storage-cases.mjs：模块职责及真实浏览器/内存服务边界。
前 19 个 helper：共享流和显示 URL、图片自动尺寸、真实 Worker、输入所有权、协作复制、重复恢复审计、historyReplay/transition、已确认遍历、分组历史、缩放单位、结构恢复、成功回执协调失败和替代请求丢 ACK。逐块解释准备、故障注入、断言及清理。
run 总入口：场景编排、基础 checkpoint/文件原子切点、leader/fence、同修订重试、篡改与 journal 缺口，以及结果消息何时产生。

单文件只修改注释，AST 一致；node --check 与 git diff --check 通过。本轮未执行浏览器或构建，也未重复运行不加载此浏览器模块的 Node 单测。该文件的后半部分仍待注释，不把整文件或全项目任务表述为已完成。

浏览器测试驱动和 React fixture 的职责、状态边界及验证含义缺少说明。此次仅补充中文注释，帮助读者区分真实浏览器能力、内存替身与性能观测。实际改动： - cdp-client.mjs / cdp-client.test.mjs：请求 ID 路由、pending 和截止定时器、普通协议错误与连接/目标终态，四个对应单测。 - browser-storage.mjs：隔离 profile、源码/发布包 HTTP、可控 NDJSON、内联 CDP 与退出清理；明确该简化实现没有独立调用器的连接级超时保护。 - blob-checkpoint-browser-cases.mjs：旧 DB 升级、Blob 精确字节、未来格式、事务故障、owner 失效及 blocked upgrade。 - pointer-capture.test.mjs：指针/捕获目标归属和安全释放；明确使用对象替身。 - renderers.test.mjs：目录捕获、React 别名与 preview、模型契约、投影和共享原记录。 - react-hooks-fixture.tsx：窄订阅、命令 facade、手势租约、mode、资源引用、Provider owner 变化、durability 与部分加载；明确存储/上传为替身。 - renderer-extension.tsx：自定义插件模型、渲染计数、scoped editing 桥接和事务化按钮编辑。 - selection-listener-fixture.tsx：按需安装的原生 ReactFlow selection 观察、控制对象与清理。 - renderer-performance.mjs：原生输入/IME、离屏保留、面板/portal、大复制和 rAF/longtask/堆采样报告；明确下一 rAF 是观测近似而非 compositor 上屏证明。检查： - 十文件相对最新 origin/main 的 AST 一致，仅注释变化；内嵌页面脚本原字节未改。 - 822 项现有 Node 测试全部通过。 - git diff --check 通过。 - 本轮未运行浏览器场景、性能探针或构建。 PR #9 已合并后，从最新 main 建立本分支，只包含本批十个文件（e0e4276）。全项目注释任务仍在第四阶段，本 PR 是可独立评审的已验证批次。等待用户手动合并。追加：浏览器存储场景前半部分与编排（f08310b） - browser-storage-cases.mjs：模块职责及真实浏览器/内存服务边界。 - 前 19 个 helper：共享流和显示 URL、图片自动尺寸、真实 Worker、输入所有权、协作复制、重复恢复审计、historyReplay/transition、已确认遍历、分组历史、缩放单位、结构恢复、成功回执协调失败和替代请求丢 ACK。逐块解释准备、故障注入、断言及清理。 - run 总入口：场景编排、基础 checkpoint/文件原子切点、leader/fence、同修订重试、篡改与 journal 缺口，以及结果消息何时产生。单文件只修改注释，AST 一致；node --check 与 git diff --check 通过。本轮未执行浏览器或构建，也未重复运行不加载此浏览器模块的 Node 单测。该文件的后半部分仍待注释，不把整文件或全项目任务表述为已完成。

codex-bot added 1 commit 2026-11-12 03:14:17 +00:00

docs(tests): explain browser drivers React fixtures and renderer probes e0e4276e71

codex-bot added 1 commit 2026-11-12 03:22:19 +00:00

docs(tests): explain browser storage history recovery and suite orchestration f08310b83c

Zayden-Jung merged commit 6298202dd7 into main

2026-11-12 03:26:08 +00:00

~~codex-bot referenced this pull request 2026-11-12 03:30:02 +00:00~~

docs: 补充存储与渲染场景、样式和配置说明 #11

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: Zayden-Jung/Endoleap#10