TestCafe 在最新版 Chromium 浏览器中使用 navigateTo 方法的问题分析与解决方案

问题现象描述

在使用 TestCafe 进行 Web 自动化测试时，开发人员发现当测试脚本中包含 t.navigateTo() 方法调用时，在 Chromium 内核的浏览器（如 Chrome 和 Edge）中会出现测试挂起的问题。具体表现为：

1. 测试能够正常执行直到遇到 t.navigateTo(url) 方法
2. 浏览器确实会导航到指定 URL，但随后测试会挂起
3. 最终因超时而失败，终端显示浏览器已断开连接的错误信息

值得注意的是，这个问题仅出现在 Chromium 内核的浏览器中，在 Firefox 中相同的测试脚本可以正常运行。

问题根源分析

经过技术分析，这个问题与 Chromium 浏览器中的 Service Worker 机制有关。Service Worker 是现代浏览器中用于实现离线缓存、后台同步等功能的重要 API，但在自动化测试场景下可能会与测试框架产生冲突。

具体来说，当 TestCafe 尝试通过 navigateTo 方法导航页面时，Service Worker 可能会拦截并处理这个导航请求，导致测试框架无法正确检测到页面导航完成的状态，从而造成测试挂起。

解决方案

针对这个问题，可以采用以下解决方案：

1. 使用 CDP 客户端禁用 Service Worker

通过 Chrome DevTools Protocol (CDP) 直接控制浏览器，在测试开始前禁用 Service Worker：

import { Selector, Role } from 'testcafe';

const role = Role('https://www.saucedemo.com/', async t => {
  await t
    .typeText(Selector('[data-test="username"]'), 'standard_user')
    .typeText(Selector('#password'), 'secret_sauce')
    .click(Selector('#login-button'))
}, { preserveurl: true });

fixture`My fixture`
  .page`https://www.saucedemo.com/`
  .beforeEach(async t => {
    const idConnection = t.testRun.browserConnection.id;
    const cdpClient = t.testRun.browserConnection.getNativeAutomation(idConnection)._client;
    await cdpClient.Network.setBypassServiceWorker({ bypass: true });
    await t.useRole(role);
  });

2. 使用 Role 机制保持会话状态

TestCafe 的 Role 机制可以帮助维护测试状态，同时避免频繁的页面导航。通过创建 Role 并在测试中重用，可以减少因页面刷新或导航导致的问题。

最佳实践建议

1. 谨慎使用页面导航：在自动化测试中，尽量减少不必要的页面导航操作，保持测试的稳定性。

2. 处理 Service Worker 影响：对于依赖 Service Worker 的现代 Web 应用，测试时应考虑其可能带来的影响，必要时禁用或模拟其行为。

3. 多浏览器兼容性测试：由于不同浏览器内核实现差异，建议在多个浏览器中运行测试以确保兼容性。

4. 错误处理和重试机制：对于可能出现问题的操作，实现适当的错误处理和重试逻辑。

总结

TestCafe 作为一款强大的端到端测试框架，在处理现代 Web 应用时可能会遇到各种浏览器特性带来的挑战。理解这些问题的根源并掌握相应的解决方案，可以帮助开发人员构建更稳定可靠的自动化测试套件。对于 Service Worker 这类现代浏览器特性，测试时需要特别关注其对自动化流程的潜在影响。