在 puppeteer 中，若直接使用 `browser.pages()[0]`（未 await）访问页面，会导致 `cannot read properties of undefined (reading ‘goto’)` 错误；正确做法是先 `await browser.pages()` 获取已解析的页面数组，再取索引元素。

Puppeteer 的 browser.pages() 方法返回的是一个 Promise，其解析结果为 Page[]（页面对象数组），而非同步可用的数组。因此，browser.pages()[0] 实际上是在对一个处于 pending 状态的 Promise 直接取下标 —— 这等价于 undefined[0]，最终导致后续调用 .goto() 时抛出 TypeError: Cannot read properties of undefined (reading ‘goto’)。

✅ 正确写法：必须先 await 解析 Promise，再访问数组元素。以下是三种推荐方式：

// 方式 1：显式 await + 索引访问（最清晰）
const pages = await browser.pages();
const page = pages[0];

// 方式 2：解构赋值（简洁且常用）
const [page] = await browser.pages();

// 方式 3：链式 then（不推荐，破坏 async/await 风格）
const page = await browser.pages().then(pages => pages[0]);

完整可运行示例（修复后）：

AVCLabs

AI移除视频背景，100%自动和免费

下载

const puppeteer = require('puppeteer-core');

(async () => {
  const browser = await puppeteer.launch({
    executablePath: 'C://Program Files//Google//Chrome//Application//chrome.exe',
    headless: false,
  });

  // ✅ 正确：先 await browser.pages()，再取第一页
  const [page] = await browser.pages(); // 或 const page = (await browser.pages())[0];

  const urls = ['https://www.google.com/', 'https://www.yahoo.com/'];
  for (const url of urls) {
    await page.goto(url, { waitUntil: 'networkidle2' });
    console.log(`Navigated to ${url}`);
    await page.waitForTimeout(1500); // 可选：便于观察
  }

  await browser.close();
})();

⚠️ 注意事项：

• 浏览器启动后默认会创建一个空白标签页（about:blank），browser.pages()[0] 即指向该页，它完全可用于 goto，无需额外 newPage()；
• 若在 launch() 后立即调用 browser.pages()，有时可能因页面初始化延迟而返回空数组（尤其在极快执行场景下）。为增强健壮性，可添加简单等待逻辑：

  let pages;
  while ((pages = await browser.pages()).length === 0) {
    await new Promise(resolve => setTimeout(resolve, 100));
  }
  const [page] = pages;

• browser.newPage() 创建新标签页是安全且常用的方式，适用于需要隔离上下文的场景；但若仅需复用初始页，优先使用 await browser.pages() 获取，更轻量、资源占用更低。

总结：Puppeteer 中所有返回 Promise 的方法（如 pages()、targets()、cookies() 等）都必须显式 await 或 .then() 处理，切勿假设其返回值可直接同步访问 —— 这是避免“undefined is not a function”类错误的关键原则。

https://www.php.cn/faq/2038484.html