Node.js接口调用中Puppeteer page.evaluate无响应并报错问题

错误原因分析 #

• 你将Express的res对象传入page.evaluate，但res包含循环引用结构（如Socket与HTTPParser的互相引用），Puppeteer需要把参数序列化为JSON传递给浏览器上下文，循环结构无法被JSON.stringify处理，因此抛出TypeError: Converting circular structure to JSON错误。
• 另外，page.evaluate的回调函数运行在浏览器沙箱环境中，无法访问Node.js环境的res对象，也不能直接调用res.status()这类Node端方法。

解决方案 #

1. 修正page.evaluate的使用逻辑 #

禁止将Node端对象传入浏览器上下文，改为让page.evaluate返回注册操作的结果（成功/失败状态），再在Node端处理响应。

2. 不使用async/await的实现方式 #

若不想用async语法，可通过Promise链式调用处理page.evaluate的异步结果：

app.get("/api/register", function (req, res) {
  page.evaluate(() => {
    // 浏览器上下文执行注册操作，返回Promise
    return webex.meetings
      .register()
      .then(() => {
        console.log("Authentication#register() :: successfully registered");
        return { success: true, message: "Successfully Registered" };
      })
      .catch((error) => {
        console.error("Authentication#register() :: error registering", error);
        return { success: false, message: "Registration Failed" };
      });
  })
  .then(result => {
    // Node端处理Express响应
    result.success 
      ? res.status(200).json(result) 
      : res.status(400).json(result);
  })
  .catch(puppeteerError => {
    // 处理Puppeteer自身的执行错误
    console.error("Puppeteer execution error:", puppeteerError);
    res.status(500).json({ message: "Internal Server Error" });
  });
});

关键注意点 #

• page.evaluate内部代码仅能访问浏览器环境变量（比如webex需是页面中已加载的对象），无法直接调用Node.js API。
• 必须通过page.evaluate的返回值，将浏览器中的操作结果传递回Node端，再处理Express响应。
• 即便不用async/await，也需通过Promise链式调用处理异步流程——因为page.evaluate本身返回Promise对象。

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