codeceptjs 4.0.0-beta.4 → 4.0.0-beta.6.esm-aria

package/README.md

@@ -1,20 +1,17 @@
 [![Stand With Ukraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/banner-direct-single.svg)](https://stand-with-ukraine.pp.ua)
 
-
-
 [<img src="https://img.shields.io/badge/slack-@codeceptjs-purple.svg?logo=slack">](https://join.slack.com/t/codeceptjs/shared_invite/enQtMzA5OTM4NDM2MzA4LWE4MThhN2NmYTgxNTU5MTc4YzAyYWMwY2JkMmZlYWI5MWQ2MDM5MmRmYzZmYmNiNmY5NTAzM2EwMGIwOTNhOGQ) [<img src="https://img.shields.io/badge/discourse-codeceptjs-purple">](https://codecept.discourse.group) [![NPM version][npm-image]][npm-url] [<img src="https://img.shields.io/badge/dockerhub-images-blue.svg?logo=codeceptjs">](https://hub.docker.com/r/codeceptjs/codeceptjs)
-[![AI features](https://img.shields.io/badge/AI-features?logo=openai&logoColor=white)](https://github.com/codeceptjs/CodeceptJS/edit/3.x/docs/ai.md) [![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md) 
-
-Build Status:
+[![AI features](https://img.shields.io/badge/AI-features?logo=openai&logoColor=white)](https://github.com/codeceptjs/CodeceptJS/edit/3.x/docs/ai.md) [![StandWithUkraine](https://raw.githubusercontent.com/vshymanskyy/StandWithUkraine/main/badges/StandWithUkraine.svg)](https://github.com/vshymanskyy/StandWithUkraine/blob/main/docs/README.md)
 
-Appium Helper:
-[![Appium V2 Tests - Android](https://github.com/codeceptjs/CodeceptJS/actions/workflows/appiumV2_Android.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/appiumV2_Android.yml)
+## Build Status
 
-Web Helper:
-[![Playwright Tests](https://github.com/codeceptjs/CodeceptJS/actions/workflows/playwright.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/playwright.yml)
-[![Puppeteer Tests](https://github.com/codeceptjs/CodeceptJS/actions/workflows/puppeteer.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/puppeteer.yml)
-[![WebDriver Tests](https://github.com/codeceptjs/CodeceptJS/actions/workflows/webdriver.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/webdriver.yml)
-[![TestCafe Tests](https://github.com/codeceptjs/CodeceptJS/actions/workflows/testcafe.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/testcafe.yml)
+| Type      | Engine     | Status                                                                                                                                                                                              |
+| --------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 🌐 Web    | Playwright | [![Playwright Tests](https://github.com/codeceptjs/CodeceptJS/actions/workflows/playwright.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/playwright.yml)               |
+| 🌐 Web    | Puppeteer  | [![Puppeteer Tests](https://github.com/codeceptjs/CodeceptJS/actions/workflows/puppeteer.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/puppeteer.yml)                  |
+| 🌐 Web    | WebDriver  | [![WebDriver Tests](https://github.com/codeceptjs/CodeceptJS/actions/workflows/webdriver.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/webdriver.yml)                  |
+| 🌐 Web    | TestCafe   | [![TestCafe Tests](https://github.com/codeceptjs/CodeceptJS/actions/workflows/testcafe.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/testcafe.yml)                     |
+| 📱 Mobile | Appium     | [![Appium Tests - Android](https://github.com/codeceptjs/CodeceptJS/actions/workflows/appium_Android.yml/badge.svg)](https://github.com/codeceptjs/CodeceptJS/actions/workflows/appium_Android.yml) |
 
 # CodeceptJS [![Made in Ukraine](https://img.shields.io/badge/made_in-ukraine-ffd700.svg?labelColor=0057b7)](https://stand-with-ukraine.pp.ua)
 
@@ -27,28 +24,28 @@ It abstracts browser interaction to simple steps that are written from a user's
 A simple test that verifies the "Welcome" text is present on a main page of a site will look like:
 
 ```js
-Feature('CodeceptJS demo');
+Feature('CodeceptJS demo')
 
 Scenario('check Welcome page on site', ({ I }) => {
-  I.amOnPage('/');
-  I.see('Welcome');
-});
+  I.amOnPage('/')
+  I.see('Welcome')
+})
 ```
 
 CodeceptJS tests are:
 
-* **Synchronous**. You don't need to care about callbacks or promises or test scenarios which are linear. But, your tests should be linear.
-* Written from **user's perspective**. Every action is a method of `I`. That makes test easy to read, write and maintain even for non-tech persons.
-* Backend **API agnostic**. We don't know which WebDriver implementation is running this test.
+- **Synchronous**. You don't need to care about callbacks or promises or test scenarios which are linear. But, your tests should be linear.
+- Written from **user's perspective**. Every action is a method of `I`. That makes test easy to read, write and maintain even for non-tech persons.
+- Backend **API agnostic**. We don't know which WebDriver implementation is running this test.
 
 CodeceptJS uses **Helper** modules to provide actions to `I` object. Currently, CodeceptJS has these helpers:
 
-* [**Playwright**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/Playwright.md) - is a Node library to automate the Chromium, WebKit and Firefox browsers with a single API.
-* [**Puppeteer**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/Puppeteer.md) - uses Google Chrome's Puppeteer for fast headless testing.
-* [**WebDriver**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/WebDriver.md) - uses [webdriverio](http://webdriver.io/) to run tests via WebDriver or Devtools protocol.
-* [**TestCafe**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/TestCafe.md) - cheap and fast cross-browser test automation.
-* [**Appium**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/Appium.md) - for **mobile testing** with Appium
-* [**Detox**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/Detox.md) - This is a wrapper on top of Detox library, aimed to unify testing experience for CodeceptJS framework. Detox provides a grey box testing for mobile applications, playing especially well for React Native apps.
+- [**Playwright**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/Playwright.md) - is a Node library to automate the Chromium, WebKit and Firefox browsers with a single API.
+- [**Puppeteer**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/Puppeteer.md) - uses Google Chrome's Puppeteer for fast headless testing.
+- [**WebDriver**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/WebDriver.md) - uses [webdriverio](http://webdriver.io/) to run tests via WebDriver or Devtools protocol.
+- [**TestCafe**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/TestCafe.md) - cheap and fast cross-browser test automation.
+- [**Appium**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/Appium.md) - for **mobile testing** with Appium
+- [**Detox**](https://github.com/codeceptjs/CodeceptJS/blob/master/docs/helpers/Detox.md) - This is a wrapper on top of Detox library, aimed to unify testing experience for CodeceptJS framework. Detox provides a grey box testing for mobile applications, playing especially well for React Native apps.
 
 And more to come...
 
@@ -58,17 +55,16 @@ CodeceptJS is a successor of [Codeception](http://codeception.com), a popular fu
 With CodeceptJS your scenario-driven functional and acceptance tests will be as simple and clean as they can be.
 You don't need to worry about asynchronous nature of NodeJS or about various APIs of Playwright, Selenium, Puppeteer, TestCafe, etc. as CodeceptJS unifies them and makes them work as they are synchronous.
 
-
 ## Features
- 
-* 🪄 **AI-powered** with GPT features to assist and heal failing tests.
-* ☕ Based on [Mocha](https://mochajs.org/) testing framework.
-* 💼 Designed for scenario driven acceptance testing in BDD-style.
-* 💻 Uses ES6 natively without transpiler.
-* Also plays nice with TypeScript.
-* </> Smart locators: use names, labels, matching text, CSS or XPath to locate elements.
-* 🌐 Interactive debugging shell: pause test at any point and try different commands in a browser.
-* Easily create tests, pageobjects, stepobjects with CLI generators.
+
+- 🪄 **AI-powered** with GPT features to assist and heal failing tests.
+- ☕ Based on [Mocha](https://mochajs.org/) testing framework.
+- 💼 Designed for scenario driven acceptance testing in BDD-style.
+- 💻 Uses ES6 natively without transpiler.
+- Also plays nice with TypeScript.
+- </> Smart locators: use names, labels, matching text, CSS or XPath to locate elements.
+- 🌐 Interactive debugging shell: pause test at any point and try different commands in a browser.
+- Easily create tests, pageobjects, stepobjects with CLI generators.
 
 ## Installation
 
@@ -105,7 +101,8 @@ npx codeceptjs def .
 Later you can even automagically update Type Definitions to include your own custom [helpers methods](docs/helpers.md).
 
 Note:
-- CodeceptJS requires Node.js version `12+` or later. 
+
+- CodeceptJS requires Node.js version `12+` or later.
 
 ## Usage
 
@@ -116,18 +113,18 @@ Learn CodeceptJS by examples. Let's assume we have CodeceptJS installed and WebD
 Let's see how we can handle basic form testing:
 
 ```js
-Feature('CodeceptJS Demonstration');
+Feature('CodeceptJS Demonstration')
 
 Scenario('test some forms', ({ I }) => {
-  I.amOnPage('http://simple-form-bootstrap.plataformatec.com.br/documentation');
-  I.fillField('Email', 'hello@world.com');
-  I.fillField('Password', secret('123456'));
-  I.checkOption('Active');
-  I.checkOption('Male');
-  I.click('Create User');
-  I.see('User is valid');
-  I.dontSeeInCurrentUrl('/documentation');
-});
+  I.amOnPage('http://simple-form-bootstrap.plataformatec.com.br/documentation')
+  I.fillField('Email', 'hello@world.com')
+  I.fillField('Password', secret('123456'))
+  I.checkOption('Active')
+  I.checkOption('Male')
+  I.click('Create User')
+  I.see('User is valid')
+  I.dontSeeInCurrentUrl('/documentation')
+})
 ```
 
 All actions are performed by `I` object; assertions functions start with `see` function.
@@ -172,11 +169,11 @@ The same way you can locate element by name, `CSS` or `XPath` locators in tests:
 
 ```js
 // by name
-I.fillField('user_basic[email]', 'hello@world.com');
+I.fillField('user_basic[email]', 'hello@world.com')
 // by CSS
-I.fillField('#user_basic_email', 'hello@world.com');
+I.fillField('#user_basic_email', 'hello@world.com')
 // don't make us guess locator type, specify it
-I.fillField({css: '#user_basic_email'}, 'hello@world.com');
+I.fillField({ css: '#user_basic_email' }, 'hello@world.com')
 ```
 
 Other methods like `checkOption`, and `click` work in a similar manner. They can take labels or CSS or XPath locators to find elements to interact.
@@ -187,9 +184,9 @@ Assertions start with `see` or `dontSee` prefix. In our case we are asserting th
 However, we can narrow the search to particular element by providing a second parameter:
 
 ```js
-I.see('User is valid');
+I.see('User is valid')
 // better to specify context:
-I.see('User is valid', '.alert-success');
+I.see('User is valid', '.alert-success')
 ```
 
 In this case 'User is valid' string will be searched only inside elements located by CSS `.alert-success`.
@@ -200,13 +197,13 @@ In case you need to return a value from a webpage and use it directly in test, y
 They are expected to be used inside `async/await` functions, and their results will be available in test:
 
 ```js
-Feature('CodeceptJS Demonstration');
+Feature('CodeceptJS Demonstration')
 
 Scenario('test page title', async ({ I }) => {
-  I.amOnPage('http://simple-form-bootstrap.plataformatec.com.br/documentation');
-  const title = await I.grabTitle();
-  I.expectEqual(title, 'Example application with SimpleForm and Twitter Bootstrap'); // Avaiable with Expect helper. -> https://codecept.io/helpers/Expect/
-});
+  I.amOnPage('http://simple-form-bootstrap.plataformatec.com.br/documentation')
+  const title = await I.grabTitle()
+  I.expectEqual(title, 'Example application with SimpleForm and Twitter Bootstrap') // Avaiable with Expect helper. -> https://codecept.io/helpers/Expect/
+})
 ```
 
 The same way you can grab text, attributes, or form values and use them in next test steps.
@@ -216,23 +213,24 @@ The same way you can grab text, attributes, or form values and use them in next
 Common preparation steps like opening a web page, logging in a user, can be placed in `Before` or `Background`:
 
 ```js
-const { I } = inject();
+const { I } = inject()
 
-Feature('CodeceptJS Demonstration');
+Feature('CodeceptJS Demonstration')
 
-Before(() => { // or Background
-  I.amOnPage('http://simple-form-bootstrap.plataformatec.com.br/documentation');
-});
+Before(() => {
+  // or Background
+  I.amOnPage('http://simple-form-bootstrap.plataformatec.com.br/documentation')
+})
 
 Scenario('test some forms', () => {
-  I.click('Create User');
-  I.see('User is valid');
-  I.dontSeeInCurrentUrl('/documentation');
-});
+  I.click('Create User')
+  I.see('User is valid')
+  I.dontSeeInCurrentUrl('/documentation')
+})
 
 Scenario('test title', () => {
-  I.seeInTitle('Example application');
-});
+  I.seeInTitle('Example application')
+})
 ```
 
 ## PageObjects
@@ -248,83 +246,55 @@ It will create a page object file for you and add it to the config.
 Let's assume we created one named `docsPage`:
 
 ```js
-const { I } = inject();
+const { I } = inject()
 
 module.exports = {
   fields: {
     email: '#user_basic_email',
-    password: '#user_basic_password'
+    password: '#user_basic_password',
   },
-  submitButton: {css: '#new_user_basic input[type=submit]'},
+  submitButton: { css: '#new_user_basic input[type=submit]' },
 
   sendForm(email, password) {
-    I.fillField(this.fields.email, email);
-    I.fillField(this.fields.password, password);
-    I.click(this.submitButton);
-  }
+    I.fillField(this.fields.email, email)
+    I.fillField(this.fields.password, password)
+    I.click(this.submitButton)
+  },
 }
 ```
 
 You can easily inject it to test by providing its name in test arguments:
 
 ```js
-Feature('CodeceptJS Demonstration');
+Feature('CodeceptJS Demonstration')
 
-Before(({ I }) => { // or Background
-  I.amOnPage('http://simple-form-bootstrap.plataformatec.com.br/documentation');
-});
+Before(({ I }) => {
+  // or Background
+  I.amOnPage('http://simple-form-bootstrap.plataformatec.com.br/documentation')
+})
 
 Scenario('test some forms', ({ I, docsPage }) => {
-  docsPage.sendForm('hello@world.com','123456');
-  I.see('User is valid');
-  I.dontSeeInCurrentUrl('/documentation');
-});
+  docsPage.sendForm('hello@world.com', '123456')
+  I.see('User is valid')
+  I.dontSeeInCurrentUrl('/documentation')
+})
 ```
 
 When using Typescript, replace `module.exports` with `export` for autocompletion.
 
-
 ## Contributing
 
- - ### [Contributing Guide](https://github.com/codeceptjs/CodeceptJS/blob/master/.github/CONTRIBUTING.md)
- - ### [Code of conduct](https://github.com/codeceptjs/CodeceptJS/blob/master/.github/CODE_OF_CONDUCT.md) 
-
+- ### [Contributing Guide](https://github.com/codeceptjs/CodeceptJS/blob/master/.github/CONTRIBUTING.md)
+- ### [Code of conduct](https://github.com/codeceptjs/CodeceptJS/blob/master/.github/CODE_OF_CONDUCT.md)
 
 ## Contributors
 
-Thanks all to those who are and will have contributing to this awesome project!
-
-[//]: contributor-faces
-<a href="https://github.com/DavertMik"><img src="https://avatars.githubusercontent.com/u/220264?v=4" title="DavertMik" width="80" height="80"></a>
-<a href="https://github.com/kobenguyent"><img src="https://avatars.githubusercontent.com/u/7845001?v=4" title="kobenguyent" width="80" height="80"></a>
-<a href="https://github.com/Vorobeyko"><img src="https://avatars.githubusercontent.com/u/11293201?v=4" title="Vorobeyko" width="80" height="80"></a>
-<a href="https://github.com/reubenmiller"><img src="https://avatars.githubusercontent.com/u/3029781?v=4" title="reubenmiller" width="80" height="80"></a>
-<a href="https://github.com/Arhell"><img src="https://avatars.githubusercontent.com/u/26163841?v=4" title="Arhell" width="80" height="80"></a>
-<a href="https://github.com/APshenkin"><img src="https://avatars.githubusercontent.com/u/14344430?v=4" title="APshenkin" width="80" height="80"></a>
-<a href="https://github.com/fabioel"><img src="https://avatars.githubusercontent.com/u/9824235?v=4" title="fabioel" width="80" height="80"></a>
-<a href="https://github.com/pablopaul"><img src="https://avatars.githubusercontent.com/u/635526?v=4" title="pablopaul" width="80" height="80"></a>
-<a href="https://github.com/mirao"><img src="https://avatars.githubusercontent.com/u/12584138?v=4" title="mirao" width="80" height="80"></a>
-<a href="https://github.com/Georgegriff"><img src="https://avatars.githubusercontent.com/u/9056958?v=4" title="Georgegriff" width="80" height="80"></a>
-<a href="https://github.com/KMKoushik"><img src="https://avatars.githubusercontent.com/u/24666922?v=4" title="KMKoushik" width="80" height="80"></a>
-<a href="https://github.com/nikocanvacom"><img src="https://avatars.githubusercontent.com/u/83254493?v=4" title="nikocanvacom" width="80" height="80"></a>
-<a href="https://github.com/elukoyanov"><img src="https://avatars.githubusercontent.com/u/11647141?v=4" title="elukoyanov" width="80" height="80"></a>
-<a href="https://github.com/gkushang"><img src="https://avatars.githubusercontent.com/u/3663389?v=4" title="gkushang" width="80" height="80"></a>
-<a href="https://github.com/tsuemura"><img src="https://avatars.githubusercontent.com/u/17092259?v=4" title="tsuemura" width="80" height="80"></a>
-<a href="https://github.com/EgorBodnar"><img src="https://avatars.githubusercontent.com/u/63167966?v=4" title="EgorBodnar" width="80" height="80"></a>
-<a href="https://github.com/VikalpP"><img src="https://avatars.githubusercontent.com/u/11846339?v=4" title="VikalpP" width="80" height="80"></a>
-<a href="https://github.com/thomashohn"><img src="https://avatars.githubusercontent.com/u/3414869?v=4" title="thomashohn" width="80" height="80"></a>
-<a href="https://github.com/elaichenkov"><img src="https://avatars.githubusercontent.com/u/29764053?v=4" title="elaichenkov" width="80" height="80"></a>
-<a href="https://github.com/BorisOsipov"><img src="https://avatars.githubusercontent.com/u/6514276?v=4" title="BorisOsipov" width="80" height="80"></a>
-<a href="https://github.com/ngraf"><img src="https://avatars.githubusercontent.com/u/7094389?v=4" title="ngraf" width="80" height="80"></a>
-<a href="https://github.com/nitschSB"><img src="https://avatars.githubusercontent.com/u/39341455?v=4" title="nitschSB" width="80" height="80"></a>
-<a href="https://github.com/hubidu"><img src="https://avatars.githubusercontent.com/u/13134082?v=4" title="hubidu" width="80" height="80"></a>
-<a href="https://github.com/jploskonka"><img src="https://avatars.githubusercontent.com/u/669483?v=4" title="jploskonka" width="80" height="80"></a>
-<a href="https://github.com/maojunxyz"><img src="https://avatars.githubusercontent.com/u/28778042?v=4" title="maojunxyz" width="80" height="80"></a>
-<a href="https://github.com/abhimanyupandian"><img src="https://avatars.githubusercontent.com/u/36107381?v=4" title="abhimanyupandian" width="80" height="80"></a>
-<a href="https://github.com/martomo"><img src="https://avatars.githubusercontent.com/u/1850135?v=4" title="martomo" width="80" height="80"></a>
-<a href="https://github.com/hatufacci"><img src="https://avatars.githubusercontent.com/u/4963181?v=4" title="hatufacci" width="80" height="80"></a>
-
-[//]: contributor-faces
+Thanks to our awesome contributors! 🎉
+<a href="https://github.com/codeceptjs/codeceptjs/graphs/contributors">
+<img src="https://contrib.rocks/image?repo=codeceptjs/codeceptjs" />
+</a>
+
+Made with [contrib.rocks](https://contrib.rocks).
 
 ## License
 

package/bin/codecept.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
-const program = require('commander')
-const Codecept = require('../lib/codecept')
-const { print, error } = require('../lib/output')
-const { printError } = require('../lib/command/utils')
+import { Command } from 'commander'
+const program = new Command()
+import Codecept from '../lib/codecept.js'
+import output from '../lib/output.js'
+const { print, error } = output
+import { printError } from '../lib/command/utils.js'
 
 const commandFlags = {
   ai: {
@@ -32,7 +34,7 @@ const commandFlags = {
 }
 
 const errorHandler =
-  (fn) =>
+  fn =>
   async (...args) => {
     try {
       await fn(...args)
@@ -42,6 +44,23 @@ const errorHandler =
     }
   }
 
+const dynamicImport = async modulePath => {
+  const module = await import(modulePath)
+  return module.default || module
+}
+
+const commandHandler = modulePath =>
+  errorHandler(async (...args) => {
+    const handler = await dynamicImport(modulePath)
+    return handler(...args)
+  })
+
+const commandHandlerWithProperty = (modulePath, property) =>
+  errorHandler(async (...args) => {
+    const module = await dynamicImport(modulePath)
+    return module[property](...args)
+  })
+
 if (process.versions.node && process.versions.node.split('.') && process.versions.node.split('.')[0] < 12) {
   error('NodeJS >= 12 is required to run.')
   print()
@@ -53,15 +72,16 @@ if (process.versions.node && process.versions.node.split('.') && process.version
 program.usage('<command> [options]')
 program.version(Codecept.version())
 
-program
-  .command('init [path]')
-  .description('Creates dummy config in current dir or [path]')
-  .action(errorHandler(require('../lib/command/init')))
+program.command('init [path]').description('Creates dummy config in current dir or [path]').action(commandHandler('../lib/command/init.js'))
 
 program
-  .command('migrate [path]')
-  .description('Migrate json config to js config in current dir or [path]')
-  .action(errorHandler(require('../lib/command/configMigrate')))
+  .command('check')
+  .option(commandFlags.config.flag, commandFlags.config.description)
+  .description('Checks configuration and environment before running tests')
+  .option('-t, --timeout [ms]', 'timeout for checks in ms, 50000 by default')
+  .action(commandHandler('../lib/command/check.js'))
+
+program.command('migrate [path]').description('Migrate json config to js config in current dir or [path]').action(commandHandler('../lib/command/configMigrate.js'))
 
 program
   .command('shell [path]')
@@ -71,34 +91,30 @@ program
   .option(commandFlags.profile.flag, commandFlags.profile.description)
   .option(commandFlags.ai.flag, commandFlags.ai.description)
   .option(commandFlags.config.flag, commandFlags.config.description)
-  .action(errorHandler(require('../lib/command/interactive')))
+  .action(commandHandler('../lib/command/interactive.js'))
 
-program
-  .command('list [path]')
-  .alias('l')
-  .description('List all actions for I.')
-  .action(errorHandler(require('../lib/command/list')))
+program.command('list [path]').alias('l').description('List all actions for I.').action(commandHandler('../lib/command/list.js'))
 
 program
   .command('def [path]')
   .description('Generates TypeScript definitions for all I actions.')
   .option(commandFlags.config.flag, commandFlags.config.description)
   .option('-o, --output [folder]', 'target folder to paste definitions')
-  .action(errorHandler(require('../lib/command/definitions')))
+  .action(commandHandler('../lib/command/definitions.js'))
 
 program
   .command('gherkin:init [path]')
   .alias('bdd:init')
   .description('Prepare CodeceptJS to run feature files.')
   .option(commandFlags.config.flag, commandFlags.config.description)
-  .action(errorHandler(require('../lib/command/gherkin/init')))
+  .action(commandHandler('../lib/command/gherkin/init.js'))
 
 program
   .command('gherkin:steps [path]')
   .alias('bdd:steps')
   .description('Prints all defined gherkin steps.')
   .option(commandFlags.config.flag, commandFlags.config.description)
-  .action(errorHandler(require('../lib/command/gherkin/steps')))
+  .action(commandHandler('../lib/command/gherkin/steps.js'))
 
 program
   .command('gherkin:snippets [path]')
@@ -108,38 +124,22 @@ program
   .option(commandFlags.config.flag, commandFlags.config.description)
   .option('--feature [file]', 'feature files(s) to scan')
   .option('--path [file]', 'file in which to place the new snippets')
-  .action(errorHandler(require('../lib/command/gherkin/snippets')))
+  .action(commandHandler('../lib/command/gherkin/snippets.js'))
 
-program
-  .command('generate:test [path]')
-  .alias('gt')
-  .description('Generates an empty test')
-  .action(errorHandler(require('../lib/command/generate').test))
+program.command('generate:test [path]').alias('gt').description('Generates an empty test').action(commandHandlerWithProperty('../lib/command/generate.js', 'test'))
 
-program
-  .command('generate:pageobject [path]')
-  .alias('gpo')
-  .description('Generates an empty page object')
-  .action(errorHandler(require('../lib/command/generate').pageObject))
+program.command('generate:pageobject [path]').alias('gpo').description('Generates an empty page object').action(commandHandlerWithProperty('../lib/command/generate.js', 'pageObject'))
 
 program
   .command('generate:object [path]')
   .alias('go')
   .option('--type, -t [kind]', 'type of object to be created')
   .description('Generates an empty support object (page/step/fragment)')
-  .action(errorHandler(require('../lib/command/generate').pageObject))
+  .action(commandHandlerWithProperty('../lib/command/generate.js', 'pageObject'))
 
-program
-  .command('generate:helper [path]')
-  .alias('gh')
-  .description('Generates a new helper')
-  .action(errorHandler(require('../lib/command/generate').helper))
+program.command('generate:helper [path]').alias('gh').description('Generates a new helper').action(commandHandlerWithProperty('../lib/command/generate.js', 'helper'))
 
-program
-  .command('generate:heal [path]')
-  .alias('gr')
-  .description('Generates basic heal recipes')
-  .action(errorHandler(require('../lib/command/generate').heal))
+program.command('generate:heal [path]').alias('gr').description('Generates basic heal recipes').action(commandHandlerWithProperty('../lib/command/generate.js', 'heal'))
 
 program
   .command('run [test]')
@@ -178,7 +178,7 @@ program
   .option('--recursive', 'include sub directories')
   .option('--trace', 'trace function calls')
   .option('--child <string>', 'option for child processes')
-  .action(errorHandler(require('../lib/command/run')))
+  .action(commandHandler('../lib/command/run.js'))
 
 program
   .command('run-workers <workers> [selectedRuns...]')
@@ -197,7 +197,7 @@ program
   .option('-p, --plugins <k=v,k2=v2,...>', 'enable plugins, comma-separated')
   .option('-O, --reporter-options <k=v,k2=v2,...>', 'reporter-specific options')
   .option('-R, --reporter <name>', 'specify the reporter to use')
-  .action(errorHandler(require('../lib/command/run-workers')))
+  .action(commandHandler('../lib/command/run-workers.js'))
 
 program
   .command('run-multiple [suites...]')
@@ -223,13 +223,9 @@ program
   // mocha options
   .option('--colors', 'force enabling of colors')
 
-  .action(errorHandler(require('../lib/command/run-multiple')))
+  .action(commandHandler('../lib/command/run-multiple.js'))
 
-program
-  .command('info [path]')
-  .description('Print debugging information concerning the local environment')
-  .option('-c, --config', 'your config file path')
-  .action(errorHandler(require('../lib/command/info')))
+program.command('info [path]').description('Print debugging information concerning the local environment').option('-c, --config', 'your config file path').action(commandHandler('../lib/command/info.js'))
 
 program
   .command('dry-run [test]')
@@ -246,7 +242,7 @@ program
   .option(commandFlags.steps.flag, commandFlags.steps.description)
   .option(commandFlags.verbose.flag, commandFlags.verbose.description)
   .option(commandFlags.debug.flag, commandFlags.debug.description)
-  .action(errorHandler(require('../lib/command/dryRun')))
+  .action(commandHandler('../lib/command/dryRun.js'))
 
 program
   .command('run-rerun [test]')
@@ -284,9 +280,12 @@ program
   .option('--trace', 'trace function calls')
   .option('--child <string>', 'option for child processes')
 
-  .action(require('../lib/command/run-rerun'))
+  .action(async (...args) => {
+    const runRerun = await dynamicImport('../lib/command/run-rerun.js')
+    return runRerun(...args)
+  })
 
-program.on('command:*', (cmd) => {
+program.on('command:*', cmd => {
   console.log(`\nUnknown command ${cmd}\n`)
   program.outputHelp()
 })

package/docs/webapi/clearCookie.mustache

@@ -3,7 +3,7 @@ if none provided clears all cookies.
 
 ```js
 I.clearCookie();
-I.clearCookie('test'); // Playwright currently doesn't support clear a particular cookie name
+I.clearCookie('test');
 ```
 
 @param {?string} [cookie=null] (optional, `null` by default) cookie name