---
title: Puppeteer Jest Cloud Testing | TestingBot
description: Run Jest + Puppeteer tests in the TestingBot cloud on Chrome and Microsoft
  Edge. Use jest-puppeteer or puppeteer.connect() to run your existing Jest suite
  against a remote browser grid in parallel.
source_url:
  html: https://testingbot.com/support/web-automate/puppeteer/jest
  md: https://testingbot.com/support/web-automate/puppeteer/jest/index.md
---
# Puppeteer & Jest

Jest-Puppeteer allows you to run tests with Jest on browsers controlled with Puppeteer.

To get started, please install these packages:

    npm install --save-dev jest-puppeteer puppeteer jest

Next, specify these settings in your Jest configuration file (`jest.config.js`):

    module.exports = {
      rootDir: '.',
      testTimeout: 20000,
      testMatch: [
        '<rootDir>/*.spec.js'
      ],
      preset: 'jest-puppeteer'
    }

## Configure Jest with Puppeteer

To configure Jest Puppeteer, create a new file called `jest-puppeteer.config.js` and add this to the file:

    module.exports = {
      connect: {
        browserWSEndpoint: 'wss://cloud.testingbot.com?key=API_KEY&secret=API_SECRET&browserName=chrome&browserVersion=latest'
      }
    }

This instructs Jest and Puppeteer to connect to the TestingBot browser grid.

## Specifying browser and version

To specify on which browser and version your Jest + Puppeteer test should run, you can include both a `browserName` and `browserVersion` in the `browserWSEndpoint` URL.

  ![OS selected](https://testingbot.com/assets/environments/svg/windows11-0e1b28bc0fdd5034d3e4d3dc8d346c500a8c6522facf4b45d0da56537c1f1c6d.svg) Windows 11 › ![Browser selected](https://testingbot.com/assets/environments/svg/chrome-c4081ff447d2d898d4afcb8f074a907c960e6f007716c1a1d119eee6803c4042.svg) Chrome 139 

Loading environments...

Please wait while we load the available browsers and platforms.

    

## Run your first test

To create a test, create a new file called `sample.spec.js` and add this to the file:

    describe('Google', () => {
      beforeAll(async () => {
        await page.goto('https://google.com')
      })
    
      it('should display google text on page', async () => {
        await expect(page).toMatch('google')
      })
    })

Now you can run your first test with Puppeteer on the TestingBot cloud:

    jest

This will open Google in a Chrome browser and verify if the word 'google' is on the page.

You should see something like this in your terminal after running the command:

    PASS ./sample.spec.js (6.503s)
      Google
        ✓ should display google text on page (81ms)
    
    Test Suites: 1 passed, 1 total
    Tests: 1 passed, 1 total

This test will also appear in your [Member Dashboard](https://testingbot.com/members).

Was this page helpful? Yes No 

## Looking for More Help?

Have questions or need more information?   
 You can reach us via the following channels:

- [Email us](https://testingbot.com/contact/new)
- [Join our Slack Channel](https://join.slack.com/t/testingb0t/shared_invite/zt-3bcw9xch-jk19~6XPs_xBrsAgAedkCw)