Solution to "Navigation Timeout Exceeded" Error in Puppeteer

The "Navigation Timeout Exceeded" error occurs when Puppeteer is unable to complete a page navigation within the specified timeout period. This usually happens when the page takes too long to load or the network conditions are poor.


  • Slow network connection or high latency.
  • Heavy page content or resources causing prolonged loading times.
  • Unexpected behavior or errors in the page's JavaScript code.
  • Insufficient timeout value provided to Puppeteer.

To fix the "Navigation Timeout Exceeded" error, you can try the following solutions:

1. Increase the Navigation Timeout:

You can increase the timeout value provided to Puppeteer to allow more time for the page to load:

    const browser = await puppeteer.launch();
    const page = await browser.newPage();
    // Set the navigation timeout to 60 seconds (60000 milliseconds)
    await page.setDefaultNavigationTimeout(60000);

2. Optimize Page Loading:

Optimize your web page to reduce loading times by minimizing resources, optimizing images, and reducing unnecessary JavaScript execution.

3. Handle Errors and Retry:

Implement error handling and retry mechanisms to deal with intermittent network issues or unexpected errors during page navigation:

    try {
      await page.goto('https://test.com');
    } catch (error) {
      console.error('Error during page navigation:', error);
      // Retry navigation
      await page.goto('https://test.com');


My Perspective on Using page.waitForNavigation()

When working with Puppeteer, we often need to wait for page navigation to complete before proceeding with our automation tasks. To achieve this, we can use the page.waitForNavigation() method, which allows us to pause execution until the page finishes navigating.

This method expects an object with properties to customize its behavior. For instance, we can set a timeout for how long we're willing to wait for navigation to complete. Here's an example:

    // Set a timeout of 10 minutes (600000 milliseconds)
    await page.waitForNavigation({ timeout: 600000 });

If we don't specify a timeout, the default value of 30 seconds (30000 milliseconds) is used. However, we can adjust this default value globally using the page.setDefaultNavigationTimeout() method.

Changing the default navigation timeout can be helpful in scenarios where pages might take longer to load due to various reasons such as slow network connections, heavy content, or complex JavaScript execution.