From c15a5e67299e08b3005c9706ce5cd69c455f36af Mon Sep 17 00:00:00 2001 From: Codex Bot Date: Thu, 12 Nov 2026 21:08:47 +0800 Subject: [PATCH] docs: distinguish window and rendering test coverage boundaries --- src/runtime/endor_host/tests.rs | 20 ++++++++++++-------- 1 file changed, 12 insertions(+), 8 deletions(-) diff --git a/src/runtime/endor_host/tests.rs b/src/runtime/endor_host/tests.rs index c76f97c..ed524b0 100644 --- a/src/runtime/endor_host/tests.rs +++ b/src/runtime/endor_host/tests.rs @@ -1654,7 +1654,7 @@ fn failed_input_after_window_close_cannot_leave_owned_mounts_in_closed_context() #[test] /// 依次通过事件激活页面、修改 title、关闭页面、清空及重开。 -/// 检查标签反映真实 Page 方法,稳定业务 ID 与递增展示 ID 各自正确,旧版本事件被桥接层拒绝。 +/// 检查标签反映真实 Page 方法:同窗存续标签保持数字 ID,关闭并发布后重开会获新 ID;旧版本事件被桥接层拒绝。 fn tab_projection_uses_page_methods_and_rejects_old_presentations() { // 页面标题/打开顺序来自真实 Window 注册表,最后一次 render 使 second 初始选中。 let source = r#"first = Page() @@ -1692,7 +1692,7 @@ fn tab_projection_uses_page_methods_and_rejects_old_presentations() { .dispatch(&mut session.candidate.vm, &input) .is_err() ); - // 只改 title 不改 Page 身份,标签文字更新但第一页原稳定 Tab ID 保持。 + // 只改 second.title 后检查第二页文字更新,并核对未改动的第一页 ID;此处没有断言第二页 ID 本身不变。 let renamed = session .execute(r#"second.title = "Renamed""#, "app.main") .unwrap() @@ -1745,7 +1745,8 @@ fn tab_projection_uses_page_methods_and_rejects_old_presentations() { } #[test] -/// 同次成功输入的两次 resize 合并为最后尺寸,并保留 title/focus 命令。 +/// 同次成功输入的两次 resize 合并为最后尺寸;检查命令共三条及前两条的 resize/title 内容。 +/// 本例提交了 focus,但没有单独断言第三条动作类型;不能将数量检查当成完整命令序列校验。 /// 命令只消费一次;失败输入之前积累的 resize 也必须丢弃,不能送到原生窗口。 fn managed_window_requests_are_coalesced_and_failed_input_discards_pending_requests() { // 空持久会话已有托管主 Window,命令登记不需要先 render 页面,也不在测试实际打开 OS 窗口。 @@ -1941,7 +1942,7 @@ fn click_named(session: &mut ReplSession, document: &RenderDocument, name: &str) .iter() .find(|mount| mount.block_id == block.to_string()) .unwrap(); - // 使用当前 session/layout_version 派发,避免复用旧文档造成过期事件被丢弃。 + // session 身份取当前会话,layout_version 取传入文档;调用方必须传该会话的最新完整主窗文档。 // 不提供坐标,直接验证指定按钮的 click 回调;要求返回新文档供下一次点击使用。 session .dispatch(&crate::events::Input { @@ -2037,7 +2038,7 @@ fn source_measure_cache_reuses_independent_results_and_invalidates_model_changes .unwrap(); // 初始两项源测量均需执行;后面的统计由每次更新产生,检查更新本身的复用情况。 assert_eq!(source_measure_stat(&mut session, "sourceMeasureMisses"), 2); - // 调用上面的事件助手触发颜色按钮;事件路径与正常 UI 输入相同。 + // 调用上面的无坐标 click 助手触发按钮;覆盖运行时事件/回调路径,不覆盖原生点击坐标与源形状命中。 let painted = click_named(&mut session, &initial, "blue"); // 核对颜色已变化,排除因按钮未生效而导致的“没有重新测量”。 assert!(painted.frame.commands.iter().any( @@ -2235,6 +2236,7 @@ fn viewport_resize_changes_constraints_and_preserves_mount_identity_without_sour assert!(!session.is_faulted()); } +// 后续布局依赖、共享出现与非法协议测试共用的源夹具;replace 仅派生各测试输入,不修改示例文件。 const SOURCE_LAYOUT: &str = include_str!("../../../examples/source-layout.endor"); #[test] @@ -2602,7 +2604,8 @@ fn layout_and_paint_prepare_keep_only_current_occurrence_managed_helpers() { let crate::source_paint::Progress::Pending(work) = progress else { panic!("paint must yield"); }; - // 每片只保留当前出现位置的辅助对象/结果;不能在首次让出前为所有位置预建 Bounds 和 collector。 + // 在首次 Pending 处检查相对 baseline 的托管对象数净增小于 256;不统计原生内存或该片中间的分配峰值。 + // 两种树规模共用阈值,用于发现首次让出前为整树预建并保留 Bounds/collector 的退化。 assert!(session.candidate.vm.object_count() < before + 256); // 取消未完成帧并检查 VM 续体释放,随后才能独立测试布局路径。 session @@ -2634,7 +2637,7 @@ fn layout_and_paint_prepare_keep_only_current_occurrence_managed_helpers() { .bridge .begin_layout_frame(&mut session.candidate.vm, root) .unwrap(); - // 要求布局也实际暂停,随后用与绘制相同的固定阈值核对辅助对象增长。 + // 要求布局也实际暂停,随后检查此暂停点的托管对象数净增;这是独立布局 baseline,不累计绘制阶段。 let crate::ui_bridge::LayoutProgress::Pending(work) = progress else { panic!("layout must yield"); }; @@ -2714,7 +2717,8 @@ fn pending_paint_retargets_without_replaying_completed_mount_hooks() { session.execute("mounted.value", "app.main").unwrap().value, "80" ); - // 取消应恰好发生一次,多片绘制统计则证明此用例确实跨越过执行切片。 + // paintCancels 是此会话累计取消计数,paintSlices 对应最近完成的 solve;两者不是同一时间范围的统计。 + // 首次加载后本例仅重定向一次,因此应恰好取消一次;完成的绘制应确实跨过多个切片。 assert_eq!(source_measure_stat(&mut session, "paintCancels"), 1); assert!(source_measure_stat(&mut session, "paintSlices") > 1); }