回放测试

回放会按步骤顺序在真实浏览器中执行用例。

回放的目标是验证业务路径是否仍然可用，并在失败时留下足够线索帮助定位问题。

执行链路

CueCast 使用双链路回放：

• CDP 主路径：通过 Chrome DevTools Protocol 模拟真实鼠标和键盘操作。
• DOM 降级：CDP 不可用或部分场景失败时，降级为 DOM 操作。

定位策略

回放优先使用录制时生成的 locator_meta 候选，按分数从高到低尝试，包括语义属性、组件根节点、CSS、XPath 和文本候选。

对于下拉浮层等需要先触发再出现的元素，CueCast 会执行 trigger-first 策略，先打开组件，再查找选项。

执行前检查

执行前建议确认：

• Chrome 扩展状态为「插件已就绪」。
• 目标页面可以从当前网络访问。
• 当前浏览器具备目标系统登录态。
• 测试数据存在，且不会被其他人或其他计划并发修改。
• 起始 URL 指向正确环境。

等待与稳定性

CueCast 会等待页面加载状态，并在步骤前按配置等待。对于加载慢、动画长或数据异步刷新明显的页面，可以适当增加步骤等待时间。

如果页面存在全局 loading、骨架屏或二次确认弹窗，建议让页面提供明确的稳定状态，而不是依赖固定等待。

常见失败原因

• 起始 URL 不可访问
• 未登录或登录态失效
• 页面加载过慢
• 目标元素被遮挡
• 页面结构变化
• 测试数据不存在
• 断言文本变化

失败后可优先查看执行结果中的失败步骤、截图和错误信息。

单条执行与计划执行

执行方式	适用场景	说明
单条回放	录制后验证、修复失败用例	反馈最快，适合维护阶段。
分组批量执行	一次性跑一组相关用例	适合模块级回归。
执行计划	发布前冒烟或完整回归	支持顺序、历史和失败即停止策略。