puppeteer/test
2023-09-04 14:06:23 +02:00
..
assets fix: make page.goBack work with bfcache in tab mode (#10818) 2023-08-30 14:28:07 +00:00
fixtures chore: use strict typing in tests (#8524) 2022-06-15 12:09:22 +02:00
golden-chrome feat: roll to Chrome 115.0.5790.98 (r1148114) (#10584) 2023-07-19 08:11:45 +00:00
golden-firefox chore: add missing golden asset for firefox (#9171) 2022-10-27 09:33:38 +00:00
installation chore: update dependencies (#10835) 2023-09-03 13:16:51 +02:00
src chore: more BiDi Connection test to unit (#10839) 2023-09-04 14:06:23 +02:00
.eslintrc.js chore: update Prettier and other deps (#10555) 2023-07-17 10:52:54 +02:00
package.json chore: use git clean (#10828) 2023-08-31 16:58:31 +02:00
README.md ci: remove before hooks (#10431) 2023-06-21 19:41:09 +00:00
TestExpectations.json chore: use bindIsolatedHandle (#10810) 2023-09-01 15:13:29 +00:00
TestSuites.json chore: allow enabling the tab target for testing (#10790) 2023-08-28 08:53:22 +00:00
tsconfig.json chore: update dependencies (#10785) 2023-08-28 13:01:52 +02:00

Puppeteer tests

Unit tests in Puppeteer are written using Mocha as the test runner and Expect as the assertions library.

Test state

We have some common setup that runs before each test and is defined in mocha-utils.js.

You can use the getTestState function to read state. It exposes the following that you can use in your tests. These will be reset/tidied between tests automatically for you:

  • puppeteer: an instance of the Puppeteer library. This is exactly what you'd get if you ran require('puppeteer').
  • puppeteerPath: the path to the root source file for Puppeteer.
  • defaultBrowserOptions: the default options the Puppeteer browser is launched from in test mode, so tests can use them and override if required.
  • server: a dummy test server instance (see packages/testserver for more).
  • httpsServer: a dummy test server HTTPS instance (see packages/testserver for more).
  • isFirefox: true if running in Firefox.
  • isChrome: true if running Chromium.
  • isHeadless: true if the test is in headless mode.

If your test needs a browser instance, you can use the setupTestBrowserHooks() function which will automatically configure a browser that will be cleaned between each test suite run. You access this via getTestState().

If your test needs a Puppeteer page and context, you can use the setupTestPageAndContextHooks() function which will configure these. You can access page and context from getTestState() once you have done this.

The best place to look is an existing test to see how they use the helpers.

Skipping tests in specific conditions

To skip tests edit the TestExpectations file. See test runner documentation for more details.

Running tests

  • To run all tests applicable for your platform:
npm test
  • Important: don't forget to first build the code if you're testing local changes:
npm run build --workspace=@puppeteer-test/test && npm test

CLI options

Description Option Type
Do not generate coverage report --no-coverage boolean
Do not generate suggestion for updating TestExpectation.json file --no-suggestions boolean
Specify a file to which to save run data --save-stats-to string
Specify a file with a custom Mocha reporter --reporter string
Number of times to retry failed tests. --retries number
Timeout threshold value. --timeout number
Tell Mocha to not run test files in parallel --no-parallel boolean
Generate full stacktrace upon failure --fullTrace boolean
Name of the Test suit defined in TestSuites.json --test-suite string

Helpful information

  • To run a specific test, substitute the it with it.only:
  ...
  it.only('should work', async function() {
    const {server, page} = await getTestState();
    const response = await page.goto(server.EMPTY_PAGE);
    expect(response.ok).toBe(true);
  });
  • To disable a specific test, substitute the it with it.skip:
  ...
  it.skip('should work', async function({server, page}) {
    const {server, page} = await getTestState();
    const response = await page.goto(server.EMPTY_PAGE);
    expect(response.ok).toBe(true);
  });
  • To run Chrome headful tests:
npm run test:chrome:headful
  • To run tests with custom browser executable:
BINARY=<path-to-executable> npm run test:chrome:headless # Or npm run test:firefox