scenario->addStep(new \Codeception\Step\Action('getName', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Sets 'url' configuration parameter to hosts subdomain. * It does not open a page on subdomain. Use `amOnPage` for that * * ``` php * amOnSubdomain('user'); * $I->amOnPage('/'); * // moves to http://user.mysite.com/ * ?> * ``` * @param $subdomain * @return mixed * @see Codeception\Module\WebDriver::amOnSubdomain() * @return \Codeception\Maybe */ public function amOnSubdomain($subdomain) { $this->scenario->addStep(new \Codeception\Step\Condition('amOnSubdomain', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Makes a screenshot of current window and saves it to `tests/_log/debug`. * * ``` php * amOnPage('/user/edit'); * $I->makeScreenshot('edit page'); * // saved to: tests/_log/debug/UserEdit - edit page.png * ?> * ``` * * @param $name * @see Codeception\Module\WebDriver::makeScreenshot() * @return \Codeception\Maybe */ public function makeScreenshot($name) { $this->scenario->addStep(new \Codeception\Step\Action('makeScreenshot', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Resize current window * * Example: * ``` php * resizeWindow(800, 600); * * ``` * * @param int $width * @param int $height * @see Codeception\Module\WebDriver::resizeWindow() * @return \Codeception\Maybe */ public function resizeWindow($width, $height) { $this->scenario->addStep(new \Codeception\Step\Action('resizeWindow', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that cookie is set. * * @param $cookie * @return mixed * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeCookie() * @return \Codeception\Maybe */ public function canSeeCookie($cookie) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeCookie', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that cookie is set. * * @param $cookie * @return mixed * @see Codeception\Module\WebDriver::seeCookie() * @return \Codeception\Maybe */ public function seeCookie($cookie) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeCookie', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that cookie doesn't exist * * @param $cookie * @return mixed * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeCookie() * @return \Codeception\Maybe */ public function cantSeeCookie($cookie) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeCookie', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that cookie doesn't exist * * @param $cookie * @return mixed * @see Codeception\Module\WebDriver::dontSeeCookie() * @return \Codeception\Maybe */ public function dontSeeCookie($cookie) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeCookie', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Sets a cookie. * * @param $cookie * @param $value * @return mixed * @see Codeception\Module\WebDriver::setCookie() * @return \Codeception\Maybe */ public function setCookie($cookie, $value) { $this->scenario->addStep(new \Codeception\Step\Action('setCookie', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Unsets cookie * * @param $cookie * @return mixed * @see Codeception\Module\WebDriver::resetCookie() * @return \Codeception\Maybe */ public function resetCookie($cookie) { $this->scenario->addStep(new \Codeception\Step\Action('resetCookie', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Grabs a cookie value. * * @param $cookie * @return mixed * @see Codeception\Module\WebDriver::grabCookie() * @return \Codeception\Maybe */ public function grabCookie($cookie) { $this->scenario->addStep(new \Codeception\Step\Action('grabCookie', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Opens the page. * Requires relative uri as parameter * * Example: * * ``` php * amOnPage('/'); * // opens /register page * $I->amOnPage('/register'); * ?> * ``` * * @param $page * @see Codeception\Module\WebDriver::amOnPage() * @return \Codeception\Maybe */ public function amOnPage($page) { $this->scenario->addStep(new \Codeception\Step\Condition('amOnPage', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Check if current page contains the text specified. * Specify the css selector to match only specific region. * * Examples: * * ``` php * see('Logout'); // I can suppose user is logged in * $I->see('Sign Up','h1'); // I can suppose it's a signup page * $I->see('Sign Up','//body/h1'); // with XPath * ?> * ``` * * @param $text * @param null $selector * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::see() * @return \Codeception\Maybe */ public function canSee($text, $selector = null) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('see', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Check if current page contains the text specified. * Specify the css selector to match only specific region. * * Examples: * * ``` php * see('Logout'); // I can suppose user is logged in * $I->see('Sign Up','h1'); // I can suppose it's a signup page * $I->see('Sign Up','//body/h1'); // with XPath * ?> * ``` * * @param $text * @param null $selector * @see Codeception\Module\WebDriver::see() * @return \Codeception\Maybe */ public function see($text, $selector = null) { $this->scenario->addStep(new \Codeception\Step\Assertion('see', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Check if current page doesn't contain the text specified. * Specify the css selector to match only specific region. * * Examples: * * ```php * dontSee('Login'); // I can suppose user is already logged in * $I->dontSee('Sign Up','h1'); // I can suppose it's not a signup page * $I->dontSee('Sign Up','//body/h1'); // with XPath * ?> * ``` * * @param $text * @param null $selector * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSee() * @return \Codeception\Maybe */ public function cantSee($text, $selector = null) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSee', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Check if current page doesn't contain the text specified. * Specify the css selector to match only specific region. * * Examples: * * ```php * dontSee('Login'); // I can suppose user is already logged in * $I->dontSee('Sign Up','h1'); // I can suppose it's not a signup page * $I->dontSee('Sign Up','//body/h1'); // with XPath * ?> * ``` * * @param $text * @param null $selector * @see Codeception\Module\WebDriver::dontSee() * @return \Codeception\Maybe */ public function dontSee($text, $selector = null) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSee', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Perform a click on link or button. * Link or button are found by their names or CSS selector. * Submits a form if button is a submit type. * * If link is an image it's found by alt attribute value of image. * If button is image button is found by it's value * If link or button can't be found by name they are searched by CSS selector. * * The second parameter is a context: CSS or XPath locator to narrow the search. * * Examples: * * ``` php * click('Logout'); * // button of form * $I->click('Submit'); * // CSS button * $I->click('#form input[type=submit]'); * // XPath * $I->click('//form/*[@type=submit]') * // link in context * $I->click('Logout', '#nav'); * ?> * ``` * @param $link * @param $context * @see Codeception\Module\WebDriver::click() * @return \Codeception\Maybe */ public function click($link, $context = null) { $this->scenario->addStep(new \Codeception\Step\Action('click', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if there is a link with text specified. * Specify url to match link with exact this url. * * Examples: * * ``` php * seeLink('Logout'); // matches Logout * $I->seeLink('Logout','/logout'); // matches Logout * ?> * ``` * * @param $text * @param null $url * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeLink() * @return \Codeception\Maybe */ public function canSeeLink($text, $url = null) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeLink', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if there is a link with text specified. * Specify url to match link with exact this url. * * Examples: * * ``` php * seeLink('Logout'); // matches Logout * $I->seeLink('Logout','/logout'); // matches Logout * ?> * ``` * * @param $text * @param null $url * @see Codeception\Module\WebDriver::seeLink() * @return \Codeception\Maybe */ public function seeLink($text, $url = null) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeLink', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if page doesn't contain the link with text specified. * Specify url to narrow the results. * * Examples: * * ``` php * dontSeeLink('Logout'); // I suppose user is not logged in * ?> * ``` * * @param $text * @param null $url * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeLink() * @return \Codeception\Maybe */ public function cantSeeLink($text, $url = null) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeLink', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if page doesn't contain the link with text specified. * Specify url to narrow the results. * * Examples: * * ``` php * dontSeeLink('Logout'); // I suppose user is not logged in * ?> * ``` * * @param $text * @param null $url * @see Codeception\Module\WebDriver::dontSeeLink() * @return \Codeception\Maybe */ public function dontSeeLink($text, $url = null) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeLink', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current uri contains a value * * ``` php * seeInCurrentUrl('home'); * // to match: /users/1 * $I->seeInCurrentUrl('/users/'); * ?> * ``` * * @param $uri * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeInCurrentUrl() * @return \Codeception\Maybe */ public function canSeeInCurrentUrl($uri) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeInCurrentUrl', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current uri contains a value * * ``` php * seeInCurrentUrl('home'); * // to match: /users/1 * $I->seeInCurrentUrl('/users/'); * ?> * ``` * * @param $uri * @see Codeception\Module\WebDriver::seeInCurrentUrl() * @return \Codeception\Maybe */ public function seeInCurrentUrl($uri) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeInCurrentUrl', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current url is equal to value. * Unlike `seeInCurrentUrl` performs a strict check. * * ``` php * seeCurrentUrlEquals('/'); * ?> * ``` * * @param $uri * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeCurrentUrlEquals() * @return \Codeception\Maybe */ public function canSeeCurrentUrlEquals($uri) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeCurrentUrlEquals', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current url is equal to value. * Unlike `seeInCurrentUrl` performs a strict check. * * ``` php * seeCurrentUrlEquals('/'); * ?> * ``` * * @param $uri * @see Codeception\Module\WebDriver::seeCurrentUrlEquals() * @return \Codeception\Maybe */ public function seeCurrentUrlEquals($uri) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeCurrentUrlEquals', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current url is matches a RegEx value * * ``` php * seeCurrentUrlMatches('~$/users/(\d+)~'); * ?> * ``` * * @param $uri * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeCurrentUrlMatches() * @return \Codeception\Maybe */ public function canSeeCurrentUrlMatches($uri) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeCurrentUrlMatches', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current url is matches a RegEx value * * ``` php * seeCurrentUrlMatches('~$/users/(\d+)~'); * ?> * ``` * * @param $uri * @see Codeception\Module\WebDriver::seeCurrentUrlMatches() * @return \Codeception\Maybe */ public function seeCurrentUrlMatches($uri) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeCurrentUrlMatches', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current uri does not contain a value * * ``` php * dontSeeInCurrentUrl('/users/'); * ?> * ``` * * @param $uri * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeInCurrentUrl() * @return \Codeception\Maybe */ public function cantSeeInCurrentUrl($uri) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeInCurrentUrl', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current uri does not contain a value * * ``` php * dontSeeInCurrentUrl('/users/'); * ?> * ``` * * @param $uri * @see Codeception\Module\WebDriver::dontSeeInCurrentUrl() * @return \Codeception\Maybe */ public function dontSeeInCurrentUrl($uri) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeInCurrentUrl', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current url is not equal to value. * Unlike `dontSeeInCurrentUrl` performs a strict check. * * ``` php * dontSeeCurrentUrlEquals('/'); * ?> * ``` * * @param $uri * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeCurrentUrlEquals() * @return \Codeception\Maybe */ public function cantSeeCurrentUrlEquals($uri) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeCurrentUrlEquals', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current url is not equal to value. * Unlike `dontSeeInCurrentUrl` performs a strict check. * * ``` php * dontSeeCurrentUrlEquals('/'); * ?> * ``` * * @param $uri * @see Codeception\Module\WebDriver::dontSeeCurrentUrlEquals() * @return \Codeception\Maybe */ public function dontSeeCurrentUrlEquals($uri) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeCurrentUrlEquals', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current url does not match a RegEx value * * ``` php * dontSeeCurrentUrlMatches('~$/users/(\d+)~'); * ?> * ``` * * @param $uri * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeCurrentUrlMatches() * @return \Codeception\Maybe */ public function cantSeeCurrentUrlMatches($uri) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeCurrentUrlMatches', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that current url does not match a RegEx value * * ``` php * dontSeeCurrentUrlMatches('~$/users/(\d+)~'); * ?> * ``` * * @param $uri * @see Codeception\Module\WebDriver::dontSeeCurrentUrlMatches() * @return \Codeception\Maybe */ public function dontSeeCurrentUrlMatches($uri) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeCurrentUrlMatches', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Takes a parameters from current URI by RegEx. * If no url provided returns full URI. * * ``` php * grabFromCurrentUrl('~$/user/(\d+)/~'); * $uri = $I->grabFromCurrentUrl(); * ?> * ``` * * @param null $uri * @internal param $url * @return mixed * @see Codeception\Module\WebDriver::grabFromCurrentUrl() * @return \Codeception\Maybe */ public function grabFromCurrentUrl($uri = null) { $this->scenario->addStep(new \Codeception\Step\Action('grabFromCurrentUrl', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Assert if the specified checkbox is checked. * Use css selector or xpath to match. * * Example: * * ``` php * seeCheckboxIsChecked('#agree'); // I suppose user agreed to terms * $I->seeCheckboxIsChecked('#signup_form input[type=checkbox]'); // I suppose user agreed to terms, If there is only one checkbox in form. * $I->seeCheckboxIsChecked('//form/input[@type=checkbox and @name=agree]'); * ?> * ``` * * @param $checkbox * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeCheckboxIsChecked() * @return \Codeception\Maybe */ public function canSeeCheckboxIsChecked($checkbox) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeCheckboxIsChecked', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Assert if the specified checkbox is checked. * Use css selector or xpath to match. * * Example: * * ``` php * seeCheckboxIsChecked('#agree'); // I suppose user agreed to terms * $I->seeCheckboxIsChecked('#signup_form input[type=checkbox]'); // I suppose user agreed to terms, If there is only one checkbox in form. * $I->seeCheckboxIsChecked('//form/input[@type=checkbox and @name=agree]'); * ?> * ``` * * @param $checkbox * @see Codeception\Module\WebDriver::seeCheckboxIsChecked() * @return \Codeception\Maybe */ public function seeCheckboxIsChecked($checkbox) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeCheckboxIsChecked', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Assert if the specified checkbox is unchecked. * Use css selector or xpath to match. * * Example: * * ``` php * dontSeeCheckboxIsChecked('#agree'); // I suppose user didn't agree to terms * $I->seeCheckboxIsChecked('#signup_form input[type=checkbox]'); // I suppose user didn't check the first checkbox in form. * ?> * ``` * * @param $checkbox * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeCheckboxIsChecked() * @return \Codeception\Maybe */ public function cantSeeCheckboxIsChecked($checkbox) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeCheckboxIsChecked', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Assert if the specified checkbox is unchecked. * Use css selector or xpath to match. * * Example: * * ``` php * dontSeeCheckboxIsChecked('#agree'); // I suppose user didn't agree to terms * $I->seeCheckboxIsChecked('#signup_form input[type=checkbox]'); // I suppose user didn't check the first checkbox in form. * ?> * ``` * * @param $checkbox * @see Codeception\Module\WebDriver::dontSeeCheckboxIsChecked() * @return \Codeception\Maybe */ public function dontSeeCheckboxIsChecked($checkbox) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeCheckboxIsChecked', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that an input field or textarea contains value. * Field is matched either by label or CSS or Xpath * * Example: * * ``` php * seeInField('Body','Type your comment here'); * $I->seeInField('form textarea[name=body]','Type your comment here'); * $I->seeInField('form input[type=hidden]','hidden_value'); * $I->seeInField('#searchform input','Search'); * $I->seeInField('//form/*[@name=search]','Search'); * ?> * ``` * * @param $field * @param $value * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeInField() * @return \Codeception\Maybe */ public function canSeeInField($field, $value) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeInField', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that an input field or textarea contains value. * Field is matched either by label or CSS or Xpath * * Example: * * ``` php * seeInField('Body','Type your comment here'); * $I->seeInField('form textarea[name=body]','Type your comment here'); * $I->seeInField('form input[type=hidden]','hidden_value'); * $I->seeInField('#searchform input','Search'); * $I->seeInField('//form/*[@name=search]','Search'); * ?> * ``` * * @param $field * @param $value * @see Codeception\Module\WebDriver::seeInField() * @return \Codeception\Maybe */ public function seeInField($field, $value) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeInField', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that an input field or textarea doesn't contain value. * Field is matched either by label or CSS or Xpath * Example: * * ``` php * dontSeeInField('Body','Type your comment here'); * $I->dontSeeInField('form textarea[name=body]','Type your comment here'); * $I->dontSeeInField('form input[type=hidden]','hidden_value'); * $I->dontSeeInField('#searchform input','Search'); * $I->dontSeeInField('//form/*[@name=search]','Search'); * ?> * ``` * * @param $field * @param $value * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeInField() * @return \Codeception\Maybe */ public function cantSeeInField($field, $value) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeInField', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that an input field or textarea doesn't contain value. * Field is matched either by label or CSS or Xpath * Example: * * ``` php * dontSeeInField('Body','Type your comment here'); * $I->dontSeeInField('form textarea[name=body]','Type your comment here'); * $I->dontSeeInField('form input[type=hidden]','hidden_value'); * $I->dontSeeInField('#searchform input','Search'); * $I->dontSeeInField('//form/*[@name=search]','Search'); * ?> * ``` * * @param $field * @param $value * @see Codeception\Module\WebDriver::dontSeeInField() * @return \Codeception\Maybe */ public function dontSeeInField($field, $value) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeInField', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Selects an option in select tag or in radio button group. * * Example: * * ``` php * selectOption('form select[name=account]', 'Premium'); * $I->selectOption('form input[name=payment]', 'Monthly'); * $I->selectOption('//form/select[@name=account]', 'Monthly'); * ?> * ``` * * Can select multiple options if second argument is array: * * ``` php * selectOption('Which OS do you use?', array('Windows','Linux')); * ?> * ``` * * @param $select * @param $option * @see Codeception\Module\WebDriver::selectOption() * @return \Codeception\Maybe */ public function selectOption($select, $option) { $this->scenario->addStep(new \Codeception\Step\Action('selectOption', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * * @see Codeception\Module\WebDriver::unselectOption() * @return \Codeception\Maybe */ public function unselectOption($select, $option) { $this->scenario->addStep(new \Codeception\Step\Action('unselectOption', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Ticks a checkbox. * For radio buttons use `selectOption` method. * * Example: * * ``` php * checkOption('#agree'); * ?> * ``` * * @param $option * @see Codeception\Module\WebDriver::checkOption() * @return \Codeception\Maybe */ public function checkOption($option) { $this->scenario->addStep(new \Codeception\Step\Action('checkOption', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Unticks a checkbox. * * Example: * * ``` php * uncheckOption('#notify'); * ?> * ``` * * @param $option * @see Codeception\Module\WebDriver::uncheckOption() * @return \Codeception\Maybe */ public function uncheckOption($option) { $this->scenario->addStep(new \Codeception\Step\Action('uncheckOption', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Fills a text field or textarea with value. * * Example: * * ``` php * fillField("//input[@type='text']", "Hello World!"); * ?> * ``` * * @param $field * @param $value * @see Codeception\Module\WebDriver::fillField() * @return \Codeception\Maybe */ public function fillField($field, $value) { $this->scenario->addStep(new \Codeception\Step\Action('fillField', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Attaches file from Codeception data directory to upload field. * * Example: * * ``` php * attachFile('input[@type="file"]', 'prices.xls'); * ?> * ``` * * @param $field * @param $filename * @see Codeception\Module\WebDriver::attachFile() * @return \Codeception\Maybe */ public function attachFile($field, $filename) { $this->scenario->addStep(new \Codeception\Step\Action('attachFile', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Finds and returns text contents of element. * Element is searched by CSS selector, XPath or matcher by regex. * * Example: * * ``` php * grabTextFrom('h1'); * $heading = $I->grabTextFrom('descendant-or-self::h1'); * $value = $I->grabTextFrom('~ * ``` * * @param $cssOrXPathOrRegex * @return mixed * @see Codeception\Module\WebDriver::grabTextFrom() * @return \Codeception\Maybe */ public function grabTextFrom($cssOrXPathOrRegex) { $this->scenario->addStep(new \Codeception\Step\Action('grabTextFrom', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Finds and returns field and returns it's value. * Searches by field name, then by CSS, then by XPath * * Example: * * ``` php * grabValueFrom('Name'); * $name = $I->grabValueFrom('input[name=username]'); * $name = $I->grabValueFrom('descendant-or-self::form/descendant::input[@name = 'username']'); * ?> * ``` * * @param $field * @return mixed * @see Codeception\Module\WebDriver::grabValueFrom() * @return \Codeception\Maybe */ public function grabValueFrom($field) { $this->scenario->addStep(new \Codeception\Step\Action('grabValueFrom', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks for a visible element on a page, matching it by CSS or XPath * * ``` php * seeElement('.error'); * $I->seeElement('//form/input[1]'); * ?> * ``` * @param $selector * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeElement() * @return \Codeception\Maybe */ public function canSeeElement($selector) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeElement', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks for a visible element on a page, matching it by CSS or XPath * * ``` php * seeElement('.error'); * $I->seeElement('//form/input[1]'); * ?> * ``` * @param $selector * @see Codeception\Module\WebDriver::seeElement() * @return \Codeception\Maybe */ public function seeElement($selector) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeElement', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that element is invisible or not present on page. * * ``` php * dontSeeElement('.error'); * $I->dontSeeElement('//form/input[1]'); * ?> * ``` * * @param $selector * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeElement() * @return \Codeception\Maybe */ public function cantSeeElement($selector) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeElement', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that element is invisible or not present on page. * * ``` php * dontSeeElement('.error'); * $I->dontSeeElement('//form/input[1]'); * ?> * ``` * * @param $selector * @see Codeception\Module\WebDriver::dontSeeElement() * @return \Codeception\Maybe */ public function dontSeeElement($selector) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeElement', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if element exists on a page even it is invisible. * * ``` php * seeElementInDOM('//form/input[type=hidden]'); * ?> * ``` * * @param $selector * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeElementInDOM() * @return \Codeception\Maybe */ public function canSeeElementInDOM($selector) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeElementInDOM', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if element exists on a page even it is invisible. * * ``` php * seeElementInDOM('//form/input[type=hidden]'); * ?> * ``` * * @param $selector * @see Codeception\Module\WebDriver::seeElementInDOM() * @return \Codeception\Maybe */ public function seeElementInDOM($selector) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeElementInDOM', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Opposite to `seeElementInDOM`. * * @param $selector * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeElementInDOM() * @return \Codeception\Maybe */ public function cantSeeElementInDOM($selector) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeElementInDOM', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Opposite to `seeElementInDOM`. * * @param $selector * @see Codeception\Module\WebDriver::dontSeeElementInDOM() * @return \Codeception\Maybe */ public function dontSeeElementInDOM($selector) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeElementInDOM', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if option is selected in select field. * * ``` php * seeOptionIsSelected('#form input[name=payment]', 'Visa'); * ?> * ``` * * @param $selector * @param $optionText * @return mixed * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeOptionIsSelected() * @return \Codeception\Maybe */ public function canSeeOptionIsSelected($selector, $optionText) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeOptionIsSelected', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if option is selected in select field. * * ``` php * seeOptionIsSelected('#form input[name=payment]', 'Visa'); * ?> * ``` * * @param $selector * @param $optionText * @return mixed * @see Codeception\Module\WebDriver::seeOptionIsSelected() * @return \Codeception\Maybe */ public function seeOptionIsSelected($selector, $optionText) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeOptionIsSelected', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if option is not selected in select field. * * ``` php * dontSeeOptionIsSelected('#form input[name=payment]', 'Visa'); * ?> * ``` * * @param $selector * @param $optionText * @return mixed * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeOptionIsSelected() * @return \Codeception\Maybe */ public function cantSeeOptionIsSelected($selector, $optionText) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeOptionIsSelected', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks if option is not selected in select field. * * ``` php * dontSeeOptionIsSelected('#form input[name=payment]', 'Visa'); * ?> * ``` * * @param $selector * @param $optionText * @return mixed * @see Codeception\Module\WebDriver::dontSeeOptionIsSelected() * @return \Codeception\Maybe */ public function dontSeeOptionIsSelected($selector, $optionText) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeOptionIsSelected', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that page title contains text. * * ``` php * seeInTitle('Blog - Post #1'); * ?> * ``` * * @param $title * @return mixed * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeInTitle() * @return \Codeception\Maybe */ public function canSeeInTitle($title) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeInTitle', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that page title contains text. * * ``` php * seeInTitle('Blog - Post #1'); * ?> * ``` * * @param $title * @return mixed * @see Codeception\Module\WebDriver::seeInTitle() * @return \Codeception\Maybe */ public function seeInTitle($title) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeInTitle', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that page title does not contain text. * * @param $title * @return mixed * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::dontSeeInTitle() * @return \Codeception\Maybe */ public function cantSeeInTitle($title) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('dontSeeInTitle', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that page title does not contain text. * * @param $title * @return mixed * @see Codeception\Module\WebDriver::dontSeeInTitle() * @return \Codeception\Maybe */ public function dontSeeInTitle($title) { $this->scenario->addStep(new \Codeception\Step\Assertion('dontSeeInTitle', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Accepts JavaScript native popup window created by `window.alert`|`window.confirm`|`window.prompt`. * Don't confuse it with modal windows, created by [various libraries](http://jster.net/category/windows-modals-popups). * * @see Codeception\Module\WebDriver::acceptPopup() * @return \Codeception\Maybe */ public function acceptPopup() { $this->scenario->addStep(new \Codeception\Step\Action('acceptPopup', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Dismisses active JavaScript popup created by `window.alert`|`window.confirm`|`window.prompt`. * @see Codeception\Module\WebDriver::cancelPopup() * @return \Codeception\Maybe */ public function cancelPopup() { $this->scenario->addStep(new \Codeception\Step\Action('cancelPopup', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that active JavaScript popup created by `window.alert`|`window.confirm`|`window.prompt` contain text. * * @param $text * Conditional Assertion: Test won't be stopped on fail * @see Codeception\Module\WebDriver::seeInPopup() * @return \Codeception\Maybe */ public function canSeeInPopup($text) { $this->scenario->addStep(new \Codeception\Step\ConditionalAssertion('seeInPopup', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Checks that active JavaScript popup created by `window.alert`|`window.confirm`|`window.prompt` contain text. * * @param $text * @see Codeception\Module\WebDriver::seeInPopup() * @return \Codeception\Maybe */ public function seeInPopup($text) { $this->scenario->addStep(new \Codeception\Step\Assertion('seeInPopup', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Enters text into native JavaScript prompt popup created by `window.prompt`. * * @param $keys * @see Codeception\Module\WebDriver::typeInPopup() * @return \Codeception\Maybe */ public function typeInPopup($keys) { $this->scenario->addStep(new \Codeception\Step\Action('typeInPopup', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Reloads current page * @see Codeception\Module\WebDriver::reloadPage() * @return \Codeception\Maybe */ public function reloadPage() { $this->scenario->addStep(new \Codeception\Step\Action('reloadPage', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Moves back in history * @see Codeception\Module\WebDriver::moveBack() * @return \Codeception\Maybe */ public function moveBack() { $this->scenario->addStep(new \Codeception\Step\Action('moveBack', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Moves forward in history * @see Codeception\Module\WebDriver::moveForward() * @return \Codeception\Maybe */ public function moveForward() { $this->scenario->addStep(new \Codeception\Step\Action('moveForward', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Submits a form located on page. * Specify the form by it's css or xpath selector. * Fill the form fields values as array. Hidden fields can't be accessed. * * This command itself triggers the request to form's action. * * Examples: * * ``` php * submitForm('#login', array('login' => 'davert', 'password' => '123456')); * * ``` * * For sample Sign Up form: * * ``` html *
* Login:
* Password:
* Do you agree to out terms?
* Select pricing plan * *
* ``` * You can write this: * * ``` php * submitForm('#userForm', array('user' => array('login' => 'Davert', 'password' => '123456', 'agree' => true))); * * ``` * * @param $selector * @param $params * @throws \Codeception\Exception\ElementNotFound * @see Codeception\Module\WebDriver::submitForm() * @return \Codeception\Maybe */ public function submitForm($selector, $params) { $this->scenario->addStep(new \Codeception\Step\Action('submitForm', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Waits until element has changed according to callback function or for $time seconds to pass. * * ``` php * waitForElementChange('#menu', function(\WebDriverElement $el) { * return $el->isDisplayed(); * }, 100); * ?> * ``` * * @param $element * @param \Closure $callback * @param int $timeout seconds * @throws \Codeception\Exception\ElementNotFound * @see Codeception\Module\WebDriver::waitForElementChange() * @return \Codeception\Maybe */ public function waitForElementChange($element, $callback, $timeout = null) { $this->scenario->addStep(new \Codeception\Step\Action('waitForElementChange', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Waits for element to appear on page for $timeout seconds to pass. * If element not appears, timeout exception is thrown. * * ``` php * waitForElement('#agree_button', 30); // secs * $I->click('#agree_button'); * ?> * ``` * * @param $element * @param int $timeout seconds * @throws \Exception * @see Codeception\Module\WebDriver::waitForElement() * @return \Codeception\Maybe */ public function waitForElement($element, $timeout = null) { $this->scenario->addStep(new \Codeception\Step\Action('waitForElement', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Waits for element to be visible on the page for $timeout seconds to pass. * If element doesn't appear, timeout exception is thrown. * * ``` php * waitForElementVisible('#agree_button', 30); // secs * $I->click('#agree_button'); * ?> * ``` * * @param $element * @param int $timeout seconds * @throws \Exception * @see Codeception\Module\WebDriver::waitForElementVisible() * @return \Codeception\Maybe */ public function waitForElementVisible($element, $timeout = null) { $this->scenario->addStep(new \Codeception\Step\Action('waitForElementVisible', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Waits for element to not be visible on the page for $timeout seconds to pass. * If element stays visible, timeout exception is thrown. * * ``` php * waitForElementNotVisible('#agree_button', 30); // secs * ?> * ``` * * @param $element * @param int $timeout seconds * @throws \Exception * @see Codeception\Module\WebDriver::waitForElementNotVisible() * @return \Codeception\Maybe */ public function waitForElementNotVisible($element, $timeout = null) { $this->scenario->addStep(new \Codeception\Step\Action('waitForElementNotVisible', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Waits for text to appear on the page for a specific amount of time. * Can also be passed a selector to search in. * If text does not appear, timeout exception is thrown. * * ``` php * waitForText('foo', 30); // secs * $I->waitForText('foo', 30, '.title'); // secs * ?> * ``` * * @param string $text * @param int $timeout seconds * @param null $selector * @throws \Exception * @internal param string $element * @see Codeception\Module\WebDriver::waitForText() * @return \Codeception\Maybe */ public function waitForText($text, $timeout = null, $selector = null) { $this->scenario->addStep(new \Codeception\Step\Action('waitForText', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Explicit wait. * * @param $timeout secs * @see Codeception\Module\WebDriver::wait() * @return \Codeception\Maybe */ public function wait($timeout) { $this->scenario->addStep(new \Codeception\Step\Action('wait', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Low-level API method. * If Codeception commands are not enough, use Selenium WebDriver methods directly * * ``` php * $I->executeInSelenium(function(\WebDriver $webdriver) { * $webdriver->get('http://google.com'); * }); * ``` * * Use [WebDriver Session API](https://github.com/facebook/php-webdriver) * Not recommended this command too be used on regular basis. * If Codeception lacks important Selenium methods implement then and submit patches. * * @param callable $function * @see Codeception\Module\WebDriver::executeInSelenium() * @return \Codeception\Maybe */ public function executeInSelenium($function) { $this->scenario->addStep(new \Codeception\Step\Action('executeInSelenium', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Switch to another window identified by its name. * * The window can only be identified by its name. If the $name parameter is blank it will switch to the parent window. * * Example: * ``` html * * ``` * * ``` php * click("Open window"); * # switch to another window * $I->switchToWindow("another_window"); * # switch to parent window * $I->switchToWindow(); * ?> * ``` * * If the window has no name, the only way to access it is via the `executeInSelenium()` method like so: * * ``` * executeInSelenium(function (\Webdriver $webdriver) { * $handles=$webDriver->getWindowHandles(); * $last_window = end($handles); * $webDriver->switchTo()->window($name); * }); * ?> * ``` * * @param string|null $name * @see Codeception\Module\WebDriver::switchToWindow() * @return \Codeception\Maybe */ public function switchToWindow($name = null) { $this->scenario->addStep(new \Codeception\Step\Action('switchToWindow', func_get_args())); if ($this->scenario->running()) { $result = $this->scenario->runStep(); return new Maybe($result); } return new Maybe(); } /** * This method is generated. * Documentation taken from corresponding module. * ---------------------------------------------- * * Switch to another frame * * Example: * ``` html *