Jest Puppeteer provides all required configuration to run your tests using Puppeteer.

    • First install jest-puppeteer

    yarn add —dev jest-puppeteer

    • Specify preset in your Jest configuration:
    • Write your test
    1. describe('Google', () => {
    2.   beforeAll(async () => {
    3.     await page.goto('https://google.com');
    4.   });
    6.   it('should be titled "Google"', async () => {
    7.     await expect(page.title()).resolves.toMatch('Google');
    8.   });
    9. });

    See .

    Custom example without jest-puppeteer preset

    You can also hook up puppeteer from scratch. The basic idea is to:

    • launch & file the websocket endpoint of puppeteer with Global Setup
    • connect to puppeteer from each Test Environment
    • close puppeteer with Global TeardownHere's an example of the GlobalSetup script

    Then we need a custom Test Environment for puppeteer

    1. // puppeteer_environment.js
    2. const NodeEnvironment = require('jest-environment-node');
    3. const fs = require('fs');
    4. const path = require('path');
    5. const puppeteer = require('puppeteer');
    6. const os = require('os');
    10.   constructor(config) {
    11.     super(config);
    12.   }
    14.   async setup() {
    15.     await super.setup();
    16.     // get the wsEndpoint
    17.     const wsEndpoint = fs.readFileSync(path.join(DIR, 'wsEndpoint'), 'utf8');
    18.     if (!wsEndpoint) {
    19.       throw new Error('wsEndpoint not found');
    20.     }
    22.     // connect to puppeteer
    23.     this.global.__BROWSER__ = await puppeteer.connect({
    24.       browserWSEndpoint: wsEndpoint,
    25.     });
    26.   }
    28.   async teardown() {
    29.     await super.teardown();
    30.   }
    31.   runScript(script) {
    33.   }
    34. }

    With all the things set up, we can now write our tests like this:

    1. // test.js
    2. const timeout = 5000;
    4. describe(
    5.   '/ (Home Page)',
    6.   () => {
    7.     let page;
    8.     beforeAll(async () => {
    9.       page = await global.__BROWSER__.newPage();
    10.       await page.goto('https://google.com');
    11.     }, timeout);
    13.     it('should load without error', async () => {
    14.       const text = await page.evaluate(() => document.body.textContent);
    15.       expect(text).toContain('google');
    16.     });
    17.   },
    18.   timeout,
    19. );

    Finally, set jest.config.js to read from these files. (The jest-puppeteer preset does something like this under the hood.)

    Here's the code of .