Playwright 的 download 事件对象本身不提供内置的耗时属性，但可通过手动记录起止时间戳（如 Date.now()）精确计算下载总时长。本文详解实现步骤、最佳实践及常见注意事项。
playwright 的 `download` 事件对象本身不提供内置的耗时属性，但可通过手动记录起止时间戳（如 `date.now()`）精确计算下载总时长。本文详解实现步骤、最佳实践及常见注意事项。
在 Playwright 自动化测试中，监控文件下载性能是常见的质量保障需求。虽然官方文档提及 request.timing() 方法可用于获取网络请求各阶段耗时，但该方法仅适用于 Request 对象（如通过 page.on('request') 捕获），不适用于 Download 对象——因为 Download 是独立于 HTTP 请求生命周期的异步资源操作，其 timing 属性并不存在。
因此，推荐采用时间戳差值法：在触发下载操作前记录开始时间，在 download 事件完成后再记录结束时间，两者相减即为实际下载耗时（单位：毫秒）。为确保精度与可靠性，应使用 Promise.all 并发等待下载事件与点击动作，避免因顺序执行引入额外延迟：
Manikantasai Playwright Automation
下载
使用Playwright API直接进行浏览器自动化。导航网站、与元素交互、提取数据、截图、生成PDF、录制视频，自动化复杂工作流程。比MCP方法更可靠。
const startTime = Date.now();
// 并发执行：等待下载事件 + 触发下载按钮点击
const [download] = await Promise.all([
page.waitForEvent("download", { timeout: 35000 }),
page.getByRole("button", { name: "Download" }).click({ timeout: 35000 })
]);
const endTime = Date.now();
const duration = endTime - startTime;
console.log(`Download took ${duration} ms`);
// 可选：进一步处理下载文件，如保存或校验
await download.saveAs(`/tmp/${download.suggestedFilename()}`);
⚠️ 注意事项：
- 勿使用 await 串行调用：若先 await click() 再 await waitForEvent()，则 startTime 到 endTime 会包含页面渲染、按钮响应等非下载耗时，导致结果偏大；
- 超时需统一设置：waitForEvent 和 click 的 timeout 应保持一致（如示例中的 35000），防止因某一项提前失败而中断整体流程；
- download 对象不含 timing 字段：尝试访问 download.timing 将返回 undefined，切勿依赖此属性；
- 如需更细粒度分析（如 DNS 查询、连接建立、传输时间），需结合 page.route() 拦截原始请求并调用 request.timing()，但这仅反映 HTTP 层面耗时，不等同于用户感知的完整下载耗时。
综上，Date.now() 时间戳方案简洁、可靠、兼容所有 Playwright 版本，是测量下载事件端到端时长的标准实践。
