如何在Puppeteer中启用headless: true时下载文件？

这个问题在早期Puppeteer + Chromium的组合里很常见，核心原因是Headless模式下的Chromium不会自动沿用系统默认的下载配置，而普通模式（headless: false）会继承你macOS的下载路径和行为设置。

具体原因 #

你用的Puppeteer 1.1.1对应的Chromium 66.0.3347.0，在Headless模式下：

• 默认不会自动将文件保存到系统默认下载目录（/Users/user/Downloads）
• 默认没有启用自动下载的权限，需要手动配置下载行为

解决步骤 #

你需要在启动浏览器时明确配置下载路径，并允许下载行为，以下是完整的修复代码示例：

const puppeteer = require('puppeteer');
const path = require('path');

(async () => {
  // 定义你的下载路径
  const downloadDir = '/Users/user/Downloads';

  const browser = await puppeteer.launch({
    headless: true,
    args: [
      '--disable-gpu', // Headless模式必备的参数，避免GPU相关报错
      '--no-sandbox',  // macOS下通常不需要，但部分环境可能需要，加上更稳妥
    ],
    acceptDownloads: true, // 明确允许下载操作
  });

  const page = await browser.newPage();

  // 关键：通过Chrome DevTools API设置下载行为
  await page._client.send('Page.setDownloadBehavior', {
    behavior: 'allow', // 允许下载
    downloadPath: downloadDir // 指定下载路径
  });

  // 访问目标页面
  await page.goto('http://niftyindices.com/resources/holiday-calendar');

  // 替换成实际的CSV下载按钮选择器（需要你自己确认页面上的按钮选择器）
  // 比如如果按钮是带有特定class的<a>标签，就用对应的选择器
  await page.click('a[href*="holiday-calendar"]');

  // 等待下载完成：这里用简单的延时，也可以用更可靠的下载事件监听
  // 推荐用下载事件监听（如果你的Puppeteer版本支持）：
  page.on('download', async (downloadItem) => {
    const fileName = downloadItem.suggestedFilename();
    await downloadItem.saveAs(path.join(downloadDir, fileName));
    console.log(`文件已保存至：${path.join(downloadDir, fileName)}`);
  });

  // 等待足够时间确保下载完成，或者监听下载事件后再关闭浏览器
  await page.waitForTimeout(6000);

  await browser.close();
})();

额外注意事项 #

1. 选择器正确性：你需要确认页面上下载CSV按钮的正确选择器，可以通过Chrome开发者工具的"检查元素"功能获取。
2. 版本适配：Page.setDownloadBehavior API在Chrome 64+就已经支持，你用的Chromium 66完全兼容；acceptDownloads选项在Puppeteer 1.0+也已经存在，所以你的版本没问题。
3. 权限问题：确保/Users/user/Downloads目录有足够的读写权限，避免文件保存失败。

内容的提问来源于stack exchange，提问作者Antonio Gomez Alvarado