在 puppeteer 自动化脚本中，直接使用 browser.pages()[0] 获取首个页面对象常导致 typeerror: cannot read properties of undefined (reading 'goto') 错误——根本原因在于 browser.pages() 返回的是一个待解析的 promise，而非同步数组，未 await 就访问索引会导致取到 undefined。
问题根源：异步方法必须显式等待
browser.pages() 是一个
异步方法
，它返回一个 Promise，只有当
浏览器
完成初始化并加载所有已有标签页后，该 Promise 才会 resolve 为页面数组。若跳过 await 直接链式调用 [0]，等价于：
此时 page 为 undefined，后续调用 page.goto(...) 自然抛出 TypeError。
正确写法（任选其一）
✅
推荐：解构赋值 + await（语义清晰、简洁）
✅
显式 await + 索引访问（直观易懂）
Google Antigravity
谷歌推出的AI原生IDE，AI智能体协作开发
下载
✅
链式 then（不推荐，降低可读性）
完整修复示例（对比原错误代码）
注意事项与最佳实践
? 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() 处理，不可当作同步值直接索引或调用。
const pagesPromise = browser.pages(); // Promise
const page = pagesPromise[0]; // ❌ 错误！pagesPromise 是 Promise 对象，不是数组，pagesPromise[0] 是 undefined 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/');const pages = await browser.pages();
const page = pages[0];
await page.goto('https://www.google.com/');
await page.goto('https://www.yahoo.com/');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();
})();