CodeceptionModule

Codeception\Module

Uses Codeception\Util\Shared\Asserts

Basic class for Modules and Helpers. You must extend from it while implementing own helpers.

Public methods of this class start with _ prefix in order to ignore them in actor classes. Module contains HOOKS which allow to handle test execution routine.

$includeInheritedActions

public static $includeInheritedActions

By setting it to false module wan’t inherit methods of parent class.

type bool

$onlyActions

public static $onlyActions

Allows to explicitly set what methods have this class.

type array

$excludeActions

public static $excludeActions

Allows to explicitly exclude actions from module.

type array

$aliases

public static $aliases

Allows to rename actions

type array

__construct()

public __construct($moduleContainer, $config = null)

Module constructor.

Requires module container (to provide access between modules of suite) and config.

param ModuleContainer $moduleContainer
param null $config

See source

_after()

public _after($test)

HOOK executed after test

param TestInterface $test

See source

_afterStep()

public _afterStep($step)

HOOK executed after step

param Step $step

See source

_afterSuite()

public _afterSuite()

HOOK executed after suite

See source

_before()

public _before($test)

HOOK executed before test

param TestInterface $test

See source

_beforeStep()

public _beforeStep($step)

HOOK executed before step

param Step $step

See source

_beforeSuite()

public _beforeSuite($settings = null)

HOOK executed before suite

param array $settings

See source

_failed()

public _failed($test, $fail)

HOOK executed when test fails but before _after

param TestInterface $test
param \Exception $fail

See source

_getConfig()

public _getConfig($key = null)

Get config values or specific config item.

param null $key
return array mixed null

See source

_getName()

public _getName()

Returns a module name for a Module, a class name for Helper

return string

See source

_hasRequiredFields()

public _hasRequiredFields()

Checks if a module has required fields

return bool

See source

_initialize()

public _initialize()

HOOK triggered after module is created and configuration is loaded

See source

_reconfigure()

public _reconfigure($config)

Allows to redefine config for a specific test. Config is restored at the end of a test.

<?php
// cleanup DB only for specific group of tests
public function _before(Test $test) {
    if (in_array('cleanup', $test->getMetadata()->getGroups()) {
        $this->getModule('Db')->_reconfigure(['cleanup' => true]);
    }
}

param $config
throws Exception\ModuleConfigException
throws ModuleException

See source

_resetConfig()

public _resetConfig()

Reverts config changed by _reconfigure

See source

_setConfig()

public _setConfig($config)

Allows to define initial module config. Can be used in _beforeSuite hook of Helpers or Extensions

<?php
public function _beforeSuite($settings = []) {
    $this->getModule('otherModule')->_setConfig($this->myOtherConfig);
}

param $config
throws Exception\ModuleConfigException
throws ModuleException

See source

assert()

protected assert($arguments, $not = null)

See source

assertArrayHasKey()

protected assertArrayHasKey($key, $actual, $description = null)

param $key
param $actual
param $description

See source

assertArrayNotHasKey()

protected assertArrayNotHasKey($key, $actual, $description = null)

param $key
param $actual
param $description

See source

assertContains()

protected assertContains($needle, $haystack, $message = null)

Checks that haystack contains needle

param $needle
param $haystack
param string $message

See source

assertCount()

protected assertCount($expectedCount, $actual, $description = null)

param $expectedCount
param $actual
param $description

See source

assertEmpty()

protected assertEmpty($actual, $message = null)

Checks that variable is empty.

param $actual
param string $message

See source

assertEquals()

protected assertEquals($expected, $actual, $message = null, $delta = null)

Checks that two variables are equal.

param $expected
param $actual
param string $message
param float $delta

See source

assertFalse()

protected assertFalse($condition, $message = null)

Checks that condition is negative.

param $condition
param string $message

See source

assertFileExists()

protected assertFileExists($filename, $message = null)

Checks if file exists

param string $filename
param string $message

See source

assertFileNotExists()

protected assertFileNotExists($filename, $message = null)

Checks if file doesn’t exist

param string $filename
param string $message

See source

assertGreaterOrEquals()

protected assertGreaterOrEquals($expected, $actual, $description = null)

param $expected
param $actual
param $description

See source

assertGreaterThan()

protected assertGreaterThan($expected, $actual, $message = null)

Checks that actual is greater than expected

param $expected
param $actual
param string $message

See source

assertGreaterThanOrEqual()

protected assertGreaterThanOrEqual($expected, $actual, $message = null)

Checks that actual is greater or equal than expected

param $expected
param $actual
param string $message

See source

assertGreaterThen()

protected assertGreaterThen($expected, $actual, $message = null)

deprecated See source

assertGreaterThenOrEqual()

protected assertGreaterThenOrEqual($expected, $actual, $message = null)

deprecated See source

assertInstanceOf()

protected assertInstanceOf($class, $actual, $description = null)

param $class
param $actual
param $description

See source

assertInternalType()

protected assertInternalType($type, $actual, $description = null)

param $type
param $actual
param $description

See source

assertIsEmpty()

protected assertIsEmpty($actual, $description = null)

param $actual
param $description

See source

assertLessOrEquals()

protected assertLessOrEquals($expected, $actual, $description = null)

param $expected
param $actual
param $description

See source

assertLessThan()

protected assertLessThan($expected, $actual, $message = null)

Checks that actual is less than expected

param $expected
param $actual
param string $message

See source

assertLessThanOrEqual()

protected assertLessThanOrEqual($expected, $actual, $message = null)

Checks that actual is less or equal than expected

param $expected
param $actual
param string $message

See source

assertNot()

protected assertNot($arguments)

See source

assertNotContains()

protected assertNotContains($needle, $haystack, $message = null)

Checks that haystack doesn’t contain needle.

param $needle
param $haystack
param string $message

See source

assertNotEmpty()

protected assertNotEmpty($actual, $message = null)

Checks that variable is not empty.

param $actual
param string $message

See source

assertNotEquals()

protected assertNotEquals($expected, $actual, $message = null, $delta = null)

Checks that two variables are not equal

param $expected
param $actual
param string $message
param float $delta

See source

assertNotInstanceOf()

protected assertNotInstanceOf($class, $actual, $description = null)

param $class
param $actual
param $description

See source

assertNotNull()

protected assertNotNull($actual, $message = null)

Checks that variable is not NULL

param $actual
param string $message

See source

assertNotRegExp()

protected assertNotRegExp($pattern, $string, $message = null)

Checks that string not match with pattern

param string $pattern
param string $string
param string $message

See source

assertNotSame()

protected assertNotSame($expected, $actual, $message = null)

Checks that two variables are not same

param $expected
param $actual
param string $message

See source

assertNull()

protected assertNull($actual, $message = null)

Checks that variable is NULL

param $actual
param string $message

See source

assertRegExp()

protected assertRegExp($pattern, $string, $message = null)

Checks that string match with pattern

param string $pattern
param string $string
param string $message

See source

assertSame()

protected assertSame($expected, $actual, $message = null)

Checks that two variables are same

param $expected
param $actual
param string $message

See source

assertThat()

protected assertThat($haystack, $constraint, $message = null)

param $haystack
param $constraint
param string $message

See source

assertThatItsNot()

protected assertThatItsNot($haystack, $constraint, $message = null)

Checks that haystack doesn’t attend

param $haystack
param $constraint
param string $message

See source

assertTrue()

protected assertTrue($condition, $message = null)

Checks that condition is positive.

param $condition
param string $message

See source

debug()

protected debug($message)

Print debug message to the screen.

param $message

See source

debugSection()

protected debugSection($title, $message)

Print debug message with a title

param $title
param $message

See source

fail()

protected fail($message)

Fails the test with message.

param $message

See source

getModule()

protected getModule($name)

Get another module by its name:

<?php
$this->getModule('WebDriver')->_findElements('.items');

param $name
return Module
throws ModuleException

See source

getModules()

protected getModules()

Get all enabled modules

return array

See source

hasModule()

protected hasModule($name)

Checks that module is enabled.

param $name
return bool

See source

onReconfigure()

protected onReconfigure()

HOOK to be executed when config changes with _reconfigure.

See source

scalarizeArray()

protected scalarizeArray($array)

See source

validateConfig()

protected validateConfig()

Validates current config for required fields and required packages.

throws Exception\ModuleConfigException
throws ModuleException

See source

© 2011–2017 Michael Bodnarchuk and contributors
Licensed under the MIT License.
http://codeception.com/docs/reference/Module