Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
A
app
Project
Project
Details
Activity
Releases
Cycle Analytics
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Charts
Merge Requests
0
Merge Requests
0
CI / CD
CI / CD
Pipelines
Jobs
Schedules
Charts
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Charts
Jobs
Commits
Open sidebar
phundament
app
Commits
6c27ec9c
Commit
6c27ec9c
authored
Jun 16, 2015
by
Tobias Munk
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
added tester classes
parent
794ee632
Pipeline
#1379
failed with stage
Changes
4
Pipelines
1
Hide whitespace changes
Inline
Side-by-side
Showing
4 changed files
with
4640 additions
and
4 deletions
+4640
-4
.gitignore
tests/codeception/.gitignore
+0
-4
AcceptanceTester.php
tests/codeception/acceptance/AcceptanceTester.php
+2374
-0
FunctionalTester.php
tests/codeception/functional/FunctionalTester.php
+2238
-0
UnitTester.php
tests/codeception/unit/UnitTester.php
+28
-0
No files found.
tests/codeception/.gitignore
deleted
100755 → 0
View file @
794ee632
# these files are auto generated by codeception build
/unit/UnitTester.php
/functional/FunctionalTester.php
/acceptance/AcceptanceTester.php
tests/codeception/acceptance/AcceptanceTester.php
0 → 100644
View file @
6c27ec9c
<?php
//[STAMP] 3a39e317bc853ed5067628776ad30575
// This class was automatically generated by build task
// You should not change it manually as it will be overwritten on next build
// @codingStandardsIgnoreFile
use
Codeception\Module\WebDriver
;
/**
* Inherited Methods
* @method void wantToTest($text)
* @method void wantTo($text)
* @method void execute($callable)
* @method void expectTo($prediction)
* @method void expect($prediction)
* @method void amGoingTo($argumentation)
* @method void am($role)
* @method void lookForwardTo($achieveValue)
* @method void comment($description)
* @method void haveFriend($name, $actorClass = null)
*
* @SuppressWarnings(PHPMD)
*/
class
AcceptanceTester
extends
\Codeception\Actor
{
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Changes the subdomain for the 'url' configuration parameter.
* Does not open a page; use `amOnPage` for that.
*
* ``` php
* <?php
* // If config is: 'http://mysite.com'
* // or config is: 'http://www.mysite.com'
* // or config is: 'http://company.mysite.com'
*
* $I->amOnSubdomain('user');
* $I->amOnPage('/');
* // moves to http://user.mysite.com/
* ?>
* ```
*
* @param $subdomain
*
* @return mixed
* @see \Codeception\Module\WebDriver::amOnSubdomain()
*/
public
function
amOnSubdomain
(
$subdomain
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Condition
(
'amOnSubdomain'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Takes a screenshot of the current window and saves it to `tests/_output/debug`.
*
* ``` php
* <?php
* $I->amOnPage('/user/edit');
* $I->makeScreenshot('edit_page');
* // saved to: tests/_output/debug/edit_page.png
* ?>
* ```
*
* @param $name
* @see \Codeception\Module\WebDriver::makeScreenshot()
*/
public
function
makeScreenshot
(
$name
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'makeScreenshot'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Resize the current window.
*
* ``` php
* <?php
* $I->resizeWindow(800, 600);
*
* ```
*
* @param int $width
* @param int $height
* @see \Codeception\Module\WebDriver::resizeWindow()
*/
public
function
resizeWindow
(
$width
,
$height
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'resizeWindow'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that a cookie with the given name is set.
* You can set additional cookie params like `domain`, `path` as array passed in last argument.
*
* ``` php
* <?php
* $I->seeCookie('PHPSESSID');
* ?>
* ```
*
* @param $cookie
* @param array $params
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeCookie()
*/
public
function
canSeeCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that a cookie with the given name is set.
* You can set additional cookie params like `domain`, `path` as array passed in last argument.
*
* ``` php
* <?php
* $I->seeCookie('PHPSESSID');
* ?>
* ```
*
* @param $cookie
* @param array $params
* @return mixed
* @see \Codeception\Module\WebDriver::seeCookie()
*/
public
function
seeCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there isn't a cookie with the given name.
* You can set additional cookie params like `domain`, `path` as array passed in last argument.
*
* @param $cookie
*
* @param array $params
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeCookie()
*/
public
function
cantSeeCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there isn't a cookie with the given name.
* You can set additional cookie params like `domain`, `path` as array passed in last argument.
*
* @param $cookie
*
* @param array $params
* @return mixed
* @see \Codeception\Module\WebDriver::dontSeeCookie()
*/
public
function
dontSeeCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Sets a cookie with the given name and value.
* You can set additional cookie params like `domain`, `path`, `expire`, `secure` in array passed as last argument.
*
* ``` php
* <?php
* $I->setCookie('PHPSESSID', 'el4ukv0kqbvoirg7nkp4dncpk3');
* ?>
* ```
*
* @param $name
* @param $val
* @param array $params
* @internal param $cookie
* @internal param $value
*
* @return mixed
* @see \Codeception\Module\WebDriver::setCookie()
*/
public
function
setCookie
(
$cookie
,
$value
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'setCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Unsets cookie with the given name.
* You can set additional cookie params like `domain`, `path` in array passed as last argument.
*
* @param $cookie
*
* @param array $params
* @return mixed
* @see \Codeception\Module\WebDriver::resetCookie()
*/
public
function
resetCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'resetCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Grabs a cookie value.
* You can set additional cookie params like `domain`, `path` in array passed as last argument.
*
* @param $cookie
*
* @param array $params
* @return mixed
* @see \Codeception\Module\WebDriver::grabCookie()
*/
public
function
grabCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Open web page at the given absolute URL and sets its hostname as the base host.
*
* ``` php
* <?php
* $I->amOnUrl('http://codeception.com');
* $I->amOnPage('/quickstart'); // moves to http://codeception.com/quickstart
* ?>
* ```
* @see \Codeception\Module\WebDriver::amOnUrl()
*/
public
function
amOnUrl
(
$url
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Condition
(
'amOnUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Opens the page for the given relative URI.
*
* ``` php
* <?php
* // opens front page
* $I->amOnPage('/');
* // opens /register page
* $I->amOnPage('/register');
* ?>
* ```
*
* @param $page
* @see \Codeception\Module\WebDriver::amOnPage()
*/
public
function
amOnPage
(
$page
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Condition
(
'amOnPage'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current page contains the given string.
* Specify a locator as the second parameter to match a specific region.
*
* ``` php
* <?php
* $I->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()
*/
public
function
canSee
(
$text
,
$selector
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'see'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current page contains the given string.
* Specify a locator as the second parameter to match a specific region.
*
* ``` php
* <?php
* $I->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()
*/
public
function
see
(
$text
,
$selector
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'see'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current page doesn't contain the text specified.
* Give a locator as the second parameter to match a specific region.
*
* ```php
* <?php
* $I->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()
*/
public
function
cantSee
(
$text
,
$selector
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSee'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current page doesn't contain the text specified.
* Give a locator as the second parameter to match a specific region.
*
* ```php
* <?php
* $I->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()
*/
public
function
dontSee
(
$text
,
$selector
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSee'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page source contains the given string.
*
* ```php
* <?php
* $I->seeInPageSource('<link rel="apple-touch-icon"');
* ```
*
* @param $text
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeInPageSource()
*/
public
function
canSeeInPageSource
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInPageSource'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page source contains the given string.
*
* ```php
* <?php
* $I->seeInPageSource('<link rel="apple-touch-icon"');
* ```
*
* @param $text
* @see \Codeception\Module\WebDriver::seeInPageSource()
*/
public
function
seeInPageSource
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInPageSource'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page source doesn't contain the given string.
*
* @param $text
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeInPageSource()
*/
public
function
cantSeeInPageSource
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInPageSource'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page source doesn't contain the given string.
*
* @param $text
* @see \Codeception\Module\WebDriver::dontSeeInPageSource()
*/
public
function
dontSeeInPageSource
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInPageSource'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Perform a click on a link or a button, given by a locator.
* If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
* For buttons, the "value" attribute, "name" attribute, and inner text are searched.
* For links, the link text is searched.
* For images, the "alt" attribute and inner text of any parent links are searched.
*
* The second parameter is a context (CSS or XPath locator) to narrow the search.
*
* Note that if the locator matches a button of type `submit`, the form will be submitted.
*
* ``` php
* <?php
* // simple link
* $I->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');
* // using strict locator
* $I->click(['link' => 'Login']);
* ?>
* ```
*
* @param $link
* @param $context
* @see \Codeception\Module\WebDriver::click()
*/
public
function
click
(
$link
,
$context
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'click'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there's a link with the specified text.
* Give a full URL as the second parameter to match links with that exact URL.
*
* ``` php
* <?php
* $I->seeLink('Logout'); // matches <a href="#">Logout</a>
* $I->seeLink('Logout','/logout'); // matches <a href="/logout">Logout</a>
* ?>
* ```
*
* @param $text
* @param null $url
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeLink()
*/
public
function
canSeeLink
(
$text
,
$url
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeLink'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there's a link with the specified text.
* Give a full URL as the second parameter to match links with that exact URL.
*
* ``` php
* <?php
* $I->seeLink('Logout'); // matches <a href="#">Logout</a>
* $I->seeLink('Logout','/logout'); // matches <a href="/logout">Logout</a>
* ?>
* ```
*
* @param $text
* @param null $url
* @see \Codeception\Module\WebDriver::seeLink()
*/
public
function
seeLink
(
$text
,
$url
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeLink'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page doesn't contain a link with the given string.
* If the second parameter is given, only links with a matching "href" attribute will be checked.
*
* ``` php
* <?php
* $I->dontSeeLink('Logout'); // I suppose user is not logged in
* $I->dontSeeLink('Checkout now', '/store/cart.php');
* ?>
* ```
*
* @param $text
* @param null $url
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeLink()
*/
public
function
cantSeeLink
(
$text
,
$url
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeLink'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page doesn't contain a link with the given string.
* If the second parameter is given, only links with a matching "href" attribute will be checked.
*
* ``` php
* <?php
* $I->dontSeeLink('Logout'); // I suppose user is not logged in
* $I->dontSeeLink('Checkout now', '/store/cart.php');
* ?>
* ```
*
* @param $text
* @param null $url
* @see \Codeception\Module\WebDriver::dontSeeLink()
*/
public
function
dontSeeLink
(
$text
,
$url
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeLink'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that current URI contains the given string.
*
* ``` php
* <?php
* // to match: /home/dashboard
* $I->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()
*/
public
function
canSeeInCurrentUrl
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that current URI contains the given string.
*
* ``` php
* <?php
* // to match: /home/dashboard
* $I->seeInCurrentUrl('home');
* // to match: /users/1
* $I->seeInCurrentUrl('/users/');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Module\WebDriver::seeInCurrentUrl()
*/
public
function
seeInCurrentUrl
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL is equal to the given string.
* Unlike `seeInCurrentUrl`, this only matches the full URL.
*
* ``` php
* <?php
* // to match root url
* $I->seeCurrentUrlEquals('/');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeCurrentUrlEquals()
*/
public
function
canSeeCurrentUrlEquals
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeCurrentUrlEquals'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL is equal to the given string.
* Unlike `seeInCurrentUrl`, this only matches the full URL.
*
* ``` php
* <?php
* // to match root url
* $I->seeCurrentUrlEquals('/');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Module\WebDriver::seeCurrentUrlEquals()
*/
public
function
seeCurrentUrlEquals
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeCurrentUrlEquals'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL matches the given regular expression.
*
* ``` php
* <?php
* // to match root url
* $I->seeCurrentUrlMatches('~$/users/(\d+)~');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeCurrentUrlMatches()
*/
public
function
canSeeCurrentUrlMatches
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeCurrentUrlMatches'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL matches the given regular expression.
*
* ``` php
* <?php
* // to match root url
* $I->seeCurrentUrlMatches('~$/users/(\d+)~');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Module\WebDriver::seeCurrentUrlMatches()
*/
public
function
seeCurrentUrlMatches
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeCurrentUrlMatches'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URI doesn't contain the given string.
*
* ``` php
* <?php
* $I->dontSeeInCurrentUrl('/users/');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeInCurrentUrl()
*/
public
function
cantSeeInCurrentUrl
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URI doesn't contain the given string.
*
* ``` php
* <?php
* $I->dontSeeInCurrentUrl('/users/');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Module\WebDriver::dontSeeInCurrentUrl()
*/
public
function
dontSeeInCurrentUrl
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL doesn't equal the given string.
* Unlike `dontSeeInCurrentUrl`, this only matches the full URL.
*
* ``` php
* <?php
* // current url is not root
* $I->dontSeeCurrentUrlEquals('/');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeCurrentUrlEquals()
*/
public
function
cantSeeCurrentUrlEquals
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeCurrentUrlEquals'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL doesn't equal the given string.
* Unlike `dontSeeInCurrentUrl`, this only matches the full URL.
*
* ``` php
* <?php
* // current url is not root
* $I->dontSeeCurrentUrlEquals('/');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Module\WebDriver::dontSeeCurrentUrlEquals()
*/
public
function
dontSeeCurrentUrlEquals
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeCurrentUrlEquals'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that current url doesn't match the given regular expression.
*
* ``` php
* <?php
* // to match root url
* $I->dontSeeCurrentUrlMatches('~$/users/(\d+)~');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeCurrentUrlMatches()
*/
public
function
cantSeeCurrentUrlMatches
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeCurrentUrlMatches'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that current url doesn't match the given regular expression.
*
* ``` php
* <?php
* // to match root url
* $I->dontSeeCurrentUrlMatches('~$/users/(\d+)~');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Module\WebDriver::dontSeeCurrentUrlMatches()
*/
public
function
dontSeeCurrentUrlMatches
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeCurrentUrlMatches'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Executes the given regular expression against the current URI and returns the first match.
* If no parameters are provided, the full URI is returned.
*
* ``` php
* <?php
* $user_id = $I->grabFromCurrentUrl('~$/user/(\d+)/~');
* $uri = $I->grabFromCurrentUrl();
* ?>
* ```
*
* @param null $uri
*
* @internal param $url
* @return mixed
* @see \Codeception\Module\WebDriver::grabFromCurrentUrl()
*/
public
function
grabFromCurrentUrl
(
$uri
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabFromCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the specified checkbox is checked.
*
* ``` php
* <?php
* $I->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()
*/
public
function
canSeeCheckboxIsChecked
(
$checkbox
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeCheckboxIsChecked'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the specified checkbox is checked.
*
* ``` php
* <?php
* $I->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()
*/
public
function
seeCheckboxIsChecked
(
$checkbox
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeCheckboxIsChecked'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Check that the specified checkbox is unchecked.
*
* ``` php
* <?php
* $I->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()
*/
public
function
cantSeeCheckboxIsChecked
(
$checkbox
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeCheckboxIsChecked'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Check that the specified checkbox is unchecked.
*
* ``` php
* <?php
* $I->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()
*/
public
function
dontSeeCheckboxIsChecked
(
$checkbox
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeCheckboxIsChecked'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given input field or textarea contains the given value.
* For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
*
* ``` php
* <?php
* $I->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');
* $I->seeInField(['name' => 'search'], 'Search');
* ?>
* ```
*
* @param $field
* @param $value
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeInField()
*/
public
function
canSeeInField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given input field or textarea contains the given value.
* For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
*
* ``` php
* <?php
* $I->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');
* $I->seeInField(['name' => 'search'], 'Search');
* ?>
* ```
*
* @param $field
* @param $value
* @see \Codeception\Module\WebDriver::seeInField()
*/
public
function
seeInField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that an input field or textarea doesn't contain the given value.
* For fuzzy locators, the field is matched by label text, CSS and XPath.
*
* ``` php
* <?php
* $I->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');
* $I->dontSeeInField(['name' => 'search'], 'Search');
* ?>
* ```
*
* @param $field
* @param $value
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeInField()
*/
public
function
cantSeeInField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that an input field or textarea doesn't contain the given value.
* For fuzzy locators, the field is matched by label text, CSS and XPath.
*
* ``` php
* <?php
* $I->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');
* $I->dontSeeInField(['name' => 'search'], 'Search');
* ?>
* ```
*
* @param $field
* @param $value
* @see \Codeception\Module\WebDriver::dontSeeInField()
*/
public
function
dontSeeInField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if the array of form parameters (name => value) are set on the form matched with the
* passed selector.
*
* ``` php
* <?php
* $I->seeInFormFields('form[name=myform]', [
* 'input1' => 'value',
* 'input2' => 'other value',
* ]);
* ?>
* ```
*
* For multi-select elements, or to check values of multiple elements with the same name, an
* array may be passed:
*
* ``` php
* <?php
* $I->seeInFormFields('.form-class', [
* 'multiselect' => [
* 'value1',
* 'value2',
* ],
* 'checkbox[]' => [
* 'a checked value',
* 'another checked value',
* ],
* ]);
* ?>
* ```
*
* Additionally, checkbox values can be checked with a boolean.
*
* ``` php
* <?php
* $I->seeInFormFields('#form-id', [
* 'checkbox1' => true, // passes if checked
* 'checkbox2' => false, // passes if unchecked
* ]);
* ?>
* ```
*
* Pair this with submitForm for quick testing magic.
*
* ``` php
* <?php
* $form = [
* 'field1' => 'value',
* 'field2' => 'another value',
* 'checkbox1' => true,
* // ...
* ];
* $I->submitForm('//form[@id=my-form]', $form, 'submitButton');
* // $I->amOnPage('/path/to/form-page') may be needed
* $I->seeInFormFields('//form[@id=my-form]', $form);
* ?>
* ```
*
* @param $formSelector
* @param $params
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeInFormFields()
*/
public
function
canSeeInFormFields
(
$formSelector
,
$params
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInFormFields'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if the array of form parameters (name => value) are set on the form matched with the
* passed selector.
*
* ``` php
* <?php
* $I->seeInFormFields('form[name=myform]', [
* 'input1' => 'value',
* 'input2' => 'other value',
* ]);
* ?>
* ```
*
* For multi-select elements, or to check values of multiple elements with the same name, an
* array may be passed:
*
* ``` php
* <?php
* $I->seeInFormFields('.form-class', [
* 'multiselect' => [
* 'value1',
* 'value2',
* ],
* 'checkbox[]' => [
* 'a checked value',
* 'another checked value',
* ],
* ]);
* ?>
* ```
*
* Additionally, checkbox values can be checked with a boolean.
*
* ``` php
* <?php
* $I->seeInFormFields('#form-id', [
* 'checkbox1' => true, // passes if checked
* 'checkbox2' => false, // passes if unchecked
* ]);
* ?>
* ```
*
* Pair this with submitForm for quick testing magic.
*
* ``` php
* <?php
* $form = [
* 'field1' => 'value',
* 'field2' => 'another value',
* 'checkbox1' => true,
* // ...
* ];
* $I->submitForm('//form[@id=my-form]', $form, 'submitButton');
* // $I->amOnPage('/path/to/form-page') may be needed
* $I->seeInFormFields('//form[@id=my-form]', $form);
* ?>
* ```
*
* @param $formSelector
* @param $params
* @see \Codeception\Module\WebDriver::seeInFormFields()
*/
public
function
seeInFormFields
(
$formSelector
,
$params
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInFormFields'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if the array of form parameters (name => value) are not set on the form matched with
* the passed selector.
*
* ``` php
* <?php
* $I->dontSeeInFormFields('form[name=myform]', [
* 'input1' => 'non-existent value',
* 'input2' => 'other non-existent value',
* ]);
* ?>
* ```
*
* To check that an element hasn't been assigned any one of many values, an array can be passed
* as the value:
*
* ``` php
* <?php
* $I->dontSeeInFormFields('.form-class', [
* 'fieldName' => [
* 'This value shouldn\'t be set',
* 'And this value shouldn\'t be set',
* ],
* ]);
* ?>
* ```
*
* Additionally, checkbox values can be checked with a boolean.
*
* ``` php
* <?php
* $I->dontSeeInFormFields('#form-id', [
* 'checkbox1' => true, // fails if checked
* 'checkbox2' => false, // fails if unchecked
* ]);
* ?>
* ```
*
* @param $formSelector
* @param $params
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeInFormFields()
*/
public
function
cantSeeInFormFields
(
$formSelector
,
$params
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInFormFields'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if the array of form parameters (name => value) are not set on the form matched with
* the passed selector.
*
* ``` php
* <?php
* $I->dontSeeInFormFields('form[name=myform]', [
* 'input1' => 'non-existent value',
* 'input2' => 'other non-existent value',
* ]);
* ?>
* ```
*
* To check that an element hasn't been assigned any one of many values, an array can be passed
* as the value:
*
* ``` php
* <?php
* $I->dontSeeInFormFields('.form-class', [
* 'fieldName' => [
* 'This value shouldn\'t be set',
* 'And this value shouldn\'t be set',
* ],
* ]);
* ?>
* ```
*
* Additionally, checkbox values can be checked with a boolean.
*
* ``` php
* <?php
* $I->dontSeeInFormFields('#form-id', [
* 'checkbox1' => true, // fails if checked
* 'checkbox2' => false, // fails if unchecked
* ]);
* ?>
* ```
*
* @param $formSelector
* @param $params
* @see \Codeception\Module\WebDriver::dontSeeInFormFields()
*/
public
function
dontSeeInFormFields
(
$formSelector
,
$params
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInFormFields'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Selects an option in a select tag or in radio button group.
*
* ``` php
* <?php
* $I->selectOption('form select[name=account]', 'Premium');
* $I->selectOption('form input[name=payment]', 'Monthly');
* $I->selectOption('//form/select[@name=account]', 'Monthly');
* ?>
* ```
*
* Provide an array for the second argument to select multiple options:
*
* ``` php
* <?php
* $I->selectOption('Which OS do you use?', array('Windows','Linux'));
* ?>
* ```
*
* @param $select
* @param $option
* @see \Codeception\Module\WebDriver::selectOption()
*/
public
function
selectOption
(
$select
,
$option
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'selectOption'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
*
* @see \Codeception\Module\WebDriver::unselectOption()
*/
public
function
unselectOption
(
$select
,
$option
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'unselectOption'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Ticks a checkbox. For radio buttons, use the `selectOption` method instead.
*
* ``` php
* <?php
* $I->checkOption('#agree');
* ?>
* ```
*
* @param $option
* @see \Codeception\Module\WebDriver::checkOption()
*/
public
function
checkOption
(
$option
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'checkOption'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Unticks a checkbox.
*
* ``` php
* <?php
* $I->uncheckOption('#notify');
* ?>
* ```
*
* @param $option
* @see \Codeception\Module\WebDriver::uncheckOption()
*/
public
function
uncheckOption
(
$option
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'uncheckOption'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Fills a text field or textarea with the given string.
*
* ``` php
* <?php
* $I->fillField("//input[@type='text']", "Hello World!");
* $I->fillField(['name' => 'email'], 'jon@mail.com');
* ?>
* ```
*
* @param $field
* @param $value
* @see \Codeception\Module\WebDriver::fillField()
*/
public
function
fillField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'fillField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Attaches a file relative to the Codeception data directory to the given file upload field.
*
* ``` php
* <?php
* // file is stored in 'tests/_data/prices.xls'
* $I->attachFile('input[@type="file"]', 'prices.xls');
* ?>
* ```
*
* @param $field
* @param $filename
* @see \Codeception\Module\WebDriver::attachFile()
*/
public
function
attachFile
(
$field
,
$filename
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'attachFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Grabs all visible text from the current page.
*
* @return string
* @see \Codeception\Module\WebDriver::getVisibleText()
*/
public
function
getVisibleText
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'getVisibleText'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Finds and returns the text contents of the given element.
* If a fuzzy locator is used, the element is found using CSS, XPath, and by matching the full page source by regular expression.
*
* ``` php
* <?php
* $heading = $I->grabTextFrom('h1');
* $heading = $I->grabTextFrom('descendant-or-self::h1');
* $value = $I->grabTextFrom('~<input value=(.*?)]~sgi'); // match with a regex
* ?>
* ```
*
* @param $cssOrXPathOrRegex
*
* @return mixed
* @see \Codeception\Module\WebDriver::grabTextFrom()
*/
public
function
grabTextFrom
(
$cssOrXPathOrRegex
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabTextFrom'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Grabs the value of the given attribute value from the given element.
* Fails if element is not found.
*
* ``` php
* <?php
* $I->grabAttributeFrom('#tooltip', 'title');
* ?>
* ```
*
*
* @param $cssOrXpath
* @param $attribute
* @internal param $element
* @return mixed
* @see \Codeception\Module\WebDriver::grabAttributeFrom()
*/
public
function
grabAttributeFrom
(
$cssOrXpath
,
$attribute
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabAttributeFrom'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Finds the value for the given form field.
* If a fuzzy locator is used, the field is found by field name, CSS, and XPath.
*
* ``` php
* <?php
* $name = $I->grabValueFrom('Name');
* $name = $I->grabValueFrom('input[name=username]');
* $name = $I->grabValueFrom('descendant-or-self::form/descendant::input[@name = 'username']');
* $name = $I->grabValueFrom(['name' => 'username']);
* ?>
* ```
*
* @param $field
*
* @return mixed
* @see \Codeception\Module\WebDriver::grabValueFrom()
*/
public
function
grabValueFrom
(
$field
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabValueFrom'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element exists on the page and is visible.
* You can also specify expected attributes of this element.
*
* ``` php
* <?php
* $I->seeElement('.error');
* $I->seeElement('//form/input[1]');
* $I->seeElement('input', ['name' => 'login']);
* $I->seeElement('input', ['value' => '123456']);
*
* // strict locator in first arg, attributes in second
* $I->seeElement(['css' => 'form input'], ['name' => 'login']);
* ?>
* ```
*
* @param $selector
* @param array $attributes
* @return
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeElement()
*/
public
function
canSeeElement
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeElement'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element exists on the page and is visible.
* You can also specify expected attributes of this element.
*
* ``` php
* <?php
* $I->seeElement('.error');
* $I->seeElement('//form/input[1]');
* $I->seeElement('input', ['name' => 'login']);
* $I->seeElement('input', ['value' => '123456']);
*
* // strict locator in first arg, attributes in second
* $I->seeElement(['css' => 'form input'], ['name' => 'login']);
* ?>
* ```
*
* @param $selector
* @param array $attributes
* @return
* @see \Codeception\Module\WebDriver::seeElement()
*/
public
function
seeElement
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeElement'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element is invisible or not present on the page.
* You can also specify expected attributes of this element.
*
* ``` php
* <?php
* $I->dontSeeElement('.error');
* $I->dontSeeElement('//form/input[1]');
* $I->dontSeeElement('input', ['name' => 'login']);
* $I->dontSeeElement('input', ['value' => '123456']);
* ?>
* ```
*
* @param $selector
* @param array $attributes
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeElement()
*/
public
function
cantSeeElement
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeElement'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element is invisible or not present on the page.
* You can also specify expected attributes of this element.
*
* ``` php
* <?php
* $I->dontSeeElement('.error');
* $I->dontSeeElement('//form/input[1]');
* $I->dontSeeElement('input', ['name' => 'login']);
* $I->dontSeeElement('input', ['value' => '123456']);
* ?>
* ```
*
* @param $selector
* @param array $attributes
* @see \Codeception\Module\WebDriver::dontSeeElement()
*/
public
function
dontSeeElement
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeElement'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element exists on the page, even it is invisible.
*
* ``` php
* <?php
* $I->seeElementInDOM('//form/input[type=hidden]');
* ?>
* ```
*
* @param $selector
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeElementInDOM()
*/
public
function
canSeeElementInDOM
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeElementInDOM'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element exists on the page, even it is invisible.
*
* ``` php
* <?php
* $I->seeElementInDOM('//form/input[type=hidden]');
* ?>
* ```
*
* @param $selector
* @see \Codeception\Module\WebDriver::seeElementInDOM()
*/
public
function
seeElementInDOM
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeElementInDOM'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Opposite of `seeElementInDOM`.
*
* @param $selector
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeElementInDOM()
*/
public
function
cantSeeElementInDOM
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeElementInDOM'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Opposite of `seeElementInDOM`.
*
* @param $selector
* @see \Codeception\Module\WebDriver::dontSeeElementInDOM()
*/
public
function
dontSeeElementInDOM
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeElementInDOM'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there are a certain number of elements matched by the given locator on the page.
*
* ``` php
* <?php
* $I->seeNumberOfElements('tr', 10);
* $I->seeNumberOfElements('tr', [0,10]); //between 0 and 10 elements
* ?>
* ```
* @param $selector
* @param mixed $expected:
* - string: strict number
* - array: range of numbers [0,10]
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeNumberOfElements()
*/
public
function
canSeeNumberOfElements
(
$selector
,
$expected
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeNumberOfElements'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there are a certain number of elements matched by the given locator on the page.
*
* ``` php
* <?php
* $I->seeNumberOfElements('tr', 10);
* $I->seeNumberOfElements('tr', [0,10]); //between 0 and 10 elements
* ?>
* ```
* @param $selector
* @param mixed $expected:
* - string: strict number
* - array: range of numbers [0,10]
* @see \Codeception\Module\WebDriver::seeNumberOfElements()
*/
public
function
seeNumberOfElements
(
$selector
,
$expected
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeNumberOfElements'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given option is selected.
*
* ``` php
* <?php
* $I->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()
*/
public
function
canSeeOptionIsSelected
(
$selector
,
$optionText
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeOptionIsSelected'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given option is selected.
*
* ``` php
* <?php
* $I->seeOptionIsSelected('#form input[name=payment]', 'Visa');
* ?>
* ```
*
* @param $selector
* @param $optionText
*
* @return mixed
* @see \Codeception\Module\WebDriver::seeOptionIsSelected()
*/
public
function
seeOptionIsSelected
(
$selector
,
$optionText
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeOptionIsSelected'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given option is not selected.
*
* ``` php
* <?php
* $I->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()
*/
public
function
cantSeeOptionIsSelected
(
$selector
,
$optionText
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeOptionIsSelected'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given option is not selected.
*
* ``` php
* <?php
* $I->dontSeeOptionIsSelected('#form input[name=payment]', 'Visa');
* ?>
* ```
*
* @param $selector
* @param $optionText
*
* @return mixed
* @see \Codeception\Module\WebDriver::dontSeeOptionIsSelected()
*/
public
function
dontSeeOptionIsSelected
(
$selector
,
$optionText
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeOptionIsSelected'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page title contains the given string.
*
* ``` php
* <?php
* $I->seeInTitle('Blog - Post #1');
* ?>
* ```
*
* @param $title
*
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeInTitle()
*/
public
function
canSeeInTitle
(
$title
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInTitle'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page title contains the given string.
*
* ``` php
* <?php
* $I->seeInTitle('Blog - Post #1');
* ?>
* ```
*
* @param $title
*
* @return mixed
* @see \Codeception\Module\WebDriver::seeInTitle()
*/
public
function
seeInTitle
(
$title
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInTitle'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page title does not contain the given string.
*
* @param $title
*
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::dontSeeInTitle()
*/
public
function
cantSeeInTitle
(
$title
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInTitle'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page title does not contain the given string.
*
* @param $title
*
* @return mixed
* @see \Codeception\Module\WebDriver::dontSeeInTitle()
*/
public
function
dontSeeInTitle
(
$title
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInTitle'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Accepts the active JavaScript native popup window, as created by `window.alert`|`window.confirm`|`window.prompt`.
* Don't confuse popups with modal windows, as created by [various libraries](http://jster.net/category/windows-modals-popups).
* @see \Codeception\Module\WebDriver::acceptPopup()
*/
public
function
acceptPopup
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'acceptPopup'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Dismisses the active JavaScript popup, as created by `window.alert`|`window.confirm`|`window.prompt`.
* @see \Codeception\Module\WebDriver::cancelPopup()
*/
public
function
cancelPopup
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'cancelPopup'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the active JavaScript popup, as created by `window.alert`|`window.confirm`|`window.prompt`, contains the given string.
*
* @param $text
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\WebDriver::seeInPopup()
*/
public
function
canSeeInPopup
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInPopup'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the active JavaScript popup, as created by `window.alert`|`window.confirm`|`window.prompt`, contains the given string.
*
* @param $text
* @see \Codeception\Module\WebDriver::seeInPopup()
*/
public
function
seeInPopup
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInPopup'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Enters text into a native JavaScript prompt popup, as created by `window.prompt`.
*
* @param $keys
* @see \Codeception\Module\WebDriver::typeInPopup()
*/
public
function
typeInPopup
(
$keys
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'typeInPopup'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Reloads the current page.
* @see \Codeception\Module\WebDriver::reloadPage()
*/
public
function
reloadPage
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'reloadPage'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Moves back in history.
* @see \Codeception\Module\WebDriver::moveBack()
*/
public
function
moveBack
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'moveBack'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Moves forward in history.
* @see \Codeception\Module\WebDriver::moveForward()
*/
public
function
moveForward
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'moveForward'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Submits the given form on the page, optionally with the given form values.
* Give the form fields values as an array. Note that hidden fields can't be accessed.
*
* Skipped fields will be filled by their values from the page.
* You don't need to click the 'Submit' button afterwards.
* This command itself triggers the request to form's action.
*
* You can optionally specify what button's value to include
* in the request with the last parameter as an alternative to
* explicitly setting its value in the second parameter, as
* button values are not otherwise included in the request.
*
* Examples:
*
* ``` php
* <?php
* $I->submitForm('#login', array('login' => 'davert', 'password' => '123456'));
* // or
* $I->submitForm('#login', array('login' => 'davert', 'password' => '123456'), 'submitButtonName');
*
* ```
*
* For example, given this sample "Sign Up" form:
*
* ``` html
* <form action="/sign_up">
* Login: <input type="text" name="user[login]" /><br/>
* Password: <input type="password" name="user[password]" /><br/>
* Do you agree to out terms? <input type="checkbox" name="user[agree]" /><br/>
* Select pricing plan <select name="plan"><option value="1">Free</option><option value="2" selected="selected">Paid</option></select>
* <input type="submit" name="submitButton" value="Submit" />
* </form>
* ```
*
* You could write the following to submit it:
*
* ``` php
* <?php
* $I->submitForm('#userForm', array('user' => array('login' => 'Davert', 'password' => '123456', 'agree' => true)), 'submitButton');
*
* ```
* Note that "2" will be the submitted value for the "plan" field, as it is the selected option.
*
* You can also emulate a JavaScript submission by not specifying any buttons in the third parameter to submitForm.
*
* ```php
* <?php
* $I->submitForm('#userForm', array('user' => array('login' => 'Davert', 'password' => '123456', 'agree' => true)));
*
* ```
*
* @param $selector
* @param $params
* @param $button
* @see \Codeception\Module\WebDriver::submitForm()
*/
public
function
submitForm
(
$selector
,
$params
,
$button
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'submitForm'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Waits up to $timeout seconds for the given element to change.
* Element "change" is determined by a callback function which is called repeatedly until the return value evaluates to true.
*
* ``` php
* <?php
* $I->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()
*/
public
function
waitForElementChange
(
$element
,
$callback
,
$timeout
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'waitForElementChange'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Waits up to $timeout seconds for an element to appear on the page.
* If the element doesn't appear, a timeout exception is thrown.
*
* ``` php
* <?php
* $I->waitForElement('#agree_button', 30); // secs
* $I->click('#agree_button');
* ?>
* ```
*
* @param $element
* @param int $timeout seconds
* @throws \Exception
* @see \Codeception\Module\WebDriver::waitForElement()
*/
public
function
waitForElement
(
$element
,
$timeout
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'waitForElement'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Waits up to $timeout seconds for the given element to be visible on the page.
* If element doesn't appear, a timeout exception is thrown.
*
* ``` php
* <?php
* $I->waitForElementVisible('#agree_button', 30); // secs
* $I->click('#agree_button');
* ?>
* ```
*
* @param $element
* @param int $timeout seconds
* @throws \Exception
* @see \Codeception\Module\WebDriver::waitForElementVisible()
*/
public
function
waitForElementVisible
(
$element
,
$timeout
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'waitForElementVisible'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Waits up to $timeout seconds for the given element to become invisible.
* If element stays visible, a timeout exception is thrown.
*
* ``` php
* <?php
* $I->waitForElementNotVisible('#agree_button', 30); // secs
* ?>
* ```
*
* @param $element
* @param int $timeout seconds
* @throws \Exception
* @see \Codeception\Module\WebDriver::waitForElementNotVisible()
*/
public
function
waitForElementNotVisible
(
$element
,
$timeout
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'waitForElementNotVisible'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Waits up to $timeout seconds for the given string to appear on the page.
* Can also be passed a selector to search in.
* If the given text doesn't appear, a timeout exception is thrown.
*
* ``` php
* <?php
* $I->waitForText('foo', 30); // secs
* $I->waitForText('foo', 30, '.title'); // secs
* ?>
* ```
*
* @param string $text
* @param int $timeout seconds
* @param null $selector
* @throws \Exception
* @see \Codeception\Module\WebDriver::waitForText()
*/
public
function
waitForText
(
$text
,
$timeout
=
null
,
$selector
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'waitForText'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Wait for $timeout seconds.
*
* @param int $timeout secs
* @throws \Codeception\Exception\TestRuntime
* @see \Codeception\Module\WebDriver::wait()
*/
public
function
wait
(
$timeout
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'wait'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Low-level API method.
* If Codeception commands are not enough, this allows you to use Selenium WebDriver methods directly:
*
* ``` php
* $I->executeInSelenium(function(\WebDriver $webdriver) {
* $webdriver->get('http://google.com');
* });
* ```
*
* This runs in the context of the [RemoteWebDriver class](https://github.com/facebook/php-webdriver/blob/master/lib/remote/RemoteWebDriver.php).
* Try not to use this command on a regular basis.
* If Codeception lacks a feature you need, please implement it and submit a patch.
*
* @param callable $function
* @see \Codeception\Module\WebDriver::executeInSelenium()
*/
public
function
executeInSelenium
(
$function
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'executeInSelenium'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Switch to another window identified by name.
*
* The window can only be identified by name. If the $name parameter is blank, the parent window will be used.
*
* Example:
* ``` html
* <input type="button" value="Open window" onclick="window.open('http://example.com', 'another_window')">
* ```
*
* ``` php
* <?php
* $I->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:
*
* ``` php
* <?php
* $I->executeInSelenium(function (\Webdriver $webdriver) {
* $handles=$webdriver->getWindowHandles();
* $last_window = end($handles);
* $webdriver->switchTo()->window($last_window);
* });
* ?>
* ```
*
* @param string|null $name
* @see \Codeception\Module\WebDriver::switchToWindow()
*/
public
function
switchToWindow
(
$name
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'switchToWindow'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Switch to another frame on the page.
*
* Example:
* ``` html
* <iframe name="another_frame" src="http://example.com">
*
* ```
*
* ``` php
* <?php
* # switch to iframe
* $I->switchToIFrame("another_frame");
* # switch to parent page
* $I->switchToIFrame();
*
* ```
*
* @param string|null $name
* @see \Codeception\Module\WebDriver::switchToIFrame()
*/
public
function
switchToIFrame
(
$name
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'switchToIFrame'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Executes JavaScript and waits up to $timeout seconds for it to return true.
*
* In this example we will wait up to 60 seconds for all jQuery AJAX requests to finish.
*
* ``` php
* <?php
* $I->waitForJS("return $.active == 0;", 60);
* ?>
* ```
*
* @param string $script
* @param int $timeout seconds
* @see \Codeception\Module\WebDriver::waitForJS()
*/
public
function
waitForJS
(
$script
,
$timeout
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'waitForJS'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Executes custom JavaScript.
*
* This example uses jQuery to get a value and assigns that value to a PHP variable:
*
* ```php
* <?php
* $myVar = $I->executeJS('return $("#myField").val()');
* ?>
* ```
*
* @param $script
* @return mixed
* @see \Codeception\Module\WebDriver::executeJS()
*/
public
function
executeJS
(
$script
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'executeJS'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Maximizes the current window.
* @see \Codeception\Module\WebDriver::maximizeWindow()
*/
public
function
maximizeWindow
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'maximizeWindow'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Performs a simple mouse drag-and-drop operation.
*
* ``` php
* <?php
* $I->dragAndDrop('#drag', '#drop');
* ?>
* ```
*
* @param string $source (CSS ID or XPath)
* @param string $target (CSS ID or XPath)
* @see \Codeception\Module\WebDriver::dragAndDrop()
*/
public
function
dragAndDrop
(
$source
,
$target
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'dragAndDrop'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Move mouse over the first element matched by the given locator.
* If the second and third parameters are given, then the mouse is moved to an offset of the element's top-left corner.
* Otherwise, the mouse is moved to the center of the element.
*
* ``` php
* <?php
* $I->moveMouseOver(['css' => '.checkout'], 20, 50);
* ?>
* ```
*
* @param string $cssOrXPath css or xpath of the web element
* @param int $offsetX
* @param int $offsetY
*
* @throws \Codeception\Exception\ElementNotFound
* @see \Codeception\Module\WebDriver::moveMouseOver()
*/
public
function
moveMouseOver
(
$cssOrXPath
,
$offsetX
=
null
,
$offsetY
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'moveMouseOver'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Performs contextual click with the right mouse button on an element.
*
* @param $cssOrXPath
* @throws \Codeception\Exception\ElementNotFound
* @see \Codeception\Module\WebDriver::clickWithRightButton()
*/
public
function
clickWithRightButton
(
$cssOrXPath
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'clickWithRightButton'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Pauses test execution in debug mode.
* To proceed test press "ENTER" in console.
*
* This method is useful while writing tests, since it allows you to inspect the current page in the middle of a test case.
* @see \Codeception\Module\WebDriver::pauseExecution()
*/
public
function
pauseExecution
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'pauseExecution'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Performs a double-click on an element matched by CSS or XPath.
*
* @param $cssOrXPath
* @throws \Codeception\Exception\ElementNotFound
* @see \Codeception\Module\WebDriver::doubleClick()
*/
public
function
doubleClick
(
$cssOrXPath
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'doubleClick'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Presses the given key on the given element.
* To specify a character and modifier (e.g. ctrl, alt, shift, meta), pass an array for $char with
* the modifier as the first element and the character as the second.
* For special keys use key constants from \WebDriverKeys class.
*
* ``` php
* <?php
* // <input id="page" value="old" />
* $I->pressKey('#page','a'); // => olda
* $I->pressKey('#page',array('ctrl','a'),'new'); //=> new
* $I->pressKey('#page',array('shift','111'),'1','x'); //=> old!!!1x
* $I->pressKey('descendant-or-self::*[@id='page']','u'); //=> oldu
* $I->pressKey('#name', array('ctrl', 'a'), WebDriverKeys::DELETE); //=>''
* ?>
* ```
*
* @param $element
* @param $char Can be char or array with modifier. You can provide several chars.
* @throws \Codeception\Exception\ElementNotFound
* @see \Codeception\Module\WebDriver::pressKey()
*/
public
function
pressKey
(
$element
,
$char
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'pressKey'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Append the given text to the given element.
* Can also add a selection to a select box.
*
* ``` php
* <?php
* $I->appendField('#mySelectbox', 'SelectValue');
* $I->appendField('#myTextField', 'appended');
* ?>
* ```
*
* @param string $field
* @param string $value
* @throws \Codeception\Exception\ElementNotFound
* @see \Codeception\Module\WebDriver::appendField()
*/
public
function
appendField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'appendField'
,
func_get_args
()));
}
}
tests/codeception/functional/FunctionalTester.php
0 → 100644
View file @
6c27ec9c
<?php
//[STAMP] d25ee02e09b6fb78d86567a04478101d
// This class was automatically generated by build task
// You should not change it manually as it will be overwritten on next build
// @codingStandardsIgnoreFile
use
Codeception\Module\Filesystem
;
use
Codeception\Module\Yii2
;
/**
* Inherited Methods
* @method void wantToTest($text)
* @method void wantTo($text)
* @method void execute($callable)
* @method void expectTo($prediction)
* @method void expect($prediction)
* @method void amGoingTo($argumentation)
* @method void am($role)
* @method void lookForwardTo($achieveValue)
* @method void comment($description)
* @method void haveFriend($name, $actorClass = null)
*
* @SuppressWarnings(PHPMD)
*/
class
FunctionalTester
extends
\Codeception\Actor
{
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Enters a directory In local filesystem.
* Project root directory is used by default
*
* @param $path
* @see \Codeception\Module\Filesystem::amInPath()
*/
public
function
amInPath
(
$path
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Condition
(
'amInPath'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Opens a file and stores it's content.
*
* Usage:
*
* ``` php
* <?php
* $I->openFile('composer.json');
* $I->seeInThisFile('codeception/codeception');
* ?>
* ```
*
* @param $filename
* @see \Codeception\Module\Filesystem::openFile()
*/
public
function
openFile
(
$filename
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'openFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Deletes a file
*
* ``` php
* <?php
* $I->deleteFile('composer.lock');
* ?>
* ```
*
* @param $filename
* @see \Codeception\Module\Filesystem::deleteFile()
*/
public
function
deleteFile
(
$filename
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'deleteFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Deletes directory with all subdirectories
*
* ``` php
* <?php
* $I->deleteDir('vendor');
* ?>
* ```
*
* @param $dirname
* @see \Codeception\Module\Filesystem::deleteDir()
*/
public
function
deleteDir
(
$dirname
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'deleteDir'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Copies directory with all contents
*
* ``` php
* <?php
* $I->copyDir('vendor','old_vendor');
* ?>
* ```
*
* @param $src
* @param $dst
* @see \Codeception\Module\Filesystem::copyDir()
*/
public
function
copyDir
(
$src
,
$dst
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'copyDir'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks If opened file has `text` in it.
*
* Usage:
*
* ``` php
* <?php
* $I->openFile('composer.json');
* $I->seeInThisFile('codeception/codeception');
* ?>
* ```
*
* @param $text
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\Filesystem::seeInThisFile()
*/
public
function
canSeeInThisFile
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInThisFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks If opened file has `text` in it.
*
* Usage:
*
* ``` php
* <?php
* $I->openFile('composer.json');
* $I->seeInThisFile('codeception/codeception');
* ?>
* ```
*
* @param $text
* @see \Codeception\Module\Filesystem::seeInThisFile()
*/
public
function
seeInThisFile
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInThisFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks the strict matching of file contents.
* Unlike `seeInThisFile` will fail if file has something more than expected lines.
* Better to use with HEREDOC strings.
* Matching is done after removing "\r" chars from file content.
*
* ``` php
* <?php
* $I->openFile('process.pid');
* $I->seeFileContentsEqual('3192');
* ?>
* ```
*
* @param $text
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\Filesystem::seeFileContentsEqual()
*/
public
function
canSeeFileContentsEqual
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeFileContentsEqual'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks the strict matching of file contents.
* Unlike `seeInThisFile` will fail if file has something more than expected lines.
* Better to use with HEREDOC strings.
* Matching is done after removing "\r" chars from file content.
*
* ``` php
* <?php
* $I->openFile('process.pid');
* $I->seeFileContentsEqual('3192');
* ?>
* ```
*
* @param $text
* @see \Codeception\Module\Filesystem::seeFileContentsEqual()
*/
public
function
seeFileContentsEqual
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeFileContentsEqual'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks If opened file doesn't contain `text` in it
*
* ``` php
* <?php
* $I->openFile('composer.json');
* $I->dontSeeInThisFile('codeception/codeception');
* ?>
* ```
*
* @param $text
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\Filesystem::dontSeeInThisFile()
*/
public
function
cantSeeInThisFile
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInThisFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks If opened file doesn't contain `text` in it
*
* ``` php
* <?php
* $I->openFile('composer.json');
* $I->dontSeeInThisFile('codeception/codeception');
* ?>
* ```
*
* @param $text
* @see \Codeception\Module\Filesystem::dontSeeInThisFile()
*/
public
function
dontSeeInThisFile
(
$text
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInThisFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Deletes a file
* @see \Codeception\Module\Filesystem::deleteThisFile()
*/
public
function
deleteThisFile
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'deleteThisFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if file exists in path.
* Opens a file when it's exists
*
* ``` php
* <?php
* $I->seeFileFound('UserModel.php','app/models');
* ?>
* ```
*
* @param $filename
* @param string $path
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\Filesystem::seeFileFound()
*/
public
function
canSeeFileFound
(
$filename
,
$path
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeFileFound'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if file exists in path.
* Opens a file when it's exists
*
* ``` php
* <?php
* $I->seeFileFound('UserModel.php','app/models');
* ?>
* ```
*
* @param $filename
* @param string $path
* @see \Codeception\Module\Filesystem::seeFileFound()
*/
public
function
seeFileFound
(
$filename
,
$path
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeFileFound'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if file does not exists in path
*
* @param $filename
* @param string $path
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\Filesystem::dontSeeFileFound()
*/
public
function
cantSeeFileFound
(
$filename
,
$path
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeFileFound'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if file does not exists in path
*
* @param $filename
* @param string $path
* @see \Codeception\Module\Filesystem::dontSeeFileFound()
*/
public
function
dontSeeFileFound
(
$filename
,
$path
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeFileFound'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Erases directory contents
*
* ``` php
* <?php
* $I->cleanDir('logs');
* ?>
* ```
*
* @param $dirname
* @see \Codeception\Module\Filesystem::cleanDir()
*/
public
function
cleanDir
(
$dirname
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'cleanDir'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Saves contents to file
*
* @param $filename
* @param $contents
* @see \Codeception\Module\Filesystem::writeToFile()
*/
public
function
writeToFile
(
$filename
,
$contents
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'writeToFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Inserts record into the database.
*
* ``` php
* <?php
* $user_id = $I->haveRecord('app\models\User', array('name' => 'Davert'));
* ?>
* ```
*
* @param $model
* @param array $attributes
* @return mixed
* @see \Codeception\Module\Yii2::haveRecord()
*/
public
function
haveRecord
(
$model
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'haveRecord'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that record exists in database.
*
* ``` php
* $I->seeRecord('app\models\User', array('name' => 'davert'));
* ```
*
* @param $model
* @param array $attributes
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\Yii2::seeRecord()
*/
public
function
canSeeRecord
(
$model
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeRecord'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that record exists in database.
*
* ``` php
* $I->seeRecord('app\models\User', array('name' => 'davert'));
* ```
*
* @param $model
* @param array $attributes
* @see \Codeception\Module\Yii2::seeRecord()
*/
public
function
seeRecord
(
$model
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeRecord'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that record does not exist in database.
*
* ``` php
* $I->dontSeeRecord('app\models\User', array('name' => 'davert'));
* ```
*
* @param $model
* @param array $attributes
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Module\Yii2::dontSeeRecord()
*/
public
function
cantSeeRecord
(
$model
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeRecord'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that record does not exist in database.
*
* ``` php
* $I->dontSeeRecord('app\models\User', array('name' => 'davert'));
* ```
*
* @param $model
* @param array $attributes
* @see \Codeception\Module\Yii2::dontSeeRecord()
*/
public
function
dontSeeRecord
(
$model
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeRecord'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Retrieves record from database
*
* ``` php
* $category = $I->grabRecord('app\models\User', array('name' => 'davert'));
* ```
*
* @param $model
* @param array $attributes
* @return mixed
* @see \Codeception\Module\Yii2::grabRecord()
*/
public
function
grabRecord
(
$model
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabRecord'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Converting $page to valid Yii 2 URL
*
* Allows input like:
*
* ```php
* $I->amOnPage(['site/view','page'=>'about']);
* $I->amOnPage('index-test.php?site/index');
* $I->amOnPage('http://localhost/index-test.php?site/index');
* ```
*
* @param $page string|array parameter for \yii\web\UrlManager::createUrl()
* @see \Codeception\Module\Yii2::amOnPage()
*/
public
function
amOnPage
(
$page
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Condition
(
'amOnPage'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Authenticates user for HTTP_AUTH
*
* @param $username
* @param $password
* @see \Codeception\Lib\InnerBrowser::amHttpAuthenticated()
*/
public
function
amHttpAuthenticated
(
$username
,
$password
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Condition
(
'amHttpAuthenticated'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Perform a click on a link or a button, given by a locator.
* If a fuzzy locator is given, the page will be searched for a button, link, or image matching the locator string.
* For buttons, the "value" attribute, "name" attribute, and inner text are searched.
* For links, the link text is searched.
* For images, the "alt" attribute and inner text of any parent links are searched.
*
* The second parameter is a context (CSS or XPath locator) to narrow the search.
*
* Note that if the locator matches a button of type `submit`, the form will be submitted.
*
* ``` php
* <?php
* // simple link
* $I->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');
* // using strict locator
* $I->click(['link' => 'Login']);
* ?>
* ```
*
* @param $link
* @param $context
* @see \Codeception\Lib\InnerBrowser::click()
*/
public
function
click
(
$link
,
$context
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'click'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current page contains the given string.
* Specify a locator as the second parameter to match a specific region.
*
* ``` php
* <?php
* $I->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\Lib\InnerBrowser::see()
*/
public
function
canSee
(
$text
,
$selector
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'see'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current page contains the given string.
* Specify a locator as the second parameter to match a specific region.
*
* ``` php
* <?php
* $I->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\Lib\InnerBrowser::see()
*/
public
function
see
(
$text
,
$selector
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'see'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current page doesn't contain the text specified.
* Give a locator as the second parameter to match a specific region.
*
* ```php
* <?php
* $I->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\Lib\InnerBrowser::dontSee()
*/
public
function
cantSee
(
$text
,
$selector
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSee'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current page doesn't contain the text specified.
* Give a locator as the second parameter to match a specific region.
*
* ```php
* <?php
* $I->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\Lib\InnerBrowser::dontSee()
*/
public
function
dontSee
(
$text
,
$selector
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSee'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there's a link with the specified text.
* Give a full URL as the second parameter to match links with that exact URL.
*
* ``` php
* <?php
* $I->seeLink('Logout'); // matches <a href="#">Logout</a>
* $I->seeLink('Logout','/logout'); // matches <a href="/logout">Logout</a>
* ?>
* ```
*
* @param $text
* @param null $url
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeLink()
*/
public
function
canSeeLink
(
$text
,
$url
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeLink'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there's a link with the specified text.
* Give a full URL as the second parameter to match links with that exact URL.
*
* ``` php
* <?php
* $I->seeLink('Logout'); // matches <a href="#">Logout</a>
* $I->seeLink('Logout','/logout'); // matches <a href="/logout">Logout</a>
* ?>
* ```
*
* @param $text
* @param null $url
* @see \Codeception\Lib\InnerBrowser::seeLink()
*/
public
function
seeLink
(
$text
,
$url
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeLink'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page doesn't contain a link with the given string.
* If the second parameter is given, only links with a matching "href" attribute will be checked.
*
* ``` php
* <?php
* $I->dontSeeLink('Logout'); // I suppose user is not logged in
* $I->dontSeeLink('Checkout now', '/store/cart.php');
* ?>
* ```
*
* @param $text
* @param null $url
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeLink()
*/
public
function
cantSeeLink
(
$text
,
$url
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeLink'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page doesn't contain a link with the given string.
* If the second parameter is given, only links with a matching "href" attribute will be checked.
*
* ``` php
* <?php
* $I->dontSeeLink('Logout'); // I suppose user is not logged in
* $I->dontSeeLink('Checkout now', '/store/cart.php');
* ?>
* ```
*
* @param $text
* @param null $url
* @see \Codeception\Lib\InnerBrowser::dontSeeLink()
*/
public
function
dontSeeLink
(
$text
,
$url
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeLink'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that current URI contains the given string.
*
* ``` php
* <?php
* // to match: /home/dashboard
* $I->seeInCurrentUrl('home');
* // to match: /users/1
* $I->seeInCurrentUrl('/users/');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeInCurrentUrl()
*/
public
function
canSeeInCurrentUrl
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that current URI contains the given string.
*
* ``` php
* <?php
* // to match: /home/dashboard
* $I->seeInCurrentUrl('home');
* // to match: /users/1
* $I->seeInCurrentUrl('/users/');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Lib\InnerBrowser::seeInCurrentUrl()
*/
public
function
seeInCurrentUrl
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URI doesn't contain the given string.
*
* ``` php
* <?php
* $I->dontSeeInCurrentUrl('/users/');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeInCurrentUrl()
*/
public
function
cantSeeInCurrentUrl
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URI doesn't contain the given string.
*
* ``` php
* <?php
* $I->dontSeeInCurrentUrl('/users/');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Lib\InnerBrowser::dontSeeInCurrentUrl()
*/
public
function
dontSeeInCurrentUrl
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL is equal to the given string.
* Unlike `seeInCurrentUrl`, this only matches the full URL.
*
* ``` php
* <?php
* // to match root url
* $I->seeCurrentUrlEquals('/');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeCurrentUrlEquals()
*/
public
function
canSeeCurrentUrlEquals
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeCurrentUrlEquals'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL is equal to the given string.
* Unlike `seeInCurrentUrl`, this only matches the full URL.
*
* ``` php
* <?php
* // to match root url
* $I->seeCurrentUrlEquals('/');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Lib\InnerBrowser::seeCurrentUrlEquals()
*/
public
function
seeCurrentUrlEquals
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeCurrentUrlEquals'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL doesn't equal the given string.
* Unlike `dontSeeInCurrentUrl`, this only matches the full URL.
*
* ``` php
* <?php
* // current url is not root
* $I->dontSeeCurrentUrlEquals('/');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeCurrentUrlEquals()
*/
public
function
cantSeeCurrentUrlEquals
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeCurrentUrlEquals'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL doesn't equal the given string.
* Unlike `dontSeeInCurrentUrl`, this only matches the full URL.
*
* ``` php
* <?php
* // current url is not root
* $I->dontSeeCurrentUrlEquals('/');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Lib\InnerBrowser::dontSeeCurrentUrlEquals()
*/
public
function
dontSeeCurrentUrlEquals
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeCurrentUrlEquals'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL matches the given regular expression.
*
* ``` php
* <?php
* // to match root url
* $I->seeCurrentUrlMatches('~$/users/(\d+)~');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeCurrentUrlMatches()
*/
public
function
canSeeCurrentUrlMatches
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeCurrentUrlMatches'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the current URL matches the given regular expression.
*
* ``` php
* <?php
* // to match root url
* $I->seeCurrentUrlMatches('~$/users/(\d+)~');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Lib\InnerBrowser::seeCurrentUrlMatches()
*/
public
function
seeCurrentUrlMatches
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeCurrentUrlMatches'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that current url doesn't match the given regular expression.
*
* ``` php
* <?php
* // to match root url
* $I->dontSeeCurrentUrlMatches('~$/users/(\d+)~');
* ?>
* ```
*
* @param $uri
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeCurrentUrlMatches()
*/
public
function
cantSeeCurrentUrlMatches
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeCurrentUrlMatches'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that current url doesn't match the given regular expression.
*
* ``` php
* <?php
* // to match root url
* $I->dontSeeCurrentUrlMatches('~$/users/(\d+)~');
* ?>
* ```
*
* @param $uri
* @see \Codeception\Lib\InnerBrowser::dontSeeCurrentUrlMatches()
*/
public
function
dontSeeCurrentUrlMatches
(
$uri
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeCurrentUrlMatches'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Executes the given regular expression against the current URI and returns the first match.
* If no parameters are provided, the full URI is returned.
*
* ``` php
* <?php
* $user_id = $I->grabFromCurrentUrl('~$/user/(\d+)/~');
* $uri = $I->grabFromCurrentUrl();
* ?>
* ```
*
* @param null $uri
*
* @internal param $url
* @return mixed
* @see \Codeception\Lib\InnerBrowser::grabFromCurrentUrl()
*/
public
function
grabFromCurrentUrl
(
$uri
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabFromCurrentUrl'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the specified checkbox is checked.
*
* ``` php
* <?php
* $I->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\Lib\InnerBrowser::seeCheckboxIsChecked()
*/
public
function
canSeeCheckboxIsChecked
(
$checkbox
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeCheckboxIsChecked'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the specified checkbox is checked.
*
* ``` php
* <?php
* $I->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\Lib\InnerBrowser::seeCheckboxIsChecked()
*/
public
function
seeCheckboxIsChecked
(
$checkbox
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeCheckboxIsChecked'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Check that the specified checkbox is unchecked.
*
* ``` php
* <?php
* $I->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\Lib\InnerBrowser::dontSeeCheckboxIsChecked()
*/
public
function
cantSeeCheckboxIsChecked
(
$checkbox
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeCheckboxIsChecked'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Check that the specified checkbox is unchecked.
*
* ``` php
* <?php
* $I->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\Lib\InnerBrowser::dontSeeCheckboxIsChecked()
*/
public
function
dontSeeCheckboxIsChecked
(
$checkbox
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeCheckboxIsChecked'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given input field or textarea contains the given value.
* For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
*
* ``` php
* <?php
* $I->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');
* $I->seeInField(['name' => 'search'], 'Search');
* ?>
* ```
*
* @param $field
* @param $value
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeInField()
*/
public
function
canSeeInField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given input field or textarea contains the given value.
* For fuzzy locators, fields are matched by label text, the "name" attribute, CSS, and XPath.
*
* ``` php
* <?php
* $I->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');
* $I->seeInField(['name' => 'search'], 'Search');
* ?>
* ```
*
* @param $field
* @param $value
* @see \Codeception\Lib\InnerBrowser::seeInField()
*/
public
function
seeInField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that an input field or textarea doesn't contain the given value.
* For fuzzy locators, the field is matched by label text, CSS and XPath.
*
* ``` php
* <?php
* $I->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');
* $I->dontSeeInField(['name' => 'search'], 'Search');
* ?>
* ```
*
* @param $field
* @param $value
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeInField()
*/
public
function
cantSeeInField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that an input field or textarea doesn't contain the given value.
* For fuzzy locators, the field is matched by label text, CSS and XPath.
*
* ``` php
* <?php
* $I->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');
* $I->dontSeeInField(['name' => 'search'], 'Search');
* ?>
* ```
*
* @param $field
* @param $value
* @see \Codeception\Lib\InnerBrowser::dontSeeInField()
*/
public
function
dontSeeInField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if the array of form parameters (name => value) are set on the form matched with the
* passed selector.
*
* ``` php
* <?php
* $I->seeInFormFields('form[name=myform]', [
* 'input1' => 'value',
* 'input2' => 'other value',
* ]);
* ?>
* ```
*
* For multi-select elements, or to check values of multiple elements with the same name, an
* array may be passed:
*
* ``` php
* <?php
* $I->seeInFormFields('.form-class', [
* 'multiselect' => [
* 'value1',
* 'value2',
* ],
* 'checkbox[]' => [
* 'a checked value',
* 'another checked value',
* ],
* ]);
* ?>
* ```
*
* Additionally, checkbox values can be checked with a boolean.
*
* ``` php
* <?php
* $I->seeInFormFields('#form-id', [
* 'checkbox1' => true, // passes if checked
* 'checkbox2' => false, // passes if unchecked
* ]);
* ?>
* ```
*
* Pair this with submitForm for quick testing magic.
*
* ``` php
* <?php
* $form = [
* 'field1' => 'value',
* 'field2' => 'another value',
* 'checkbox1' => true,
* // ...
* ];
* $I->submitForm('//form[@id=my-form]', $form, 'submitButton');
* // $I->amOnPage('/path/to/form-page') may be needed
* $I->seeInFormFields('//form[@id=my-form]', $form);
* ?>
* ```
*
* @param $formSelector
* @param $params
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeInFormFields()
*/
public
function
canSeeInFormFields
(
$formSelector
,
$params
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInFormFields'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if the array of form parameters (name => value) are set on the form matched with the
* passed selector.
*
* ``` php
* <?php
* $I->seeInFormFields('form[name=myform]', [
* 'input1' => 'value',
* 'input2' => 'other value',
* ]);
* ?>
* ```
*
* For multi-select elements, or to check values of multiple elements with the same name, an
* array may be passed:
*
* ``` php
* <?php
* $I->seeInFormFields('.form-class', [
* 'multiselect' => [
* 'value1',
* 'value2',
* ],
* 'checkbox[]' => [
* 'a checked value',
* 'another checked value',
* ],
* ]);
* ?>
* ```
*
* Additionally, checkbox values can be checked with a boolean.
*
* ``` php
* <?php
* $I->seeInFormFields('#form-id', [
* 'checkbox1' => true, // passes if checked
* 'checkbox2' => false, // passes if unchecked
* ]);
* ?>
* ```
*
* Pair this with submitForm for quick testing magic.
*
* ``` php
* <?php
* $form = [
* 'field1' => 'value',
* 'field2' => 'another value',
* 'checkbox1' => true,
* // ...
* ];
* $I->submitForm('//form[@id=my-form]', $form, 'submitButton');
* // $I->amOnPage('/path/to/form-page') may be needed
* $I->seeInFormFields('//form[@id=my-form]', $form);
* ?>
* ```
*
* @param $formSelector
* @param $params
* @see \Codeception\Lib\InnerBrowser::seeInFormFields()
*/
public
function
seeInFormFields
(
$formSelector
,
$params
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInFormFields'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if the array of form parameters (name => value) are not set on the form matched with
* the passed selector.
*
* ``` php
* <?php
* $I->dontSeeInFormFields('form[name=myform]', [
* 'input1' => 'non-existent value',
* 'input2' => 'other non-existent value',
* ]);
* ?>
* ```
*
* To check that an element hasn't been assigned any one of many values, an array can be passed
* as the value:
*
* ``` php
* <?php
* $I->dontSeeInFormFields('.form-class', [
* 'fieldName' => [
* 'This value shouldn\'t be set',
* 'And this value shouldn\'t be set',
* ],
* ]);
* ?>
* ```
*
* Additionally, checkbox values can be checked with a boolean.
*
* ``` php
* <?php
* $I->dontSeeInFormFields('#form-id', [
* 'checkbox1' => true, // fails if checked
* 'checkbox2' => false, // fails if unchecked
* ]);
* ?>
* ```
*
* @param $formSelector
* @param $params
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeInFormFields()
*/
public
function
cantSeeInFormFields
(
$formSelector
,
$params
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInFormFields'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks if the array of form parameters (name => value) are not set on the form matched with
* the passed selector.
*
* ``` php
* <?php
* $I->dontSeeInFormFields('form[name=myform]', [
* 'input1' => 'non-existent value',
* 'input2' => 'other non-existent value',
* ]);
* ?>
* ```
*
* To check that an element hasn't been assigned any one of many values, an array can be passed
* as the value:
*
* ``` php
* <?php
* $I->dontSeeInFormFields('.form-class', [
* 'fieldName' => [
* 'This value shouldn\'t be set',
* 'And this value shouldn\'t be set',
* ],
* ]);
* ?>
* ```
*
* Additionally, checkbox values can be checked with a boolean.
*
* ``` php
* <?php
* $I->dontSeeInFormFields('#form-id', [
* 'checkbox1' => true, // fails if checked
* 'checkbox2' => false, // fails if unchecked
* ]);
* ?>
* ```
*
* @param $formSelector
* @param $params
* @see \Codeception\Lib\InnerBrowser::dontSeeInFormFields()
*/
public
function
dontSeeInFormFields
(
$formSelector
,
$params
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInFormFields'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Submits the given form on the page, optionally with the given form values.
* Give the form fields values as an array.
*
* Skipped fields will be filled by their values from the page.
* You don't need to click the 'Submit' button afterwards.
* This command itself triggers the request to form's action.
*
* You can optionally specify what button's value to include
* in the request with the last parameter as an alternative to
* explicitly setting its value in the second parameter, as
* button values are not otherwise included in the request.
*
* Examples:
*
* ``` php
* <?php
* $I->submitForm('#login', array('login' => 'davert', 'password' => '123456'));
* // or
* $I->submitForm('#login', array('login' => 'davert', 'password' => '123456'), 'submitButtonName');
*
* ```
*
* For example, given this sample "Sign Up" form:
*
* ``` html
* <form action="/sign_up">
* Login: <input type="text" name="user[login]" /><br/>
* Password: <input type="password" name="user[password]" /><br/>
* Do you agree to out terms? <input type="checkbox" name="user[agree]" /><br/>
* Select pricing plan <select name="plan"><option value="1">Free</option><option value="2" selected="selected">Paid</option></select>
* <input type="submit" name="submitButton" value="Submit" />
* </form>
* ```
*
* You could write the following to submit it:
*
* ``` php
* <?php
* $I->submitForm('#userForm', array('user' => array('login' => 'Davert', 'password' => '123456', 'agree' => true)), 'submitButton');
*
* ```
* Note that "2" will be the submitted value for the "plan" field, as it is the selected option.
*
* You can also emulate a JavaScript submission by not specifying any buttons in the third parameter to submitForm.
*
* ```php
* <?php
* $I->submitForm('#userForm', array('user' => array('login' => 'Davert', 'password' => '123456', 'agree' => true)));
*
* ```
*
* Pair this with seeInFormFields for quick testing magic.
*
* ``` php
* <?php
* $form = [
* 'field1' => 'value',
* 'field2' => 'another value',
* 'checkbox1' => true,
* // ...
* ];
* $I->submitForm('//form[@id=my-form]', $form, 'submitButton');
* // $I->amOnPage('/path/to/form-page') may be needed
* $I->seeInFormFields('//form[@id=my-form]', $form);
* ?>
* ```
*
* Parameter values can be set to arrays for multiple input fields
* of the same name, or multi-select combo boxes. For checkboxes,
* either the string value can be used, or boolean values which will
* be replaced by the checkbox's value in the DOM.
*
* ``` php
* <?php
* $I->submitForm('#my-form', [
* 'field1' => 'value',
* 'checkbox' => [
* 'value of first checkbox',
* 'value of second checkbox,
* ],
* 'otherCheckboxes' => [
* true,
* false,
* false
* ],
* 'multiselect' => [
* 'first option value',
* 'second option value'
* ]
* ]);
* ?>
* ```
*
* Mixing string and boolean values for a checkbox's value is not
* supported and may produce unexpected results.
*
* @param $selector
* @param $params
* @param $button
* @see \Codeception\Lib\InnerBrowser::submitForm()
*/
public
function
submitForm
(
$selector
,
$params
,
$button
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'submitForm'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Fills a text field or textarea with the given string.
*
* ``` php
* <?php
* $I->fillField("//input[@type='text']", "Hello World!");
* $I->fillField(['name' => 'email'], 'jon@mail.com');
* ?>
* ```
*
* @param $field
* @param $value
* @see \Codeception\Lib\InnerBrowser::fillField()
*/
public
function
fillField
(
$field
,
$value
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'fillField'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Selects an option in a select tag or in radio button group.
*
* ``` php
* <?php
* $I->selectOption('form select[name=account]', 'Premium');
* $I->selectOption('form input[name=payment]', 'Monthly');
* $I->selectOption('//form/select[@name=account]', 'Monthly');
* ?>
* ```
*
* Provide an array for the second argument to select multiple options:
*
* ``` php
* <?php
* $I->selectOption('Which OS do you use?', array('Windows','Linux'));
* ?>
* ```
*
* @param $select
* @param $option
* @see \Codeception\Lib\InnerBrowser::selectOption()
*/
public
function
selectOption
(
$select
,
$option
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'selectOption'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Ticks a checkbox. For radio buttons, use the `selectOption` method instead.
*
* ``` php
* <?php
* $I->checkOption('#agree');
* ?>
* ```
*
* @param $option
* @see \Codeception\Lib\InnerBrowser::checkOption()
*/
public
function
checkOption
(
$option
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'checkOption'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Unticks a checkbox.
*
* ``` php
* <?php
* $I->uncheckOption('#notify');
* ?>
* ```
*
* @param $option
* @see \Codeception\Lib\InnerBrowser::uncheckOption()
*/
public
function
uncheckOption
(
$option
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'uncheckOption'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Attaches a file relative to the Codeception data directory to the given file upload field.
*
* ``` php
* <?php
* // file is stored in 'tests/_data/prices.xls'
* $I->attachFile('input[@type="file"]', 'prices.xls');
* ?>
* ```
*
* @param $field
* @param $filename
* @see \Codeception\Lib\InnerBrowser::attachFile()
*/
public
function
attachFile
(
$field
,
$filename
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'attachFile'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* If your page triggers an ajax request, you can perform it manually.
* This action sends a GET ajax request with specified params.
*
* See ->sendAjaxPostRequest for examples.
*
* @param $uri
* @param $params
* @see \Codeception\Lib\InnerBrowser::sendAjaxGetRequest()
*/
public
function
sendAjaxGetRequest
(
$uri
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'sendAjaxGetRequest'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* If your page triggers an ajax request, you can perform it manually.
* This action sends a POST ajax request with specified params.
* Additional params can be passed as array.
*
* Example:
*
* Imagine that by clicking checkbox you trigger ajax request which updates user settings.
* We emulate that click by running this ajax request manually.
*
* ``` php
* <?php
* $I->sendAjaxPostRequest('/updateSettings', array('notifications' => true)); // POST
* $I->sendAjaxGetRequest('/updateSettings', array('notifications' => true)); // GET
*
* ```
*
* @param $uri
* @param $params
* @see \Codeception\Lib\InnerBrowser::sendAjaxPostRequest()
*/
public
function
sendAjaxPostRequest
(
$uri
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'sendAjaxPostRequest'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* If your page triggers an ajax request, you can perform it manually.
* This action sends an ajax request with specified method and params.
*
* Example:
*
* You need to perform an ajax request specifying the HTTP method.
*
* ``` php
* <?php
* $I->sendAjaxRequest('PUT', '/posts/7', array('title' => 'new title'));
*
* ```
*
* @param $method
* @param $uri
* @param $params
* @see \Codeception\Lib\InnerBrowser::sendAjaxRequest()
*/
public
function
sendAjaxRequest
(
$method
,
$uri
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'sendAjaxRequest'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Finds and returns the text contents of the given element.
* If a fuzzy locator is used, the element is found using CSS, XPath, and by matching the full page source by regular expression.
*
* ``` php
* <?php
* $heading = $I->grabTextFrom('h1');
* $heading = $I->grabTextFrom('descendant-or-self::h1');
* $value = $I->grabTextFrom('~<input value=(.*?)]~sgi'); // match with a regex
* ?>
* ```
*
* @param $cssOrXPathOrRegex
*
* @return mixed
* @see \Codeception\Lib\InnerBrowser::grabTextFrom()
*/
public
function
grabTextFrom
(
$cssOrXPathOrRegex
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabTextFrom'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Grabs the value of the given attribute value from the given element.
* Fails if element is not found.
*
* ``` php
* <?php
* $I->grabAttributeFrom('#tooltip', 'title');
* ?>
* ```
*
*
* @param $cssOrXpath
* @param $attribute
* @internal param $element
* @return mixed
* @see \Codeception\Lib\InnerBrowser::grabAttributeFrom()
*/
public
function
grabAttributeFrom
(
$cssOrXpath
,
$attribute
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabAttributeFrom'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* @param $field
*
* @return array|mixed|null|string
* @see \Codeception\Lib\InnerBrowser::grabValueFrom()
*/
public
function
grabValueFrom
(
$field
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabValueFrom'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Sets a cookie with the given name and value.
* You can set additional cookie params like `domain`, `path`, `expire`, `secure` in array passed as last argument.
*
* ``` php
* <?php
* $I->setCookie('PHPSESSID', 'el4ukv0kqbvoirg7nkp4dncpk3');
* ?>
* ```
*
* @param $name
* @param $val
* @param array $params
* @internal param $cookie
* @internal param $value
*
* @return mixed
* @see \Codeception\Lib\InnerBrowser::setCookie()
*/
public
function
setCookie
(
$name
,
$val
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'setCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Grabs a cookie value.
* You can set additional cookie params like `domain`, `path` in array passed as last argument.
*
* @param $cookie
*
* @param array $params
* @return mixed
* @see \Codeception\Lib\InnerBrowser::grabCookie()
*/
public
function
grabCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'grabCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that a cookie with the given name is set.
* You can set additional cookie params like `domain`, `path` as array passed in last argument.
*
* ``` php
* <?php
* $I->seeCookie('PHPSESSID');
* ?>
* ```
*
* @param $cookie
* @param array $params
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeCookie()
*/
public
function
canSeeCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that a cookie with the given name is set.
* You can set additional cookie params like `domain`, `path` as array passed in last argument.
*
* ``` php
* <?php
* $I->seeCookie('PHPSESSID');
* ?>
* ```
*
* @param $cookie
* @param array $params
* @return mixed
* @see \Codeception\Lib\InnerBrowser::seeCookie()
*/
public
function
seeCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there isn't a cookie with the given name.
* You can set additional cookie params like `domain`, `path` as array passed in last argument.
*
* @param $cookie
*
* @param array $params
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeCookie()
*/
public
function
cantSeeCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there isn't a cookie with the given name.
* You can set additional cookie params like `domain`, `path` as array passed in last argument.
*
* @param $cookie
*
* @param array $params
* @return mixed
* @see \Codeception\Lib\InnerBrowser::dontSeeCookie()
*/
public
function
dontSeeCookie
(
$cookie
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Unsets cookie with the given name.
* You can set additional cookie params like `domain`, `path` in array passed as last argument.
*
* @param $cookie
*
* @param array $params
* @return mixed
* @see \Codeception\Lib\InnerBrowser::resetCookie()
*/
public
function
resetCookie
(
$name
,
$params
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Action
(
'resetCookie'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element exists on the page and is visible.
* You can also specify expected attributes of this element.
*
* ``` php
* <?php
* $I->seeElement('.error');
* $I->seeElement('//form/input[1]');
* $I->seeElement('input', ['name' => 'login']);
* $I->seeElement('input', ['value' => '123456']);
*
* // strict locator in first arg, attributes in second
* $I->seeElement(['css' => 'form input'], ['name' => 'login']);
* ?>
* ```
*
* @param $selector
* @param array $attributes
* @return
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeElement()
*/
public
function
canSeeElement
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeElement'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element exists on the page and is visible.
* You can also specify expected attributes of this element.
*
* ``` php
* <?php
* $I->seeElement('.error');
* $I->seeElement('//form/input[1]');
* $I->seeElement('input', ['name' => 'login']);
* $I->seeElement('input', ['value' => '123456']);
*
* // strict locator in first arg, attributes in second
* $I->seeElement(['css' => 'form input'], ['name' => 'login']);
* ?>
* ```
*
* @param $selector
* @param array $attributes
* @return
* @see \Codeception\Lib\InnerBrowser::seeElement()
*/
public
function
seeElement
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeElement'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element is invisible or not present on the page.
* You can also specify expected attributes of this element.
*
* ``` php
* <?php
* $I->dontSeeElement('.error');
* $I->dontSeeElement('//form/input[1]');
* $I->dontSeeElement('input', ['name' => 'login']);
* $I->dontSeeElement('input', ['value' => '123456']);
* ?>
* ```
*
* @param $selector
* @param array $attributes
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeElement()
*/
public
function
cantSeeElement
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeElement'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given element is invisible or not present on the page.
* You can also specify expected attributes of this element.
*
* ``` php
* <?php
* $I->dontSeeElement('.error');
* $I->dontSeeElement('//form/input[1]');
* $I->dontSeeElement('input', ['name' => 'login']);
* $I->dontSeeElement('input', ['value' => '123456']);
* ?>
* ```
*
* @param $selector
* @param array $attributes
* @see \Codeception\Lib\InnerBrowser::dontSeeElement()
*/
public
function
dontSeeElement
(
$selector
,
$attributes
=
null
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeElement'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there are a certain number of elements matched by the given locator on the page.
*
* ``` php
* <?php
* $I->seeNumberOfElements('tr', 10);
* $I->seeNumberOfElements('tr', [0,10]); //between 0 and 10 elements
* ?>
* ```
* @param $selector
* @param mixed $expected:
* - string: strict number
* - array: range of numbers [0,10]
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeNumberOfElements()
*/
public
function
canSeeNumberOfElements
(
$selector
,
$expected
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeNumberOfElements'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that there are a certain number of elements matched by the given locator on the page.
*
* ``` php
* <?php
* $I->seeNumberOfElements('tr', 10);
* $I->seeNumberOfElements('tr', [0,10]); //between 0 and 10 elements
* ?>
* ```
* @param $selector
* @param mixed $expected:
* - string: strict number
* - array: range of numbers [0,10]
* @see \Codeception\Lib\InnerBrowser::seeNumberOfElements()
*/
public
function
seeNumberOfElements
(
$selector
,
$expected
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeNumberOfElements'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given option is selected.
*
* ``` php
* <?php
* $I->seeOptionIsSelected('#form input[name=payment]', 'Visa');
* ?>
* ```
*
* @param $selector
* @param $optionText
*
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeOptionIsSelected()
*/
public
function
canSeeOptionIsSelected
(
$selector
,
$optionText
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeOptionIsSelected'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given option is selected.
*
* ``` php
* <?php
* $I->seeOptionIsSelected('#form input[name=payment]', 'Visa');
* ?>
* ```
*
* @param $selector
* @param $optionText
*
* @return mixed
* @see \Codeception\Lib\InnerBrowser::seeOptionIsSelected()
*/
public
function
seeOptionIsSelected
(
$selector
,
$optionText
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeOptionIsSelected'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given option is not selected.
*
* ``` php
* <?php
* $I->dontSeeOptionIsSelected('#form input[name=payment]', 'Visa');
* ?>
* ```
*
* @param $selector
* @param $optionText
*
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeOptionIsSelected()
*/
public
function
cantSeeOptionIsSelected
(
$selector
,
$optionText
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeOptionIsSelected'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the given option is not selected.
*
* ``` php
* <?php
* $I->dontSeeOptionIsSelected('#form input[name=payment]', 'Visa');
* ?>
* ```
*
* @param $selector
* @param $optionText
*
* @return mixed
* @see \Codeception\Lib\InnerBrowser::dontSeeOptionIsSelected()
*/
public
function
dontSeeOptionIsSelected
(
$selector
,
$optionText
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeOptionIsSelected'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Asserts that current page has 404 response status code.
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seePageNotFound()
*/
public
function
canSeePageNotFound
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seePageNotFound'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Asserts that current page has 404 response status code.
* @see \Codeception\Lib\InnerBrowser::seePageNotFound()
*/
public
function
seePageNotFound
()
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seePageNotFound'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that response code is equal to value provided.
*
* @param $code
*
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeResponseCodeIs()
*/
public
function
canSeeResponseCodeIs
(
$code
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeResponseCodeIs'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that response code is equal to value provided.
*
* @param $code
*
* @return mixed
* @see \Codeception\Lib\InnerBrowser::seeResponseCodeIs()
*/
public
function
seeResponseCodeIs
(
$code
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeResponseCodeIs'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page title contains the given string.
*
* ``` php
* <?php
* $I->seeInTitle('Blog - Post #1');
* ?>
* ```
*
* @param $title
*
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::seeInTitle()
*/
public
function
canSeeInTitle
(
$title
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'seeInTitle'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page title contains the given string.
*
* ``` php
* <?php
* $I->seeInTitle('Blog - Post #1');
* ?>
* ```
*
* @param $title
*
* @return mixed
* @see \Codeception\Lib\InnerBrowser::seeInTitle()
*/
public
function
seeInTitle
(
$title
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'seeInTitle'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page title does not contain the given string.
*
* @param $title
*
* @return mixed
* Conditional Assertion: Test won't be stopped on fail
* @see \Codeception\Lib\InnerBrowser::dontSeeInTitle()
*/
public
function
cantSeeInTitle
(
$title
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\ConditionalAssertion
(
'dontSeeInTitle'
,
func_get_args
()));
}
/**
* [!] Method is generated. Documentation taken from corresponding module.
*
* Checks that the page title does not contain the given string.
*
* @param $title
*
* @return mixed
* @see \Codeception\Lib\InnerBrowser::dontSeeInTitle()
*/
public
function
dontSeeInTitle
(
$title
)
{
return
$this
->
scenario
->
runStep
(
new
\Codeception\Step\Assertion
(
'dontSeeInTitle'
,
func_get_args
()));
}
}
tests/codeception/unit/UnitTester.php
0 → 100644
View file @
6c27ec9c
<?php
//[STAMP] 60e752ec6c360a338a318a32cf68b4f7
// This class was automatically generated by build task
// You should not change it manually as it will be overwritten on next build
// @codingStandardsIgnoreFile
/**
* Inherited Methods
* @method void wantToTest($text)
* @method void wantTo($text)
* @method void execute($callable)
* @method void expectTo($prediction)
* @method void expect($prediction)
* @method void amGoingTo($argumentation)
* @method void am($role)
* @method void lookForwardTo($achieveValue)
* @method void comment($description)
* @method void haveFriend($name, $actorClass = null)
*
* @SuppressWarnings(PHPMD)
*/
class
UnitTester
extends
\Codeception\Actor
{
}
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment