Skip to content

Latest commit

 

History

History
984 lines (543 loc) · 25.1 KB

File metadata and controls

984 lines (543 loc) · 25.1 KB
layout doc
title Module - Codeception - Documentation

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 array|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 mixed $key
  • return mixed the config item's value or null if it doesn't exist

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.

{% 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)

 

Reference is taken from the source code. Help us to improve documentation. Edit module reference