| layout | doc |
|---|---|
| title | Module - Codeception - Documentation |
- 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.
public static $includeInheritedActions
By setting it to false module wan't inherit methods of parent class.
type bool
public static $onlyActions
Allows to explicitly set what methods have this class.
type array
public static $excludeActions
Allows to explicitly exclude actions from module.
type array
public static $aliases
Allows to rename actions
type array
public __construct($moduleContainer, $config = null)
Module constructor.
Requires module container (to provide access between modules of suite) and config.
param ModuleContainer$moduleContainerparam array|null$config
public _after($test)
HOOK executed after test
param TestInterface$test
public _afterStep($step)
HOOK executed after step
param Step$step
public _afterSuite()
HOOK executed after suite
public _before($test)
HOOK executed before test
param TestInterface$test
public _beforeStep($step)
HOOK executed before step
param Step$step
public _beforeSuite($settings = null)
HOOK executed before suite
param array$settings
public _failed($test, $fail)
HOOK executed when test fails but before _after
param TestInterface$testparam \Exception$fail
public _getConfig($key = null)
Get config values or specific config item.
param mixed$keyreturnmixed the config item's value or null if it doesn't exist
public _getName()
Returns a module name for a Module, a class name for Helper
returnstring
public _hasRequiredFields()
Checks if a module has required fields
returnbool
public _initialize()
HOOK triggered after module is created and configuration is loaded
public _reconfigure($config)
Allows to redefine config for a specific test. Config is restored at the end of a test.
{% highlight php %}
getMetadata()->getGroups()) { $this->getModule('Db')->_reconfigure(['cleanup' => true]); } } {% endhighlight %} * `param` $config * `throws` Exception\ModuleConfigException * `throws` ModuleException [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L120) #### _resetConfig() *public* _resetConfig() Reverts config changed by `_reconfigure` [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L138) #### _setConfig() *public* _setConfig($config) Allows to define initial module config. Can be used in `_beforeSuite` hook of Helpers or Extensions {% highlight php %} getModule('otherModule')->_setConfig($this->myOtherConfig); } {% endhighlight %} * `param` $config * `throws` Exception\ModuleConfigException * `throws` ModuleException [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L96) #### assert() *protected* assert($arguments, $not = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L10) #### assertArrayHasKey() *protected* assertArrayHasKey($key, $actual, $description = null) * `param` $key * `param` $actual * `param` $description [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L411) #### assertArrayNotHasKey() *protected* assertArrayNotHasKey($key, $actual, $description = null) * `param` $key * `param` $actual * `param` $description [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L421) #### assertArraySubset() *protected* assertArraySubset($subset, $array, $strict = null, $message = null) Checks that array contains subset. * `param array` $subset * `param array` $array * `param bool` $strict * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L434) #### assertContains() *protected* assertContains($needle, $haystack, $message = null) Checks that haystack contains needle * `param` $needle * `param` $haystack * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L137) #### assertCount() *protected* assertCount($expectedCount, $actual, $description = null) * `param` $expectedCount * `param` $actual * `param` $description [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L444) #### assertDoesNotMatchRegularExpression() *protected* assertDoesNotMatchRegularExpression($pattern, $string, $message = null) Checks that string not match with pattern Alias of assertNotRegExp * `param string` $pattern * `param string` $string * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L199) #### assertEmpty() *protected* assertEmpty($actual, $message = null) Checks that variable is empty. * `param` $actual * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L235) #### 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](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L39) #### assertEqualsCanonicalizing() *protected* assertEqualsCanonicalizing($expected, $actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L625) #### assertEqualsIgnoringCase() *protected* assertEqualsIgnoringCase($expected, $actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L635) #### assertEqualsWithDelta() *protected* assertEqualsWithDelta($expected, $actual, $delta, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L645) #### assertFalse() *protected* assertFalse($condition, $message = null) Checks that condition is negative. * `param` $condition * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L301) #### assertFileDoesNotExist() *protected* assertFileDoesNotExist($filename, $message = null) Checks if file doesn't exist Alias of assertFileNotExists * `param string` $filename * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L372) #### assertFileExists() *protected* assertFileExists($filename, $message = null) Checks if file exists * `param string` $filename * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L348) #### assertFileNotExists() *protected* assertFileNotExists($filename, $message = null) Checks if file doesn't exist * `param string` $filename * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L360) #### assertGreaterOrEquals() *protected* assertGreaterOrEquals($expected, $actual, $description = null) * `param` $expected * `param` $actual * `param` $description [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L382) #### assertGreaterThan() *protected* assertGreaterThan($expected, $actual, $message = null) Checks that actual is greater than expected * `param` $expected * `param` $actual * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L88) #### 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](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L100) #### assertInstanceOf() *protected* assertInstanceOf($class, $actual, $description = null) * `param` $class * `param` $actual * `param` $description [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L454) #### assertInternalType() *protected* assertInternalType($type, $actual, $description = null) * `param` $type * `param` $actual * `param` $description [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L474) #### assertIsArray() *protected* assertIsArray($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L525) #### assertIsBool() *protected* assertIsBool($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L530) #### assertIsCallable() *protected* assertIsCallable($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L570) #### assertIsEmpty() *protected* assertIsEmpty($actual, $description = null) * `param` $actual * `param` $description [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L401) #### assertIsFloat() *protected* assertIsFloat($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L535) #### assertIsInt() *protected* assertIsInt($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L540) #### assertIsNotArray() *protected* assertIsNotArray($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L575) #### assertIsNotBool() *protected* assertIsNotBool($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L580) #### assertIsNotCallable() *protected* assertIsNotCallable($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L620) #### assertIsNotFloat() *protected* assertIsNotFloat($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L585) #### assertIsNotInt() *protected* assertIsNotInt($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L590) #### assertIsNotNumeric() *protected* assertIsNotNumeric($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L595) #### assertIsNotObject() *protected* assertIsNotObject($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L600) #### assertIsNotResource() *protected* assertIsNotResource($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L605) #### assertIsNotScalar() *protected* assertIsNotScalar($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L615) #### assertIsNotString() *protected* assertIsNotString($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L610) #### assertIsNumeric() *protected* assertIsNumeric($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L545) #### assertIsObject() *protected* assertIsObject($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L550) #### assertIsResource() *protected* assertIsResource($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L555) #### assertIsScalar() *protected* assertIsScalar($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L565) #### assertIsString() *protected* assertIsString($actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L560) #### assertLessOrEquals() *protected* assertLessOrEquals($expected, $actual, $description = null) * `param` $expected * `param` $actual * `param` $description [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L392) #### assertLessThan() *protected* assertLessThan($expected, $actual, $message = null) Checks that actual is less than expected * `param` $expected * `param` $actual * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L112) #### 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](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L124) #### assertMatchesRegularExpression() *protected* assertMatchesRegularExpression($pattern, $string, $message = null) Checks that string match with pattern Alias of assertRegExp * `param string` $pattern * `param string` $string * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L174) #### assertNot() *protected* assertNot($arguments) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L26) #### assertNotContains() *protected* assertNotContains($needle, $haystack, $message = null) Checks that haystack doesn't contain needle. * `param` $needle * `param` $haystack * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L149) #### assertNotEmpty() *protected* assertNotEmpty($actual, $message = null) Checks that variable is not empty. * `param` $actual * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L246) #### 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](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L52) #### assertNotEqualsCanonicalizing() *protected* assertNotEqualsCanonicalizing($expected, $actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L630) #### assertNotEqualsIgnoringCase() *protected* assertNotEqualsIgnoringCase($expected, $actual, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L640) #### assertNotEqualsWithDelta() *protected* assertNotEqualsWithDelta($expected, $actual, $delta, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L650) #### assertNotFalse() *protected* assertNotFalse($condition, $message = null) Checks that the condition is NOT false (everything but false) * `param` $condition * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L312) #### assertNotInstanceOf() *protected* assertNotInstanceOf($class, $actual, $description = null) * `param` $class * `param` $actual * `param` $description [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L464) #### assertNotNull() *protected* assertNotNull($actual, $message = null) Checks that variable is not NULL * `param` $actual * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L268) #### 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](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L186) #### assertNotSame() *protected* assertNotSame($expected, $actual, $message = null) Checks that two variables are not same * `param` $expected * `param` $actual * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L76) #### assertNotTrue() *protected* assertNotTrue($condition, $message = null) Checks that the condition is NOT true (everything but true) * `param` $condition * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L290) #### assertNull() *protected* assertNull($actual, $message = null) Checks that variable is NULL * `param` $actual * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L257) #### assertRegExp() *protected* assertRegExp($pattern, $string, $message = null) Checks that string match with pattern * `param string` $pattern * `param string` $string * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L161) #### assertSame() *protected* assertSame($expected, $actual, $message = null) Checks that two variables are same * `param` $expected * `param` $actual * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L64) #### assertStringContainsString() *protected* assertStringContainsString($needle, $haystack, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L489) #### assertStringContainsStringIgnoringCase() *protected* assertStringContainsStringIgnoringCase($needle, $haystack, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L499) #### assertStringEndsNotWith() *protected* assertStringEndsNotWith($suffix, $string, $message = null) * `since` 1.1.0 of module-asserts [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L520) #### assertStringEndsWith() *protected* assertStringEndsWith($suffix, $string, $message = null) * `since` 1.1.0 of module-asserts [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L512) #### assertStringNotContainsString() *protected* assertStringNotContainsString($needle, $haystack, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L494) #### assertStringNotContainsStringIgnoringCase() *protected* assertStringNotContainsStringIgnoringCase($needle, $haystack, $message = null) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L504) #### assertStringStartsNotWith() *protected* assertStringStartsNotWith($prefix, $string, $message = null) Checks that a string doesn't start with the given prefix. * `param string` $prefix * `param string` $string * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L223) #### assertStringStartsWith() *protected* assertStringStartsWith($prefix, $string, $message = null) Checks that a string starts with the given prefix. * `param string` $prefix * `param string` $string * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L211) #### assertThat() *protected* assertThat($haystack, $constraint, $message = null) * `param` $haystack * `param` $constraint * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L323) #### assertThatItsNot() *protected* assertThatItsNot($haystack, $constraint, $message = null) Checks that haystack doesn't attend * `param` $haystack * `param` $constraint * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L335) #### assertTrue() *protected* assertTrue($condition, $message = null) Checks that condition is positive. * `param` $condition * `param string` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L279) #### debug() *protected* debug($message) Print debug message to the screen. * `param` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L273) #### debugSection() *protected* debugSection($title, $message) Print debug message with a title * `param` $title * `param` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L284) #### fail() *protected* fail($message) Fails the test with message. * `param` $message [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L484) #### getModule() *protected* getModule($name) Get another module by its name: {% highlight php %} getModule('WebDriver')->_findElements('.items'); {% endhighlight %} * `param` $name * `return` Module * `throws` ModuleException [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L337) #### getModules() *protected* getModules() Get all enabled modules * `return` array [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L320) #### hasModule() *protected* hasModule($name) Checks that module is enabled. * `param` $name * `return` bool [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L310) #### onReconfigure() *protected* onReconfigure() HOOK to be executed when config changes with `_reconfigure`. [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L130) #### scalarizeArray() *protected* scalarizeArray($array) [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L362) #### shortenMessage() *protected* shortenMessage($message, $chars = null) Short text message to an amount of chars * `param` $message * `param` $chars * `return` string [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L299) #### validateConfig() *protected* validateConfig() Validates current config for required fields and required packages. * `throws` Exception\ModuleConfigException * `throws` ModuleException [See source](https://github.com/Codeception/Codeception/blob/4.1/src/Codeception/Module.php#L149)