Playwright 1.44.1中waitForEvent('download')无法下载Excel文件

症状回顾 #

• 有头模式显示文件已下载，但实际未保存到指定路径
• waitForEvent('download')执行失败，改用page.on('download')后仍无法找到文件
• 读取文件时报错：TypeError: The "path" argument must be of type string or an instance of Buffer or URL. Received undefined

代码问题拆解 #

1. 异步方法未等待：blobFile.saveAs()是异步操作，原代码直接调用未加await，导致后续读取文件时，文件可能还未完成保存。
2. 同步循环误用异步回调：fs.readdirSync().forEach(async file => {})中的async回调不会被循环等待，逻辑会直接跳过；且await (testFolder + '/' + file)完全多余，字符串不需要异步等待。
3. 依赖不可靠的固定等待：硬编码waitForTimeout(10000)无法适配不同场景下的文件保存时长，容易出现文件未就绪就读取的情况。
4. 变量初始化问题：filepath未提前声明或初始化，且testFolder/testCaseFileName可能存在未定义的情况，导致路径拼接后出现undefined。

修复后的代码 #

// 确保testFolder和testCaseFileName为有效路径/前缀
const testFolder = "./your-target-folder"; // 替换为实际路径
const testCaseFileName = "test-case-prefix-"; // 替换为实际前缀

// 用async/await替代回调，避免嵌套
const download = await this.page.waitForEvent('download');
// 等待文件保存完成
await download.saveAs(`${testFolder}/${testCaseFileName}${download.suggestedFilename()}`);

// 使用异步文件API+for...of循环，确保逻辑顺序执行
const files = await fs.promises.readdir(testFolder);
for (const file of files) {
  if (file.includes("Summary") && file.endsWith(".xlsx")) {
    const filepath = `${testFolder}/${file}`;
    console.log("Summary Report generated successfully:", filepath);
    // 这里可添加文件后续处理逻辑
  }
}

关键修复说明 #

• 强制等待文件保存：await download.saveAs()确保文件完全写入磁盘后再执行读取操作，替代不可靠的固定时长等待。
• 异步文件读取+顺序循环：用fs.promises.readdir配合for...of循环，避免同步循环与异步回调的冲突，保证逻辑按预期执行。
• 变量有效性校验：提前确认testFolder、testCaseFileName的定义，必要时可添加目录存在性检查（如await fs.promises.mkdir(testFolder, { recursive: true })）。
• page.on('download')的正确用法（若需改用事件监听）：

// 必须在触发下载前注册监听
this.page.on('download', async (download) => {
  await download.saveAs(`${testFolder}/${testCaseFileName}${download.suggestedFilename()}`);
  const files = await fs.promises.readdir(testFolder);
  for (const file of files) {
    if (file.includes("Summary") && file.endsWith(".xlsx")) {
      console.log("Summary Report generated successfully:", `${testFolder}/${file}`);
    }
  }
});

// 触发下载操作（示例：点击下载按钮）
await this.page.click('#download-btn');

内容的提问来源于stack exchange，提问作者revathi jakkula