Puppeteer中iframe无法加载：waitForSelector后代码停滞问题

你代码卡在waitForSelector后不执行的核心原因是：你拿到外层iframe的元素句柄后，调用waitForSelector('iframe')是在当前iframe内部查找嵌套的子iframe。如果页面里没有这种嵌套结构，这行代码会一直等待超时，自然走不到后续的console.log(1)。

要正确加载目标iframe并在其中执行JavaScript，需要先获取iframe的上下文（frame对象），而非在元素句柄上错误查找子iframe，具体步骤和修正代码如下：

修正后的代码示例 #

// 获取目标iframe的元素句柄（如果有多个iframe，建议用更精准的选择器，比如加id/class）
const iframeElementHandle = await page.$('iframe');
// 从元素句柄获取对应的frame上下文对象
const targetFrame = await iframeElementHandle.contentFrame();
// 等待iframe加载完成（可选，但能确保内容已就绪）
await targetFrame.waitForLoadState();

// 现在可以在iframe内执行操作：比如等待元素、运行自定义JS
await targetFrame.waitForSelector('你需要定位的元素选择器');
console.log('iframe已加载，可执行后续逻辑');

// 在iframe中运行自定义JavaScript示例
const iframeContentResult = await targetFrame.evaluate(() => {
    // 这里写你要在iframe环境中执行的代码
    return document.body.innerText.slice(0, 50);
});
console.log('iframe内截取的内容:', iframeContentResult);

额外注意事项 #

• 若页面存在多个iframe，务必用精准选择器（如iframe#target-iframe、iframe.class-name）定位目标，避免获取错误的iframe
• 如果目标iframe是跨域的，出于浏览器安全限制，Puppeteer无法获取其内容或执行JS，这种情况没有绕过方案

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