CodeceptJS & Playwright

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

To get started, please install these packages:

npm install codeceptjs playwright --save

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

npx codeceptjs init

Configure CodeceptJS with Playwright

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

{ // ..
  helpers: {
    Playwright: {
      url: "http://localhost",
      browser: 'chromium',
      chromium: {
        browserWSEndpoint: "wss://cloud.testingbot.com?key=YOUR_KEY&secret=YOUR_SECRET",
        cdpConnection: true
  // ..

You can use the browserWSEndpoint URL to instruct CodeceptJS to use TestingBot's Playwright grid to run the tests on.

Specifying browser and version

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

Select a browser & version

Run your first CodeceptJS + Playwright test

The example test below will open the TestingBot website and check to see if the word 'TestingBot' is included on the page.


Scenario('test testingbot homepage', ({ I }) => {

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 1017ms

  OK  | 1 passed   // 10s

This test will appear in your Member Dashboard. Test details will include a video of the test and any logs that were generated.