如何在Puppeteer（Node.js、Alpine Linux）中禁用xdg-open弹窗

以下是几个可行的解决方案，针对你在node:18-alpine容器里遇到的Chromium触发xdg-open弹窗中断自动化的问题：

1. 替换xdg-open为无操作脚本 #

卸载xdg-utils无效的原因是Chromium仍会尝试调用xdg-open命令，直接替换这个命令为一个空脚本就能阻止弹窗触发。在你的Dockerfile中添加以下指令：

RUN echo -e '#!/bin/sh\nexit 0' > /usr/bin/xdg-open && chmod +x /usr/bin/xdg-open

这个脚本会让xdg-open调用后直接退出，不会执行任何打开外部应用的操作。

2. 配置Chromium的外部协议处理偏好 #

通过Chromium的偏好设置，直接排除触发弹窗的外部协议，让浏览器不再处理这类请求。在Puppeteer的启动配置中添加prefs参数：

const browser = await puppeteer.launch({
  args: ['--no-sandbox', '--disable-dev-shm-usage'],
  prefs: {
    'protocol_handler': {
      'excluded_schemes': {
        // 添加所有会触发弹窗的协议，比如mailto、tel或自定义协议
        'mailto': true,
        'tel': true,
        'custom-protocol': true
      }
    }
  }
});

如果不确定具体是哪些协议触发的弹窗，可以先开启Chromium的日志输出，查看它尝试处理的协议类型，再添加到排除列表中。

3. 拦截外部协议请求 #

使用Puppeteer的请求拦截功能，直接中止所有非HTTP/HTTPS协议的请求，从根源上阻止Chromium调用外部应用：

await page.setRequestInterception(true);
page.on('request', (req) => {
  const url = req.url();
  // 只允许HTTP/HTTPS请求通过
  if (url.startsWith('http://') || url.startsWith('https://')) {
    req.continue();
  } else {
    req.abort();
  }
});

这种方法可以全面拦截所有外部协议请求，适合不确定具体协议类型的场景。

内容的提问来源于stack exchange，提问作者Léo Bournizien