Node.js用Puppeteer获取渲染后HTML失败，参数报错求解决

1. 修复waitUntil参数错误 #

Puppeteer的waitUntil选项不存在networkidle这个取值，正确的可选参数是networkidle0或networkidle2：

• networkidle0：等待网络连接数归零并持续至少500毫秒
• networkidle2：等待网络连接数降至2个以内并持续至少500毫秒

修正后的基础代码：

const browser = await puppeteer.launch()
const page = await browser.newPage()
await page.goto(url, { waitUntil: 'networkidle2' })
const HTML = await page.content()
await browser.close()

2. 确保动态内容完全渲染 #

如果修正参数后仍存在{{Title}}这类占位符，说明页面依赖前端框架（如Vue、React）动态渲染内容，仅等待网络空闲不够，需要针对性等待：

方法一：等待目标元素加载完成 #

假设你要提取的标题对应的CSS选择器是.article-title，可以用waitForSelector等待元素可见：

const browser = await puppeteer.launch()
const page = await browser.newPage()
await page.goto(url, { waitUntil: 'networkidle2' })
// 等待目标元素可见，确认内容已渲染
await page.waitForSelector('.article-title', { visible: true })
const HTML = await page.content()
await browser.close()

方法二：设置固定等待时长（兜底方案） #

如果不确定目标元素的选择器，可设置固定等待时间给页面足够渲染时间（时长按需调整）：

const browser = await puppeteer.launch()
const page = await browser.newPage()
await page.goto(url, { waitUntil: 'networkidle2' })
// 等待2秒，确保动态内容渲染完成
await page.waitForTimeout(2000)
const HTML = await page.content()
await browser.close()

方法三：监听页面渲染完成事件 #

部分页面会在内容渲染完成后触发自定义事件，可监听这类事件（需根据页面实际逻辑调整事件名）：

const browser = await puppeteer.launch()
const page = await browser.newPage()
await page.goto(url, { waitUntil: 'load' })
// 等待页面自定义的渲染完成事件
await page.waitForEvent('content-ready')
const HTML = await page.content()
await browser.close()

3. 额外排查方向 #

• 检查目标站点是否需要登录、验证，或者有反爬策略导致内容无法正常渲染
• 确认页面JavaScript已启用（Puppeteer默认启用，可通过page.setJavaScriptEnabled(true)手动确保）
• 如果内容是懒加载，需要模拟页面滚动触发加载：

  await page.evaluate(() => {
    window.scrollTo(0, document.body.scrollHeight);
  })
  

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