codeceptjs 4.0.0-beta.5 → 4.0.0-beta.7.esm-aria

package/README.md

@@ -64,8 +64,6 @@ You don't need to worry about asynchronous nature of NodeJS or about various API
 - 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.
-- ⚡ **Parallel testing** with dynamic test pooling for optimal load balancing and performance.
-- 📊 **Built-in HTML Reporter** with interactive dashboard, step-by-step execution details, and comprehensive test analytics.
 - Easily create tests, pageobjects, stepobjects with CLI generators.
 
 ## Installation
@@ -235,49 +233,6 @@ Scenario('test title', () => {
 })
 ```
 
-## HTML Reporter
-
-CodeceptJS includes a powerful built-in HTML Reporter that generates comprehensive, interactive test reports with detailed information about your test runs. The HTML reporter is **enabled by default** for all new projects and provides:
-
-### Features
-
-- **Interactive Dashboard**: Visual statistics, pie charts, and expandable test details
-- **Step-by-Step Execution**: Shows individual test steps with timing and status indicators
-- **BDD/Gherkin Support**: Full support for feature files with proper scenario formatting
-- **System Information**: Comprehensive environment details including browser versions
-- **Advanced Filtering**: Real-time filtering by status, tags, features, and test types
-- **History Tracking**: Multi-run history with trend visualization
-- **Error Details**: Clean formatting of error messages and stack traces
-- **Artifacts Support**: Display screenshots and other test artifacts
-
-### Visual Examples
-
-#### Interactive Test Dashboard
-
-The main dashboard provides a complete overview with interactive statistics and pie charts:
-
-![HTML Reporter Dashboard](docs/shared/html-reporter-main-dashboard.png)
-
-#### Detailed Test Results
-
-Each test shows comprehensive execution details with expandable step information:
-
-![HTML Reporter Test Details](docs/shared/html-reporter-test-details.png)
-
-#### Advanced Filtering Capabilities
-
-Real-time filtering allows quick navigation through test results:
-
-![HTML Reporter Filtering](docs/shared/html-reporter-filtering.png)
-
-#### BDD/Gherkin Support
-
-Full support for Gherkin scenarios with proper feature formatting:
-
-![HTML Reporter BDD Details](docs/shared/html-reporter-bdd-details.png)
-
-The HTML reporter generates self-contained reports that can be easily shared with your team. Learn more about configuration and features in the [HTML Reporter documentation](https://codecept.io/plugins/#htmlreporter).
-
 ## PageObjects
 
 CodeceptJS provides the most simple way to create and use page objects in your test.

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: {
@@ -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,22 +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('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(errorHandler(require('../lib/command/check')))
+  .action(commandHandler('../lib/command/check.js'))
 
-program
-  .command('migrate [path]')
-  .description('Migrate json config to js config in current dir or [path]')
-  .action(errorHandler(require('../lib/command/configMigrate')))
+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]')
@@ -78,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]')
@@ -115,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]')
@@ -164,8 +157,6 @@ program
   .option('--tests', 'run only JS test files and skip features')
   .option('--no-timeouts', 'disable all timeouts')
   .option('-p, --plugins <k=v,k2=v2,...>', 'enable plugins, comma-separated')
-  .option('--shuffle', 'Shuffle the order in which test files run')
-  .option('--shard <index/total>', 'run only a fraction of tests (e.g., --shard 1/4)')
 
   // mocha options
   .option('--colors', 'force enabling of colors')
@@ -187,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 +188,6 @@ program
   .option('-i, --invert', 'inverts --grep matches')
   .option('-o, --override [value]', 'override current config options')
   .option('--suites', 'parallel execution of suites not single tests')
-  .option('--by <strategy>', 'test distribution strategy: "test" (pre-assign individual tests), "suite" (pre-assign test suites), or "pool" (dynamic distribution for optimal load balancing, recommended)')
   .option(commandFlags.debug.flag, commandFlags.debug.description)
   .option(commandFlags.verbose.flag, commandFlags.verbose.description)
   .option('--features', 'run only *.feature files and skip tests')
@@ -207,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...]')
@@ -233,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]')
@@ -256,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]')
@@ -294,7 +280,10 @@ 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 => {
   console.log(`\nUnknown command ${cmd}\n`)

package/lib/actor.js

@@ -1,12 +1,12 @@
-const Step = require('./step')
-const MetaStep = require('./step/meta')
-const recordStep = require('./step/record')
-const container = require('./container')
-const { methodsOfObject } = require('./utils')
-const { TIMEOUT_ORDER } = require('./timeout')
-const event = require('./event')
-const store = require('./store')
-const output = require('./output')
+import Step, { MetaStep } from './step.js'
+import recordStep from './step/record.js'
+import retryStep from './step/retry.js'
+import { methodsOfObject } from './utils.js'
+import { TIMEOUT_ORDER } from './timeout.js'
+import event from './event.js'
+import store from './store.js'
+import output from './output.js'
+import Container from './container.js'
 
 /**
  * @interface
@@ -59,7 +59,6 @@ class Actor {
    */
   retry(opts) {
     console.log('I.retry() is deprecated, use step.retry() instead')
-    const retryStep = require('./step/retry')
     retryStep(opts)
     return this
   }
@@ -71,7 +70,12 @@ class Actor {
  * Wraps helper methods into promises.
  * @ignore
  */
-module.exports = function (obj = {}) {
+export default function (obj = {}, container) {
+  // Use global container if none provided
+  if (!container) {
+    container = Container
+  }
+  
   const actor = container.actor() || new Actor()
 
   // load all helpers once container initialized

package/lib/ai.js

@@ -1,7 +1,8 @@
-const debug = require('debug')('codeceptjs:ai')
-const output = require('./output')
-const event = require('./event')
-const { removeNonInteractiveElements, minifyHtml, splitByChunks } = require('./html')
+import debugModule from 'debug'
+const debug = debugModule('codeceptjs:ai')
+import output from './output.js'
+import event from './event.js'
+import { removeNonInteractiveElements, minifyHtml, splitByChunks } from './html.js'
 
 const defaultHtmlConfig = {
   maxLength: 50000,
@@ -304,4 +305,4 @@ function parseCodeBlocks(response) {
   return modifiedSnippets.filter(snippet => !!snippet)
 }
 
-module.exports = new AiAssistant()
+export default new AiAssistant()

package/lib/assert/empty.js

@@ -1,7 +1,9 @@
-const Assertion = require('../assert')
-const AssertionFailedError = require('./error')
-const { template } = require('../utils')
-const output = require('../output')
+import assertionModule from '../assert.js'
+const Assertion = assertionModule.default || assertionModule
+import AssertionFailedError from './error.js'
+import { template } from '../utils.js'
+import outputModule from '../output.js'
+const output = outputModule.default || outputModule
 
 class EmptinessAssertion extends Assertion {
   constructor(params) {
@@ -35,7 +37,6 @@ class EmptinessAssertion extends Assertion {
   }
 }
 
-module.exports = {
-  Assertion: EmptinessAssertion,
-  empty: subject => new EmptinessAssertion({ subject }),
-}
+export { EmptinessAssertion as Assertion }
+
+export const empty = subject => new EmptinessAssertion({ subject })

package/lib/assert/equal.js

@@ -1,7 +1,7 @@
-const Assertion = require('../assert')
-const AssertionFailedError = require('./error')
-const { template } = require('../utils')
-const output = require('../output')
+import Assertion from '../assert.js'
+import AssertionFailedError from './error.js'
+import { template } from '../utils.js'
+import output from '../output.js'
 
 class EqualityAssertion extends Assertion {
   constructor(params) {
@@ -37,18 +37,16 @@ class EqualityAssertion extends Assertion {
   }
 }
 
-module.exports = {
-  Assertion: EqualityAssertion,
-  equals: jar => new EqualityAssertion({ jar }),
-  urlEquals: baseUrl => {
-    const assert = new EqualityAssertion({ jar: 'url of current page' })
-    assert.comparator = function (expected, actual) {
-      if (expected.indexOf('http') !== 0) {
-        actual = actual.slice(actual.indexOf(baseUrl) + baseUrl.length)
-      }
-      return actual === expected
+export { EqualityAssertion as Assertion }
+export const equals = jar => new EqualityAssertion({ jar })
+export const urlEquals = baseUrl => {
+  const assert = new EqualityAssertion({ jar: 'url of current page' })
+  assert.comparator = function (expected, actual) {
+    if (expected.indexOf('http') !== 0) {
+      actual = actual.slice(actual.indexOf(baseUrl) + baseUrl.length)
     }
-    return assert
-  },
-  fileEquals: file => new EqualityAssertion({ file, jar: 'contents of {{file}}' }),
+    return actual === expected
+  }
+  return assert
 }
+export const fileEquals = file => new EqualityAssertion({ file, jar: 'contents of {{file}}' })

package/lib/assert/error.js

@@ -1,4 +1,4 @@
-const subs = require('../utils').template
+import { template as subs } from '../utils.js'
 
 /**
  * Assertion errors, can provide a detailed error messages.
@@ -29,4 +29,4 @@ function AssertionFailedError(params, template) {
 AssertionFailedError.prototype = Object.create(Error.prototype)
 AssertionFailedError.constructor = AssertionFailedError
 
-module.exports = AssertionFailedError
+export default AssertionFailedError

package/lib/assert/include.js

@@ -1,7 +1,7 @@
-const Assertion = require('../assert')
-const AssertionFailedError = require('./error')
-const { template } = require('../utils')
-const output = require('../output')
+import Assertion from '../assert.js'
+import AssertionFailedError from './error.js'
+import { template } from '../utils.js'
+import output from '../output.js'
 
 const MAX_LINES = 10
 
@@ -62,14 +62,12 @@ class InclusionAssertion extends Assertion {
   }
 }
 
-module.exports = {
-  Assertion: InclusionAssertion,
-  includes: needleType => {
-    needleType = needleType || 'string'
-    return new InclusionAssertion({ jar: needleType })
-  },
-  fileIncludes: file => new InclusionAssertion({ file, jar: 'file {{file}}' }),
+export { InclusionAssertion as Assertion }
+export const includes = needleType => {
+  needleType = needleType || 'string'
+  return new InclusionAssertion({ jar: needleType })
 }
+export const fileIncludes = file => new InclusionAssertion({ file, jar: 'file {{file}}' })
 
 function escapeRegExp(str) {
   return str.replace(/[\-\[\]\/\{\}\(\)\*\+\?\.\\\^\$\|]/g, '\\$&')

package/lib/assert/throws.js

@@ -17,4 +17,4 @@ function errorThrown(actual, expected) {
   return null
 }
 
-module.exports = errorThrown
+export default errorThrown

package/lib/assert/truth.js

@@ -1,7 +1,7 @@
-const Assertion = require('../assert')
-const AssertionFailedError = require('./error')
-const { template } = require('../utils')
-const output = require('../output')
+import Assertion from '../assert.js'
+import AssertionFailedError from './error.js'
+import { template } from '../utils.js'
+import output from '../output.js'
 
 class TruthAssertion extends Assertion {
   constructor(params) {
@@ -30,7 +30,10 @@ class TruthAssertion extends Assertion {
   }
 }
 
-module.exports = {
+export { TruthAssertion as Assertion }
+export const truth = (subject, type) => new TruthAssertion({ subject, type })
+
+export default {
   Assertion: TruthAssertion,
   truth: (subject, type) => new TruthAssertion({ subject, type }),
 }

package/lib/assert.js

@@ -1,4 +1,4 @@
-const AssertionFailedError = require('./assert/error');
+import AssertionFailedError from './assert/error.js'
 
 /**
  * Abstract assertion class introduced for more verbose and customizable messages.
@@ -22,9 +22,9 @@ const AssertionFailedError = require('./assert/error');
  */
 class Assertion {
   constructor(comparator, params) {
-    this.comparator = comparator;
-    this.params = params || {};
-    this.params.customMessage = '';
+    this.comparator = comparator
+    this.params = params || {}
+    this.params.customMessage = ''
   }
 
   /**
@@ -32,10 +32,10 @@ class Assertion {
    * Fails if comparator function with provided arguments returns false
    */
   assert() {
-    this.addAssertParams.apply(this, arguments);
-    const result = this.comparator.apply(this.params, arguments);
-    if (result) return; // should increase global assertion counter
-    throw this.getFailedAssertion();
+    this.addAssertParams.apply(this, arguments)
+    const result = this.comparator.apply(this.params, arguments)
+    if (result) return // should increase global assertion counter
+    throw this.getFailedAssertion()
   }
 
   /**
@@ -43,10 +43,10 @@ class Assertion {
    * Fails if comparator function with provided arguments returns true
    */
   negate() {
-    this.addAssertParams.apply(this, arguments);
-    const result = this.comparator.apply(this.params, arguments);
-    if (!result) return; // should increase global assertion counter
-    throw this.getFailedNegation();
+    this.addAssertParams.apply(this, arguments)
+    const result = this.comparator.apply(this.params, arguments)
+    if (!result) return // should increase global assertion counter
+    throw this.getFailedNegation()
   }
 
   /**
@@ -55,18 +55,18 @@ class Assertion {
   addAssertParams() {}
 
   getException() {
-    return new AssertionFailedError(this.params, '');
+    return new AssertionFailedError(this.params, '')
   }
 
   getFailedNegation() {
-    const err = this.getException();
-    err.params.type = `not ${err.params.type}`;
-    return err;
+    const err = this.getException()
+    err.params.type = `not ${err.params.type}`
+    return err
   }
 
   getFailedAssertion() {
-    return this.getException();
+    return this.getException()
   }
 }
 
-module.exports = Assertion;
+export default Assertion