---
title: CodeceptJS Puppeteer Cloud Testing | TestingBot
description: Run Puppeteer tests with CodeceptJS in the cloud with TestingBot. Blazing
  fast testing with Puppeteer using the Chrome DevTools protocol.
source_url:
  html: https://testingbot.com/support/web-automate/puppeteer/codeceptjs
  md: https://testingbot.com/support/web-automate/puppeteer/codeceptjs/index.md
---
# CodeceptJS & Puppeteer

CodeceptJS is an end-to-end testing framework which provides support for many automation drivers, including Puppeteer.

To get started, please install these packages:

    npm install codeceptjs puppeteer --save

To create a sample project from scratch, you can use this command:

    npx codeceptjs init

## Configure CodeceptJS with Puppeteer

To configure CodeceptJS, please edit `codecept.conf.js` and make sure to add the `Puppeteer` helper.

    { // ..
      helpers: {
        Puppeteer: {
          url: "http://localhost",
          show: true,
          windowSize: '1200x900',
          chrome: {
            browserWSEndpoint: "wss://cloud.testingbot.com?key=API_KEY&secret=API_SECRET"
          }
        }
      }
      // ..
    }

The `browserWSEndpoint` URL instructs CodeceptJS to use TestingBot's Puppeteer grid to run the tests on.

## Specifying browser and version

To specify on which browser and version your CodeceptJS + 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

Let's create our first test, which will open the TestingBot website and check to see if the word 'TestingBot' is included on the page.

    Feature('Test');
    
    Scenario('test testingbot homepage', ({ I }) => {
      I.amOnPage('https://testingbot.com');
      I.see('TestingBot');
    });

Now you can run this first test on TestingBot.

    npx codeceptjs run --steps

    Test --
      test something
        I am on page "https://testingbot.com"
        I see "TestingBot"
      ✔ OK in 1057ms
    
    
      OK | 1 passed // 11s

This test will appear in your [Member Dashboard](https://testingbot.com/members), together with a video of the test and any logs that were generated.

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)