Electron中如何隐藏Puppeteer触发下载时弹出的空白新窗口？

方法1：拦截new-window事件（最直接有效） #

在Electron主进程中，给目标BrowserWindow实例监听new-window事件，直接阻止默认的新窗口创建行为，同时手动触发下载逻辑：

// 主进程代码
const { BrowserWindow } = require('electron');

const mainWindow = new BrowserWindow({ /* 你的窗口配置项 */ });

mainWindow.webContents.on('new-window', (event, url) => {
  // 直接阻止新窗口创建
  event.preventDefault();
  
  // 判断是否为下载链接，匹配你需要的文件后缀
  if (url.match(/\.(pdf|docx|xlsx|zip)$/)) {
    // 在当前窗口发起下载请求
    mainWindow.webContents.downloadURL(url);
  }
});

核心是通过event.preventDefault()掐断新窗口的创建流程，改用当前窗口的下载能力处理请求，彻底避免空白窗口弹出。

方法2：在页面上下文重写下载触发函数 #

如果页面中的downloadCourseDocs是前端自定义函数，可通过Puppeteer重写该函数，让它直接触发下载而非打开新标签：

// Puppeteer控制页面的代码
await page.evaluate(() => {
  // 重写原下载函数
  window.downloadCourseDocs = function(/* 原函数的参数列表 */) {
    // 还原原函数的下载地址生成逻辑，拿到真实下载链接
    const downloadUrl = /* 根据原函数逻辑拼接出正确的下载URL */;
    // 用隐藏a标签触发下载
    const link = document.createElement('a');
    link.href = downloadUrl;
    link.download = '';
    document.body.appendChild(link);
    link.click();
    document.body.removeChild(link);
  };
});

这样模拟点击按钮时，调用的是我们重写后的函数，不会触发新窗口逻辑。

方法3：Puppeteer启动参数优化（辅助增强） #

启动Puppeteer时添加弹窗拦截相关参数，配合前两种方法使用：

const browser = await puppeteer.launch({
  args: [
    '--disable-popup-blocking=false', // 启用弹窗拦截
    '--no-default-browser-check',
    '--disable-extensions'
  ],
  defaultViewport: null
});

内容的提问来源于stack exchange，提问作者Adnan Zaki