Timeout cleared
How to fix the Puppeteer error: Timeout cleared
Error
Timeout cleared
What it means
Puppeteer raised this from its Puppeteer runtime code. In practice, it usually means your script reached a browser, page, frame, element, or option state that the API cannot use safely.
How to fix it
- Increase the relevant timeout only after checking why the condition never completes.
- Use a less strict wait condition such as
domcontentloaded, or wait for a specific selector/response instead of generic network idle. - Add retries around navigation or waits that depend on remote services.
Minimal guard
try {
// Run the Puppeteer operation that triggers this error.
} catch (error) {
if (error instanceof Error && error.message.includes("Timeout cleared")) {
// Apply the fix above, then retry or fail with a clearer message.
}
throw error;
}