在 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]);
完整可运行示例（修复后）：
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”类错误的关键原则。
