Puppeteer中是否需添加error/pageerror监听器？try/catch足够吗？

一、try/catch与事件监听器的捕获范围差异 #

• try/catch（async/await流程内）：仅能捕获Node.js层面Puppeteer API调用的错误，比如page.goto请求失败、browser.launch启动失败、page.screenshot路径错误等。这类错误属于async/await调用链中的Promise拒绝，会被外围try/catch直接捕获。
• page.on('error')：捕获页面进程崩溃级别的错误，比如浏览器页面渲染引擎崩溃、页面代码触发V8引擎崩溃等。这类错误脱离Node.js的async/await调用流程，try/catch无法捕获。
• page.on('pageerror')：捕获浏览器页面上下文内的未捕获JavaScript错误，比如页面脚本里的throw new Error()、未处理的DOM异常等。这些错误发生在浏览器环境中，和Node.js的async/await流程无关，同样无法被try/catch捕获。

二、代码片段2出现uncaughtException的原因 #

用Promise包装流程并在监听器中调用reject的思路方向没错，但问题出在Promise只能被决议一次：

• 如果页面完成goto、screenshot、browser.close后已经调用了resolve，后续触发的error或pageerror事件再调用reject，会导致Promise出现未处理的拒绝，进而抛出uncaughtException。
• 若监听器绑定前就发生错误（概率极低但存在可能），也会导致错误无法被捕获。

三、正确的统一错误处理方案 #

要避免uncaughtException并统一处理所有错误，核心是确保所有事件触发的错误都能纳入统一处理流程，同时避免重复决议Promise。以下是可行实现：

(async () => {
  let browser;
  let page;
  // 标记错误是否已处理，避免重复操作
  let isHandled = false;

  const handleError = async (error) => {
    if (isHandled) return;
    isHandled = true;
    console.error('统一错误捕获:', error);
    // 确保浏览器被关闭，避免资源泄漏
    await browser?.close();
    throw error;
  };

  try {
    browser = await puppeteer.launch({ headless: true, args: ['--no-sandbox'] });
    page = await browser.newPage();

    // 绑定页面进程崩溃错误监听
    page.on('error', handleError);
    // 绑定页面内部JS错误监听
    page.on('pageerror', handleError);
    // 绑定浏览器断开连接监听（比如浏览器意外崩溃）
    browser.on('disconnected', () => handleError(new Error('浏览器已断开连接')));

    // 正常业务流程
    await page.goto('https://www.example.com');
    await page.screenshot({ path: './tmp/example.png' });
    
    isHandled = true;
    await browser.close();
  } catch (err) {
    console.error('最终错误处理:', err);
    // 兜底关闭浏览器
    await browser?.close();
  }
})();

方案说明 #

1. 统一错误处理函数：用handleError封装错误处理逻辑，通过isHandled标记确保同一错误只被处理一次，避免重复代码。
2. 覆盖所有错误场景：除page.error和page.pageerror外，添加browser.disconnected监听，覆盖浏览器意外崩溃的情况。
3. 资源清理：无论哪种错误，都确保浏览器被关闭，避免内存泄漏。
4. 错误冒泡：在handleError中抛出错误，让外围try/catch统一捕获，实现全流程错误的集中处理。

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