Playwright 1.47 新特性与时间控制实战

---

标题: Playwright 1.47 新特性与时间控制实战

关键词:

• Playwright 1.47
• Docker 镜像 Ubuntu 24.04 Noble
• 22.04 Jammy 选项
• page.clock API
• 时间冻结与跳转
• 端到端测试

描述: 概述 Playwright 1.47 的关键更新（Docker 镜像与时间控制 API），提供已验证来源与测试落地示例，以增强端到端场景的可控性与可靠性。

categories:

• 文章资讯
• 技术教程

---

引言

• Playwright 1.47 聚焦于平台镜像更新与测试能力增强，尤其是 page.clock 时间控制 API，便于模拟设备休眠/恢复与时间跳转行为。

核心更新（已验证）

• 官方镜像更新：mcr.microsoft.com/playwright:v1.47.0 基于 Ubuntu 24.04 Noble；若需 22.04 Jammy，请使用 ...:v1.47.0-jammy。来源：Playwright 官方发行说明（中/英文）。
• 时间控制 API：page.clock.install、page.clock.pauseAt 等，可在测试中冻结或前移时间，便于验证与时间相关的业务逻辑。来源：Playwright 官方发行说明。

实战示例

// 伪代码：在测试用例中安装时钟并控制时间流动
await page.clock.install({ time: new Date('2024-02-02T08:00:00') })
await page.goto('http://localhost:3333')
await page.clock.pauseAt(new Date('2024-02-02T10:00:00'))
await expect(page.getByTestId('current-time')).toHaveText('2/2/2024, 10:00:00 AM')

落地建议

• 场景覆盖：为依赖系统时间的功能添加时间冻结与跳转用例；覆盖休眠、恢复与跨时区行为。
• 镜像选择：CI 环境根据基线系统选择 Noble 或 Jammy 镜像，确保浏览器版本与依赖一致性。

参考链接（验证来源）

• Playwright 中文网：发行说明（含 1.47 Docker 镜像与 Clock API）：https://playwright.nodejs.cn/docs/release-notes
• Playwright 官方：发行说明（英文原文）：https://playwright.dev/docs/release-notes

结语

• 1.47 的时间控制与镜像更新提升了端到端测试的可控性与稳定性；建议尽快在关键流程中引入 page.clock 测试用例。

---