For additional reference, please review the source

Uses Mink to manipulate Selenium2 WebDriver

Note that all method take CSS selectors to fetch elements.

On test failure the browser window screenshot will be saved to log directory

Download Selenium2 WebDriver Launch the daemon: java -jar selenium-server-standalone-2.xx.xxx.jar

Don't forget to turn on Db repopulation if you are using database.

• Maintainer: davert
• Stability: stable
• Contact: codecept@davert.mail.ua
• relies on Mink

• url required - start url for your app
• browser required - browser that would be launched
• host - Selenium server host (localhost by default)
• port - Selenium server port (4444 by default)
• delay - set delay between actions in milliseconds (1/1000 of second) if they run too fast
• capabilities - sets Selenium2 desired capabilities. Should be a key-value array.

modules:
   enabled: [Selenium2]
   config:
      Selenium2:
         url: 'http://localhost/'
         browser: firefox
         capabilities:
             unexpectedAlertBehaviour: 'accept'

• session - contains Mink Session
• webDriverSession - contains webDriverSession object, i.e. $session from php-webdriver

Accept alert or confirm popup

Example: {% highlight php %}

{% endhighlight %}

• param $field
• param $filename

Removes focus from link or button or any node found by CSS or XPath XPath or CSS selectors are accepted.

• param $el

Dismiss alert or confirm popup

Example: {% highlight php %}

{% endhighlight %}

• param $option

Perform a click on link or button. Link or button are found by their names or CSS selector. Submits a form if button is a submit type.

If link is an image it's found by alt attribute value of image. If button is image button is found by it's value If link or button can't be found by name they are searched by CSS selector.

The second parameter is a context: CSS or XPath locator to narrow the search.

Examples:

{% highlight php %}

{% endhighlight %}

• param $link
• param $context

Clicks with right button on link or button or any node found by CSS or XPath

• param $link

Check if current page doesn't contain the text specified. Specify the css selector to match only specific region.

Examples:

{% highlight php %}

• param $uri

Checks that current url does not match a RegEx value

• param $uri

Checks if element does not exist (or is visible) on a page, matching it by CSS or XPath

{% highlight php %}

{% endhighlight %}

• param $selector

Checks that current uri does not contain a value

{% highlight php %}

{% endhighlight %}

• param $uri

Checks that an input field or textarea doesn't contain value. Field is matched either by label or CSS or Xpath Example:

{% highlight php %}

{% endhighlight %}

• param $field
• param $value

Check if popup don't contains the $text

Example: {% highlight php %}

{% endhighlight %}

• param $selector
• param $optionText
• return mixed

Double clicks on link or button or any node found by CSS or XPath

• param $link

Drag first element to second XPath or CSS selectors are accepted.

• param $el1
• param $el2

Low-level API method. If Codeception commands are not enough, use Selenium WebDriver methods directly

{% highlight php %}

$I->executeInSelenium(function(\WebDriver\Session $webdriver) { $webdriver->back(); });

{% endhighlight %}

Use WebDriver Session API Not recommended this command too be used on regular basis. If Codeception lacks important Selenium methods implement then and submit patches.

• param callable $function

Executes any JS code.

• param $jsCode

Fills a text field or textarea with value.

• param $field
• param $value

Moves focus to link or button or any node found by CSS or XPath

• param $el

not documented

Takes a parameters from current URI by RegEx. If no url provided returns full URI.

{% highlight php %}

{% endhighlight %}

• param null $uri
• internal param $url
• return mixed

Finds and returns text contents of element. Element is searched by CSS selector, XPath or matcher by regex.

Example:

{% highlight php %}

{% endhighlight %}

• param $cssOrXPathOrRegex
• return mixed

Finds and returns field and returns it's value. Searches by field name, then by CSS, then by XPath

Example:

{% highlight php %}

{% endhighlight %}

• param $field
• return mixed

Moves back in history

Moves forward in history

Moves mouse over link or button or any node found by CSS or XPath

• param $link

Presses key on element found by css, xpath is focused A char and modifier (ctrl, alt, shift, meta) can be provided.

Example:

{% highlight php %}

{% endhighlight %}

• param $element
• param $char char can be either char ('b') or char-code (98)
• param null $modifier keyboard modifier (could be 'ctrl', 'alt', 'shift' or 'meta')

Presses key down on element found by CSS or XPath.

For example see 'pressKey'.

• param $element
• param $char char can be either char ('b') or char-code (98)
• param null $modifier keyboard modifier (could be 'ctrl', 'alt', 'shift' or 'meta')

Presses key up on element found by CSS or XPath.

For example see 'pressKey'.

• param $element
• param $char char can be either char ('b') or char-code (98)
• param null $modifier keyboard modifier (could be 'ctrl', 'alt', 'shift' or 'meta')

Reloads current page

Resize current window

Example: {% highlight php %}

• param $uri

Checks that current url is matches a RegEx value

• param $uri

Checks element visibility. Fails if element exists but is invisible to user. Eiter CSS or XPath can be used.

• param $selector

Checks that current uri contains a value

{% highlight php %}

{% endhighlight %}

• param $uri

Checks that an input field or textarea contains value. Field is matched either by label or CSS or Xpath

Example:

{% highlight php %}

{% endhighlight %}

• param $field
• param $value

Checks if popup contains the $text

Example: {% highlight php %}

{% endhighlight %}

• param $selector
• param $optionText
• return mixed

Selects an option in select tag or in radio button group.

Example:

{% highlight php %}

{% endhighlight %}

• param $select
• param $option

Switch to another frame

Example: {% highlight html %}

{% endhighlight %}

{% highlight php %}

{% endhighlight %}

• param $option

Wait for x milliseconds

• param $milliseconds

Waits for x milliseconds or until JS condition turns true.

• param $milliseconds
• param $jsCondition