Playwright 的 download 事件对象本身不提供内置的下载耗时信息，但可通过手动记录点击触发时刻与下载完成时刻的时间差，精确计算下载总时长。
playwright 的 `download` 事件对象本身不提供内置的下载耗时信息，但可通过手动记录点击触发时刻与下载完成时刻的时间差，精确计算下载总时长。
在 Playwright 中，page.waitForEvent("download") 返回的 Download 实例（如 download 对象）不包含 timing() 方法或任何原生的持续时间字段——这与 Request 或 Response 对象不同。官方文档中提到的 request.timing() 仅适用于网络请求生命周期，而下载事件属于浏览器级异步操作，其完整耗时（从点击触发到文件保存完成）需由测试脚本自主计量。
推荐采用高精度、低侵入性的 Date.now() 时间戳方案，配合 Promise.all() 确保时序严谨性：
Playwright Browser 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 durationMs = endTime - startTime;
console.log(`✅ Download completed in ${durationMs} ms`);
// 可选：进一步获取下载文件路径，验证结果
await download.path(); // 等待文件写入磁盘完成（返回 Promise<string>）</string>
⚠️ 注意事项：
- 避免使用 Date.now() 分开调用（如先 await click() 再 await waitForEvent()），因中间存在微任务延迟，会导致计时不准确；
- Promise.all() 能确保“点击发起”与“下载监听”并发启动，使 startTime 精确对应用户操作起点；
- 若需区分「网络传输时间」与「文件落地时间」，可结合 download.suggestedFilename() 和 download.path() 的执行间隔进行二次测量；
- 超时设置（如 35000 ms）建议统一，防止 waitForEvent 或 click 单独失败导致计时逻辑中断。
总结：虽然 Playwright 未为下载事件暴露内置计时 API，但通过合理利用 JavaScript 原生时间戳与并发等待机制，即可稳定、可靠地获取端到端下载耗时，满足性能监控与自动化验收场景需求。
