Timed out after {value} ms while waiting for the WS endpoint URL to appear in stdout!

How to fix the Puppeteer error: Timed out after {value} ms while waiting for the WS endpoint URL to appear in stdout!


Error

Timed out after ${timeout} ms while waiting for the WS endpoint URL to appear in stdout!

What it means

Puppeteer raised this from its browser launch 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("Timed out after ")) {
    // Apply the fix above, then retry or fail with a clearer message.
  }
  throw error;
}

Keep Reading

Puppeteer Guides

All Guides →