WebInterface,

RemoteInterface,

MultiSessionInterface,

SessionSnapshot,

ScreenshotSaver,

PageSourceSaver,

ElementLocator,

ConflictsWithModule,

RequiresPackage

{

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 $sessions = [];

protected $httpProxy;

protected $httpProxyPort;

protected $sslProxy;

protected $sslProxyPort;

/**

public $webDriver;

public function _requires()

{

return ['Facebook\WebDriver\Remote\RemoteWebDriver' => '"facebook/webdriver": "^1.0.1"'];

}

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();

}

public function _conflicts()

{

return 'Codeception\Lib\Interfaces\Web';

}

public function _before(TestInterface $test)

{

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

$this->_initializeSession();

}

$test->getMetadata()->setCurrent([

'browser' => $this->config['browser'],

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

]);

}

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']) {

$this->cleanWebDriver();

return;

}

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

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

}

}

public function _failed(TestInterface $test, $fail)

{

$this->debugWebDriverLogs();

$filename = preg_replace('~\W~', '.', Descriptor::getTestSignature($test));

$outputDir = codecept_output_dir();

$this->_saveScreenshot($report = $outputDir . mb_strcut($filename, 0, 245, 'utf-8') . '.fail.png');

$test->getMetadata()->addReport('png', $report);

$this->_savePageSource($report = $outputDir . mb_strcut($filename, 0, 244, 'utf-8') . '.fail.html');

$test->getMetadata()->addReport('html', $report);

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

}

/**

public function debugWebDriverLogs()

{

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

$this->debug('WebDriver::debugWebDriverLogs method has been called when webDriver is not set');

return;

}

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 (\Exception $e) {

$this->debug('Unable to retrieve Selenium logs : ' . $e->getMessage());

}

}

/**

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

$this->cleanWebDriver();

}

protected function cleanWebDriver()

{

foreach ($this->sessions as $session) {

$this->_loadSession($session);

try {

$this->webDriver->quit();

} catch (\Exception $e) {

// Session already closed so nothing to do

}

unset($this->webDriver);

}

$this->sessions = [];

}

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 (!isset($this->webDriver)) {

$this->debug('WebDriver::_saveScreenshot method has been called when webDriver is not set');

return;

}

try {

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

} catch (\Exception $e) {

$this->debug('Unable to retrieve screenshot from Selenium : ' . $e->getMessage());

}

}

public function _findElements($locator)

{

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

}

/**

public function _savePageSource($filename)

{

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

$this->debug('WebDriver::_savePageSource method has been called when webDriver is not set');

return;

}

try {

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

} catch (\Exception $e) {

$this->debug('Unable to retrieve source page from Selenium : ' . $e->getMessage());

}

}

/**

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) {

try {

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

} catch (MalformedLocatorException $e) {

throw new ElementNotFound("name=$link", "'$link' is invalid CSS and XPath selector and Link or Button");

}

$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

try {

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

if (!empty($els)) {

return reset($els);

}

} catch (MalformedLocatorException $e) {

//ignore exception, link could still match on of the things below

}

$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(

// @codingStandardsIgnoreStart

".//*[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')]"

// @codingStandardsIgnoreEnd

);

$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 (empty($nodes)) {

$this->fail("No links containing text '$text' were found in page " . $this->_getCurrentUri());

}

if ($url) {

$nodes = array_filter(

$nodes,

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

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

}

);

if (empty($nodes)) {

$this->fail("No links containing text '$text' and URL '$url' were found in page " . $this->_getCurrentUri());

}

}

}

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

{

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

if (!$url) {

if (!empty($nodes)) {

$this->fail("Link containing text '$text' was found in page " . $this->_getCurrentUri());

}

return;

}

$nodes = array_filter(

$nodes,

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

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

}

);

if (!empty($nodes)) {

$this->fail("Link containing text '$text' and URL '$url' was found in page " . $this->_getCurrentUri());

}

}

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);

}

}