---
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.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:

```bash
npm install codeceptjs puppeteer --save
```

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

```bash
npx codeceptjs init
```

## Configure CodeceptJS with Puppeteer

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

```javascript
{ // ..
  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.

```javascript
Feature('Test');

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

Now you can run this first test on TestingBot.

```bash
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.

### Looking for more help?

Have questions or need more information? Reach out via email or Slack.

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