Puppeteer如何配置waitUntil超时后不抛错 继续使用已加载页面

Puppeteer 原生没有提供「超时不抛错、直接返回已加载内容」的配置项，但完全不需要重新调用page.goto重复发起请求，靠简单的错误捕获就能实现需求：waitUntil判定超时抛错时，已经加载完成的DOM、已返回的响应资源都不会被销毁，仍然绑定在当前page实例上可以直接读取。

具体实现 #

基础兜底写法 #

用try/catch包裹goto逻辑，捕获到超时错误时，直接从当前页面主框架取已加载的响应对象即可：

let response;
try {
  response = await page.goto(url, { waitUntil: "networkidle2", timeout: 10000 });
} catch (err) {
  // 只兜底处理超时错误，其余错误正常抛出
  if (err.name === 'TimeoutError') {
    response = await page.mainFrame().response();
  } else {
    throw err;
  }
}

// 后续逻辑正常执行，既可以用response拿响应信息，也可以直接操作page取页面内容
const pageHtml = await page.content();

这里拿到的response和goto正常返回的对象是同一个类型，状态码、响应头、响应体这些属性都能正常读取。

封装通用方法 #

如果项目里多处用到这个逻辑，可以封装成通用函数，不用每次重复写try/catch：

async function gotoWithTimeoutFallback(page, url, options = {}) {
  try {
    return await page.goto(url, options);
  } catch (err) {
    if (err.name === 'TimeoutError') {
      return page.mainFrame().response();
    }
    throw err;
  }
}

// 调用方式和原生page.goto完全一致
const response = await gotoWithTimeoutFallback(page, url, {
  waitUntil: "networkidle2",
  timeout: 10000
});

补充说明 #

• 大部分场景下触发networkidle2超时，都是页面存在个别慢资源、埋点请求、长连接一直没结束，主文档HTML早就加载完成，这时候拿到的内容完全能满足后续解析、DOM交互的需求。
• 极端情况下如果超时发生在主文档还没返回首字节的阶段，page.mainFrame().response()会返回null，可以根据业务需求加层非空判断，决定是重试还是抛错。
• 这种处理方式不会额外发起网络请求，没有多余性能损耗，是目前处理这类加载超时问题的通用做法。

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