Skip to content

Module.md

Latest commit

 

History

History
711 lines (407 loc) · 17.7 KB

Module.md

File metadata and controls

711 lines (407 loc) · 17.7 KB
Raw

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

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

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)

assertGreaterThenOrEqual()

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

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

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

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

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

 

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