在 puppeteer 自动化脚本中，直接使用 browser.pages()[0] 获取首个页面对象常导致 typeerror: cannot read properties of undefined (reading ‘goto’) 错误——根本原因在于 browser.pages() 返回的是一个待解析的 promise，而非同步数组，未 await 就访问索引会导致取到 undefined。

问题根源：异步方法必须显式等待

browser.pages() 是一个异步方法，它返回一个 Promise，只有当浏览器完成初始化并加载所有已有标签页后，该 Promise 才会 resolve 为页面数组。若跳过 await 直接链式调用 [0]，等价于：

const pagesPromise = browser.pages(); // Promise
const page = pagesPromise[0]; // ❌ 错误！pagesPromise 是 Promise 对象，不是数组，pagesPromise[0] 是 undefined

此时 page 为 undefined，后续调用 page.goto(…) 自然抛出 TypeError。

正确写法（任选其一）

✅ 推荐：解构赋值 + await（语义清晰、简洁）

const [page] = await browser.pages(); // 等价于 const pages = await browser.pages(); const page = pages[0];
await page.goto('https://www.google.com/');
await page.goto('https://www.yahoo.com/');

✅ 显式 await + 索引访问（直观易懂）

const pages = await browser.pages();
const page = pages[0];
await page.goto('https://www.google.com/');
await page.goto('https://www.yahoo.com/');

✅ 链式 then（不推荐，降低可读性）

const page = await browser.pages().then(pages => pages[0]);

完整修复示例（对比原错误代码）

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()，再取第 0 个页面
  const [page] = await browser.pages();

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

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

注意事项与最佳实践

• ? browser.pages() 仅返回当前已打开的页面（如 Chrome 启动时默认空白页），不包含后续 browser.newPage() 创建的新页；因此在 launch() 后立即调用，通常只拿到 1 个初始页。
• ? 若需操作多个独立页面，优先使用 browser.newPage() 创建新上下文，避免共享状态干扰；
• ? 在 headless: false 模式下，可通过 page.title() 或 page.url() 验证当前页面是否成功跳转；
• ? 始终为 goto 添加 waitUntil 选项（如 ‘networkidle2’ 或 ‘domcontentloaded’），防止因页面未就绪而后续操作失败。

掌握 browser.pages() 的异步本质，是编写健壮 Puppeteer 脚本的关键一步——切记：所有 Puppeteer API 返回 Promise 的方法，都必须 await 或 .then() 处理，不可当作同步值直接索引或调用。

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