表单保存验证策略

---

一、macOS 富文本编辑器全选

macOS 上富文本编辑器的全选按键差异（Control+A 无效）→ references/macos-select-all.md

二、保存后验证策略：三级选择

保存后行为	验证方式	可靠性	适用场景
显示 Toast	is_visible(toast_locator) — 必须在 networkidle 后立即检测	低（2-3s 消失）	有明确 Toast 的场景
页面重定向	检测编辑页特征元素消失 wait_for(state="hidden")	中（持久状态）	保存后自动跳转的场景
无 UI 反馈	写入标记数据 → 重新打开 → 读取对比	高（数据级验证）	无 Toast、不确定是否重定向

原则：三级可组合使用。优先用持久状态变更，Toast 仅作辅助。

2.1 Toast 时序陷阱

click_save() 方法中的 wait_for_timeout() 会消耗 Toast 存活时间。必须在 networkidle 后立即检测 Toast，不能先等待再检测。

❌ 反例：

def click_save(self):
    self.click(self.SAVE_BTN)
    self.page.wait_for_load_state("networkidle")
    self.page.wait_for_timeout(3000)   # Toast 在这 3s 内出现又消失了

# 调用方
assert page.is_visible(toast)          # Toast 已消失，永远 False

✅ 正例：

def click_save(self):
    self.click(self.SAVE_BTN)
    self.page.wait_for_load_state("networkidle")
    # 不加额外等待 — 让调用方立即检测 Toast

# 调用方
is_ok = page.is_visible(toast, timeout=10000)   # 立即开始等 Toast
page.wait_for_timeout(3000)                      # 检测完再等页面稳定

2.2 重定向检测

保存后页面可能重定向离开编辑页。通过检测编辑页特征元素消失来确认保存成功：

def is_save_success(self) -> bool:
    """编辑页 header 消失 = 保存成功并已离开编辑页"""
    try:
        self.page.locator(self.EDIT_PAGE_HEADER).first.wait_for(
            state="hidden", timeout=15000
        )
        return True
    except Exception:
        return False

2.3 重定向目的地不可假设

保存后的重定向目的地可能因导航上下文不同而异（直接 URL 访问 vs SPA 内跳转 vs 新 tab 中操作）。不要断言重定向到某个特定页面。

❌ 反例：

# 假设保存后一定重定向到首页
redirected_home = HomePage(page)
assert redirected_home.is_page_loaded()   # 实际可能跳到其他页面

✅ 正例：

# 只验证离开了编辑页，不假设去了哪里
assert edit_page.is_save_success()        # 编辑页 header 消失 = 保存成功

---

三、多 tab 保存后：关闭旧 tab，从原始 tab 重入

保存动作发生在新开 tab 中时的处理 → references/multi-tab-reentry.md

四、数据对比验证模式（最终验证）

保存前后做数据比对的实现方式 → references/data-comparison.md