如何解决Puppeteer中page.waitForTimeout方法已弃用的问题

针对Puppeteer v21.1.1里page.waitForTimeout被弃用的问题，给你几个实用替代方案：

1. 原生Promise封装setTimeout #

这是最通用的纯JS/TS实现，不依赖Puppeteer API，逻辑直观：

// 封装成可复用的等待函数
const wait = (ms: number): Promise<void> => new Promise(resolve => setTimeout(resolve, ms));

// 使用时直接调用
await wait(3000);

2. 使用Puppeteer的page.waitForFunction #

如果想继续用Puppeteer提供的API，可以用waitForFunction搭配固定超时实现延迟：

// 传入始终为true的条件，仅靠timeout控制等待时长
await page.waitForFunction('true', { timeout: 3000 });

3. 更优的页面等待方式（推荐） #

官方弃用waitForTimeout的核心原因是固定延迟不是可靠的页面等待方案，实际爬取中更建议根据页面状态等待：

• 等待目标元素出现：

// 等待id为target-element的元素加载完成，超时时间设为5000ms
await page.waitForSelector('#target-element', { timeout: 5000 });

• 等待页面导航完成：

// 等待页面DOM加载完成，可选值还有'load'、'networkidle0'等
await page.waitForNavigation({ waitUntil: 'domcontentloaded' });

这些方式能让你的爬取脚本更稳定，避免因页面加载慢导致的抓取失败，同时减少不必要的等待时间。

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