WebInterface,

RemoteInterface,

MultiSessionInterface,

SessionSnapshot,

ScreenshotSaver,

PageSourceSaver,

ElementLocator,

ConflictsWithModule

{

protected $requiredFields = ['browser', 'url'];

protected $config = [

'host' => '127.0.0.1',

'port' => '4444',

'restart' => false,

'wait' => 0,

'clear_cookies' => true,

'window_size' => false,

'capabilities' => [],

'connection_timeout' => null,

'request_timeout' => null,

'http_proxy' => null,

'http_proxy_port' => null,

'ssl_proxy' => null,

'ssl_proxy_port' => null,

'debug_log_entries' => 15,

];

protected $wd_host;

protected $capabilities;

protected $connectionTimeoutInMs;

protected $requestTimeoutInMs;

protected $test;

protected $sessionSnapshots = [];

protected $httpProxy;

protected $httpProxyPort;

protected $sslProxy;

protected $sslProxyPort;

/**

public $webDriver;

public function _initialize()

{

$this->wd_host = sprintf('http://%s:%s/wd/hub', $this->config['host'], $this->config['port']);

$this->capabilities = $this->config['capabilities'];

$this->capabilities[WebDriverCapabilityType::BROWSER_NAME] = $this->config['browser'];

if ($proxy = $this->getProxy()) {

$this->capabilities[WebDriverCapabilityType::PROXY] = $proxy;

}

$this->connectionTimeoutInMs = $this->config['connection_timeout'] * 1000;

$this->requestTimeoutInMs = $this->config['request_timeout'] * 1000;

$this->loadFirefoxProfile();

try {

$this->webDriver = RemoteWebDriver::create(

$this->wd_host,

$this->capabilities,

$this->connectionTimeoutInMs,

$this->requestTimeoutInMs,

$this->httpProxy,

$this->httpProxyPort

);

} catch (WebDriverCurlException $e) {

throw new ConnectionException($e->getMessage() . "\n \nPlease make sure that Selenium Server or PhantomJS is running.");

}

$this->webDriver->manage()->timeouts()->implicitlyWait($this->config['wait']);

$this->initialWindowSize();

}

public function _conflicts()

{

return 'Codeception\Lib\Interfaces\Web';

}

public function _before(TestInterface $test)

{

if (!isset($this->webDriver)) {

$this->_initialize();

}

}

protected function loadFirefoxProfile()

{

if (!array_key_exists('firefox_profile', $this->config['capabilities'])) {

return;

}

$firefox_profile = $this->config['capabilities']['firefox_profile'];

if (file_exists($firefox_profile) === false) {

throw new ModuleConfigException(__CLASS__, "Firefox profile does not exist under given path " . $firefox_profile);

}

// Set firefox profile as capability

$this->capabilities['firefox_profile'] = file_get_contents($firefox_profile);

}

protected function initialWindowSize()

{

if ($this->config['window_size'] == 'maximize') {

$this->maximizeWindow();

return;

}

$size = explode('x', $this->config['window_size']);

if (count($size) == 2) {

$this->resizeWindow(intval($size[0]), intval($size[1]));

}

}

public function _after(TestInterface $test)

{

if ($this->config['restart'] && isset($this->webDriver)) {

$this->webDriver->quit();

// RemoteWebDriver consists of four parts, executor, mouse, keyboard and touch, quit only set executor to null,

// but RemoteWebDriver doesn't provide public access to check on executor

// so we need to unset $this->webDriver here to shut it down completely

$this->webDriver = null;

return;

}

if ($this->config['clear_cookies'] && isset($this->webDriver)) {

$this->webDriver->manage()->deleteAllCookies();

}

}

public function _failed(TestInterface $test, $fail)

{

$this->debugWebDriverLogs();

$filename = str_replace([':', '\\', '/'], ['.', '', ''], Descriptor::getTestSignature($test)) . '.fail';

$this->_saveScreenshot(codecept_output_dir() . $filename . '.png');

$this->_savePageSource(codecept_output_dir() . $filename . '.html');

$this->debug("Screenshot and page source were saved into '_output' dir");

}

/**

public function debugWebDriverLogs()

{

try {

// Dump out latest Selenium logs

$logs = $this->webDriver->manage()->getAvailableLogTypes();

foreach ($logs as $logType) {

$logEntries = array_slice($this->webDriver->manage()->getLog($logType), -$this->config['debug_log_entries']);

if (empty($logEntries)) {

$this->debugSection("Selenium {$logType} Logs", " EMPTY ");

continue;

}

$this->debugSection("Selenium {$logType} Logs", "\n" . $this->formatLogEntries($logEntries));

}

} catch (UnknownServerException $e) {

// This only happens with the IE driver, which doesn't support retrieving logs yet:

// https://github.com/SeleniumHQ/selenium/issues/468

$this->debug("Unable to retrieve Selenium logs");

}

}

/**

protected function formatLogEntries(array $logEntries)

{

$formattedLogs = '';

foreach ($logEntries as $logEntry) {

// Timestamp is in milliseconds, but date() requires seconds.

$time = date('H:i:s', $logEntry['timestamp'] / 1000) .

// Append the milliseconds to the end of the time string

'.' . ($logEntry['timestamp'] % 1000);

$formattedLogs .= "{$time} {$logEntry['level']} - {$logEntry['message']}\n";

}

return $formattedLogs;

}

public function _afterSuite()

{

// this is just to make sure webDriver is cleared after suite

if (isset($this->webDriver)) {

$this->webDriver->quit();

unset($this->webDriver);

}

}

public function amOnSubdomain($subdomain)

{

$url = $this->config['url'];

$url = preg_replace('~(https?:\/\/)(.*\.)(.*\.)~', "$1$3", $url); // removing current subdomain

$url = preg_replace('~(https?:\/\/)(.*)~', "$1$subdomain.$2", $url); // inserting new

$this->_reconfigure(['url' => $url]);

}

/**

public function _getUrl()

{

if (!isset($this->config['url'])) {

throw new ModuleConfigException(

__CLASS__,

"Module connection failure. The URL for client can't bre retrieved"

);

}

return $this->config['url'];

}

protected function getProxy()

{

$proxyConfig = [];

if ($this->config['http_proxy']) {

$proxyConfig['httpProxy'] = $this->config['http_proxy'];

if ($this->config['http_proxy_port']) {

$proxyConfig['httpProxy'] .= ':' . $this->config['http_proxy_port'];

}

}

if ($this->config['ssl_proxy']) {

$proxyConfig['sslProxy'] = $this->config['ssl_proxy'];

if ($this->config['ssl_proxy_port']) {

$proxyConfig['sslProxy'] .= ':' . $this->config['ssl_proxy_port'];

}

}

if (!empty($proxyConfig)) {

$proxyConfig['proxyType'] = 'manual';

return $proxyConfig;

}

return null;

}

/**

public function _getCurrentUri()

{

$url = $this->webDriver->getCurrentURL();

if ($url == 'about:blank') {

throw new ModuleException($this, "Current url is blank, no page was opened");

}

return Uri::retrieveUri($url);

}

public function _saveScreenshot($filename)

{

if ($this->webDriver !== null) {

$this->webDriver->takeScreenshot($filename);

} else {

codecept_debug('WebDriver::_saveScreenshot method has been called when webDriver is not set');

codecept_debug(debug_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS));

}

}

public function _findElements($locator)

{

return $this->match($this->webDriver, $locator);

}

/**

public function _savePageSource($filename)

{

file_put_contents($filename, $this->webDriver->getPageSource());

}

/**

public function makeScreenshot($name)

{

$debugDir = codecept_log_dir() . 'debug';

if (!is_dir($debugDir)) {

mkdir($debugDir, 0777);

}

$screenName = $debugDir . DIRECTORY_SEPARATOR . $name . '.png';

$this->_saveScreenshot($screenName);

$this->debug("Screenshot saved to $screenName");

}

/**

public function resizeWindow($width, $height)

{

$this->webDriver->manage()->window()->setSize(new WebDriverDimension($width, $height));

}

public function seeCookie($cookie, array $params = [])

{

$cookies = $this->filterCookies($this->webDriver->manage()->getCookies(), $params);

$cookies = array_map(

function ($c) {

return $c['name'];

}, $cookies

);

$this->debugSection('Cookies', json_encode($this->webDriver->manage()->getCookies()));

$this->assertContains($cookie, $cookies);

}

public function dontSeeCookie($cookie, array $params = [])

{

$cookies = $this->filterCookies($this->webDriver->manage()->getCookies(), $params);

$cookies = array_map(

function ($c) {

return $c['name'];

}, $cookies

);

$this->debugSection('Cookies', json_encode($this->webDriver->manage()->getCookies()));

$this->assertNotContains($cookie, $cookies);

}

public function setCookie($cookie, $value, array $params = [])

{

$params['name'] = $cookie;

$params['value'] = $value;

if (isset($params['expires'])) { // PhpBrowser compatibility

$params['expiry'] = $params['expires'];

}

if (!isset($params['domain'])) {

$urlParts = parse_url($this->config['url']);

if (isset($urlParts['host'])) {

$params['domain'] = $urlParts['host'];

}

}

$this->webDriver->manage()->addCookie($params);

$this->debugSection('Cookies', json_encode($this->webDriver->manage()->getCookies()));

}

public function resetCookie($cookie, array $params = [])

{

$this->webDriver->manage()->deleteCookieNamed($cookie);

$this->debugSection('Cookies', json_encode($this->webDriver->manage()->getCookies()));

}

public function grabCookie($cookie, array $params = [])

{

$params['name'] = $cookie;

$cookies = $this->filterCookies($this->webDriver->manage()->getCookies(), $params);

if (empty($cookies)) {

return null;

}

$cookie = reset($cookies);

return $cookie['value'];

}

protected function filterCookies($cookies, $params = [])

{

foreach (['domain', 'path', 'name'] as $filter) {

if (!isset($params[$filter])) {

continue;

}

$cookies = array_filter(

$cookies,

function ($item) use ($filter, $params) {

return $item[$filter] == $params[$filter];

}

);

}

return $cookies;

}

public function amOnUrl($url)

{

$host = Uri::retrieveHost($url);

$this->_reconfigure(['url' => $host]);

$this->debugSection('Host', $host);

$this->webDriver->get($url);

}

public function amOnPage($page)

{

$url = Uri::appendPath($this->config['url'], $page);

$this->debugSection('GET', $url);

$this->webDriver->get($url);

}

public function see($text, $selector = null)

{

if (!$selector) {

return $this->assertPageContains($text);

}

$nodes = $this->matchVisible($selector);

$this->assertNodesContain($text, $nodes, $selector);

}

public function dontSee($text, $selector = null)

{

if (!$selector) {

return $this->assertPageNotContains($text);

}

$nodes = $this->matchVisible($selector);

$this->assertNodesNotContain($text, $nodes, $selector);

}

public function seeInSource($raw)

{

$this->assertPageSourceContains($raw);

}

public function dontSeeInSource($raw)

{

$this->assertPageSourceNotContains($raw);

}

/**

public function seeInPageSource($text)

{

$this->assertThat(

$this->webDriver->getPageSource(),

new PageConstraint($text, $this->_getCurrentUri()),

''

);

}

/**

public function dontSeeInPageSource($text)

{

$this->assertThatItsNot(

$this->webDriver->getPageSource(),

new PageConstraint($text, $this->_getCurrentUri()),

''

);

}

public function click($link, $context = null)

{

$page = $this->webDriver;

if ($context) {

$page = $this->matchFirstOrFail($this->webDriver, $context);

}

$el = $this->findClickable($page, $link);

if (!$el) {

$els = $this->match($page, $link);

$el = reset($els);

}

if (!$el) {

throw new ElementNotFound($link, 'Link or Button or CSS or XPath');

}

$el->click();

}

/**

protected function findClickable($page, $link)

{

if (is_array($link) or ($link instanceof WebDriverBy)) {

return $this->matchFirstOrFail($page, $link);

}

// try to match by CSS or XPath

$els = $this->match($page, $link, false);

if (!empty($els)) {

return reset($els);

}

$locator = Crawler::xpathLiteral(trim($link));

// narrow

$xpath = Locator::combine(

".//a[normalize-space(.)=$locator]",

".//button[normalize-space(.)=$locator]",

".//a/img[normalize-space(@alt)=$locator]/ancestor::a",

".//input[./@type = 'submit' or ./@type = 'image' or ./@type = 'button'][normalize-space(@value)=$locator]"

);

$els = $page->findElements(WebDriverBy::xpath($xpath));

if (count($els)) {

return reset($els);

}

// wide

$xpath = Locator::combine(

".//a[./@href][((contains(normalize-space(string(.)), $locator)) or .//img[contains(./@alt, $locator)])]",

".//input[./@type = 'submit' or ./@type = 'image' or ./@type = 'button'][contains(./@value, $locator)]",

".//input[./@type = 'image'][contains(./@alt, $locator)]",

".//button[contains(normalize-space(string(.)), $locator)]",

".//input[./@type = 'submit' or ./@type = 'image' or ./@type = 'button'][./@name = $locator]",

".//button[./@name = $locator]"

);

$els = $page->findElements(WebDriverBy::xpath($xpath));

if (count($els)) {

return reset($els);

}

return null;

}

/**

protected function findFields($selector)

{

if ($selector instanceof WebDriverElement) {

return [$selector];

}

if (is_array($selector) || ($selector instanceof WebDriverBy)) {

$fields = $this->match($this->webDriver, $selector);

if (empty($fields)) {

throw new ElementNotFound($selector);

}

return $fields;

}

$locator = Crawler::xpathLiteral(trim($selector));

// by text or label

$xpath = Locator::combine(

".//*[self::input | self::textarea | self::select][not(./@type = 'submit' or ./@type = 'image' or ./@type = 'hidden')][(((./@name = $locator) or ./@id = //label[contains(normalize-space(string(.)), $locator)]/@for) or ./@placeholder = $locator)]",

".//label[contains(normalize-space(string(.)), $locator)]//.//*[self::input | self::textarea | self::select][not(./@type = 'submit' or ./@type = 'image' or ./@type = 'hidden')]"

);

$fields = $this->webDriver->findElements(WebDriverBy::xpath($xpath));

if (!empty($fields)) {

return $fields;

}

// by name

$xpath = ".//*[self::input | self::textarea | self::select][@name = $locator]";

$fields = $this->webDriver->findElements(WebDriverBy::xpath($xpath));

if (!empty($fields)) {

return $fields;

}

// try to match by CSS or XPath

$fields = $this->match($this->webDriver, $selector, false);

if (!empty($fields)) {

return $fields;

}

throw new ElementNotFound($selector, "Field by name, label, CSS or XPath");

}

/**

protected function findField($selector)

{

$arr = $this->findFields($selector);

return reset($arr);

}

public function seeLink($text, $url = null)

{

$nodes = $this->webDriver->findElements(WebDriverBy::partialLinkText($text));

if (!$url) {

$this->assertNodesContain($text, $nodes, 'a');

return;

}

$this->assertNodesContain($text, $nodes, "a[href=$url]");

}

public function dontSeeLink($text, $url = null)

{

$nodes = $this->webDriver->findElements(WebDriverBy::partialLinkText($text));

if (!$url) {

$this->assertNodesNotContain($text, $nodes, 'a');

return;

}

$nodes = array_filter(

$nodes,

function (WebDriverElement $e) use ($url) {

return trim($e->getAttribute('href')) == trim($url);

}

);

$this->assertNodesNotContain($text, $nodes, "a[href=$url]");

}

public function seeInCurrentUrl($uri)

{

$this->assertContains($uri, $this->_getCurrentUri());

}

public function seeCurrentUrlEquals($uri)

{

$this->assertEquals($uri, $this->_getCurrentUri());

}

public function seeCurrentUrlMatches($uri)

{

$this->assertRegExp($uri, $this->_getCurrentUri());

}

public function dontSeeInCurrentUrl($uri)

{

$this->assertNotContains($uri, $this->_getCurrentUri());

}

public function dontSeeCurrentUrlEquals($uri)

{

$this->assertNotEquals($uri, $this->_getCurrentUri());

}

public function dontSeeCurrentUrlMatches($uri)

{

$this->assertNotRegExp($uri, $this->_getCurrentUri());

}

public function grabFromCurrentUrl($uri = null)

{

if (!$uri) {

return $this->_getCurrentUri();

}

$matches = [];

$res = preg_match($uri, $this->_getCurrentUri(), $matches);

if (!$res) {

$this->fail("Couldn't match $uri in " . $this->_getCurrentUri());

}

if (!isset($matches[1])) {

$this->fail("Nothing to grab. A regex parameter required. Ex: '/user/(\\d+)'");

}

return $matches[1];

}

public function seeCheckboxIsChecked($checkbox)

{

$this->assertTrue($this->findField($checkbox)->isSelected());

}

public function dontSeeCheckboxIsChecked($checkbox)

{

$this->assertFalse($this->findField($checkbox)->isSelected());

}

public function seeInField($field, $value)

{

$els = $this->findFields($field);

$this->assert($this->proceedSeeInField($els, $value));

}

public function dontSeeInField($field, $value)

{

$els = $this->findFields($field);

$this->assertNot($this->proceedSeeInField($els, $value));

}

public function seeInFormFields($formSelector, array $params)

{

$this->proceedSeeInFormFields($formSelector, $params, false);

}

public function dontSeeInFormFields($formSelector, array $params)

{

$this->proceedSeeInFormFields($formSelector, $params, true);

}

protected function proceedSeeInFormFields($formSelector, array $params, $assertNot)

{

$form = $this->match($this->webDriver, $formSelector);

if (empty($form)) {

throw new ElementNotFound($formSelector, "Form via CSS or XPath");

}

$form = reset($form);

foreach ($params as $name => $values) {

$els = $form->findElements(WebDriverBy::name($name));

if (empty($els)) {

throw new ElementNotFound($name);

}

if (!is_array($values)) {

$values = [$values];

}

foreach ($values as $value) {

$ret = $this->proceedSeeInField($els, $value);

if ($assertNot) {

$this->assertNot($ret);

} else {

$this->assert($ret);

}

}

}

}

protected function proceedSeeInField(array $elements, $value)

{

$strField = reset($elements)->getAttribute('name');

if (reset($elements)->getTagName() === 'select') {

$el = reset($elements);

$elements = $el->findElements(WebDriverBy::xpath('.//option[@selected]'));

if (empty($value) && empty($elements)) {

return ['True', true];

}

}

$currentValues = [];

if (is_bool($value)) {

$currentValues = [false];

}

foreach ($elements as $el) {

if ($el->getTagName() === 'textarea') {

$currentValues[] = $el->getAttribute('value');

} elseif ($el->getTagName() === 'input' && $el->getAttribute('type') === 'radio' || $el->getAttribute('type') === 'checkbox') {

if ($el->getAttribute('checked')) {

if (is_bool($value)) {

$currentValues = [true];

break;

} else {

$currentValues[] = $el->getAttribute('value');

}

}

} else {

$currentValues[] = $el->getAttribute('value');

}

}

return [

'Contains',

$value,

$currentValues,

"Failed testing for '$value' in $strField's value: " . implode(', ', $currentValues)

];

}

public function selectOption($select, $option)

{

$el = $this->findField($select);

if ($el->getTagName() != 'select') {

$els = $this->matchCheckables($select);

$radio = null;

foreach ($els as $el) {

$radio = $this->findCheckable($el, $option, true);

if ($radio) {

break;

}

}

if (!$radio) {

throw new ElementNotFound($select, "Radiobutton with value or name '$option in");

}

$radio->click();

return;

}

$wdSelect = new WebDriverSelect($el);

if ($wdSelect->isMultiple()) {

$wdSelect->deselectAll();

}

if (!is_array($option)) {

$option = [$option];

}

$matched = false;

foreach ($option as $opt) {

try {

$wdSelect->selectByVisibleText($opt);

$matched = true;

} catch (NoSuchElementException $e) {

}

}

if ($matched) {

return;

}

foreach ($option as $opt) {

try {

$wdSelect->selectByValue($opt);

$matched = true;

} catch (NoSuchElementException $e) {

}

}

if ($matched) {

return;

}

// partially matching

foreach ($option as $opt) {

try {

$optElement = $el->findElement(WebDriverBy::xpath('//option [contains (., "' . $opt . '")]'));

$matched = true;

if (!$optElement->isSelected()) {

$optElement->click();

}

} catch (NoSuchElementException $e) {

}

}

if ($matched) {

return;

}

throw new ElementNotFound(json_encode($option), "Option inside $select matched by name or value");

}

public function _initializeSession()

{

$this->webDriver = RemoteWebDriver::create($this->wd_host, $this->capabilities);

$this->webDriver->manage()->timeouts()->implicitlyWait($this->config['wait']);

}

public function _loadSession($session)

{

$this->webDriver = $session;

}

public function _backupSession()

{

return $this->webDriver;