Timeouts

There are different kinds of timeouts you will encounter while working with Browser checks:

Checkly runs your Browser check code for a maximum of 240 seconds. Tests that exceed this time will be capped and time out. Everything in your Browser Check needs to happen within those 240 seconds, no matter what.

Playwright does offer multiple configurable timeouts. Make sure you configure these in a way that prevents your check from hitting the general 240 seconds timeout.

Timeout-related errors are often a sticking point for many beginners. Understanding which timeout is being raised and which command or config option it corresponds to can save you plenty of time when debugging a failing script. Here we try to explain the most common timeout errors.

This refers to Playwright’s own 30s default timeout for a single test fixture. While it is best to keep your checks as short as possible, you can increase a test’s timeout using test.setTimeout(milliseconds). For example:

import { test } from '@playwright/test'

test('add item to wishlist', async ({ page }) => {
  test.setTimeout(60000)

  // rest of your script

})

const { test } = require('@playwright/test')

test('add item to wishlist', async ({ page }) => {
  test.setTimeout(60000)

  // rest of your script

})

In this case, your script is hitting Checkly’s 240s total Browser check timeout. This can’t be configured and is in place to prevent checks from running way longer than acceptable. No assets will be available for review after the check has gone over the maximum run time. If you encounter this, try to make your check shorter by following best practices. Additionally, to ensure your assets are saved, please set a test timeout lower than the browser check execution timeout.

Different actions, such as clicks, explicit waits and so on, can have their own timeout. In these cases, Playwright will always state what kind of action caused the timeout just before this message. For example, you might see an error like: page.waitForLoadState: Timeout 20000ms exceeded. In that case, looking at the page.waitForLoadState commands in your script will help you find the culprit.

Monitoring a scenario with multiple tabs Tracing and Web Vitals

Last updated on June 16, 2025. You can contribute to this documentation by editing this page on Github