How to Change Timeout Settings in Playwright

Playwright offers a variety of timeout configurations for different operations. The standard timeout for each test is set to 30 seconds, and for each assertion, it's 5 seconds.

Encountering errors like the ones below could indicate that your timeout settings may require adjustments:

example.spec.ts:3:1 › sample test ===========================

Timeout of 30000ms exceeded.

example.spec.ts:3:1 › sample test ===========================

Error: expect(received).toHaveText(expected)

Expected string: "my text"
Received string: ""
Call log:
  - expect.toHaveText with timeout 5000ms
  - waiting for "locator('button')"

To alter the default global timeout for all tests, do the following:

import { defineConfig } from '@playwright/test';

export default defineConfig({
  timeout: 60 * 1000, // 60 seconds
});

Similarly, to modify the default global timeout for expect assertions, use this approach:

import { defineConfig } from '@playwright/test';

export default defineConfig({
  expect: {
    timeout: 10 * 1000, // 10 seconds
  },
});

For adjusting the timeout of a single test, apply the following methods:

import { test, expect } from '@playwright/test';

test('slow test', async ({ page }) => {
  // Triples the test timeout (90 seconds by default)
  test.slow();
});

test('really slow test', async ({ page }) => {
  // set timeout to 120 seconds
  test.setTimeout(120 * 1000);
});

Likewise, you can change the timeout for a specific assertion like this:

import { test, expect } from '@playwright/test';

test('basic test', async ({ page }) => {
  await expect(page.getByRole('button')).toHaveText('Sign in', {
    timeout: 10000,
  });
});

Playwright also allows for customization of timeout settings for actions, navigation, test hooks, and the overall test suite. Comprehensive details can be found in the test timeout documentation.

Thanks for reading, and happy coding!

Got an article suggestion? Let us know

Explore more

How to Check an Element's Value in Playwright

Checking or asserting on the value of any element is straightforward in Playwright

Questions

How to Get an Element's Attribute in Playwright

Retrieving attributes on web page elements is really straightforward through the `getAttribute()` method

Questions

How to Get the Current Page URL in Playwright

Retrieving the current page's URL is straightforward in Playwright using `page.url()`

Questions

How to Pause Tests in Playwright

Manually pausing Playwright tests is only recommended when troubleshooting a test. Here's how to do with with the `waitForTimeout()` method

Questions

This work is licensed under a Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License.