codeceptjs / helper

Base class for CodeceptJS helpers
MIT License
1 stars 4 forks source link

CodeceptJS Helper

Base class for all CodeceptJS helpers. This class has been moved into a separate package to allow other helpers to be extended from it, without requiring main codeceptjs package.

Installation

npm i @codeceptjs/helper --save

Usage

Create CodeceptJS helper as described in documentation.

const Helper = require('@codeceptjs/helper');

class MyHelper extends Helper {
  // implement custom helper here
}

API

Table of Contents

Helper

Abstract class. Helpers abstracts test execution backends.

Methods of Helper class will be available in tests in I object. They provide user-friendly abstracted actions over NodeJS libraries.

Hooks (methods starting with _) can be used to setup/teardown, or handle execution flow.

Methods are expected to return a value in order to be wrapped in promise.

Parameters

_validateConfig

Abstract method to validate config

Parameters

Returns any

_setConfig

Sets config for current test

Parameters

_init

Hook executed before all tests

_before

Hook executed before each test.

Parameters

_after

Hook executed after each test

_test

Hook provides a test details Executed in the very beginning of a test

Parameters

_passed

Hook executed after each passed test

Parameters

_failed

Hook executed after each failed test

Parameters

_beforeStep

Hook executed before each step

Parameters

_afterStep

Hook executed after each step

Parameters

_beforeSuite

Hook executed before each suite

Parameters

_afterSuite

Hook executed after each suite

Parameters

_finishTest

Hook executed after all tests are executed

Parameters

_useTo

Abstract method to provide common interface to accessing helpers internals inside a test.

Parameters

helpers

Access another configured helper: this.helpers['AnotherHelper']

Type: any

debug

Print debug message to console (outputs only in debug mode)

Parameters

debugSection

Parameters

_config

Abstract method to provide required config options

Returns any