class TestSubContext in Drupal Commons 7.3
Hierarchy
- class \TestSubContext extends \Drupal\DrupalExtension\Context\RawDrupalContext implements \Drupal\DrupalExtension\Context\DrupalSubContextInterface
Expanded class hierarchy of TestSubContext
File
- tests/
steps/ commons_test.behat.inc, line 14 - Provide Behat step-definitions for generic Commons tests.
View source
class TestSubContext extends RawDrupalContext implements DrupalSubContextInterface {
/**
* Contains the DrupalDriverManager.
*
* @var \Drupal\DrupalDriverManager
*/
private $drupal = NULL;
/**
* Contains the name of the currently selected iframe.
*
* @var string
*/
private $iframe = NULL;
/**
* An array of Drupal users created by other contexts.
*
* @var array
*/
protected $external_users = array();
/**
* Keep track of files added by tests so they can be cleaned up.
*
* @var array
*/
protected $files = array();
/**
* Set to TRUE if we overrid the private files path during this scenario.
*
* @var bool
*/
protected $private_path_overridden = FALSE;
/**
* Initializes context.
*/
public function __construct(DrupalDriverManager $drupal) {
$this->drupal = $drupal;
}
/**
* Get a region by name.
*
* @param string $region
* The name of the region from the behat.yml file.
*
* @return Behat\Mink\Element\Element
* An element representing the region.
*/
public function getRegion($region) {
$session = $this
->getSession();
$regionObj = $session
->getPage()
->find('region', $region);
if (!$regionObj) {
throw new \Exception(sprintf('No region "%s" found on the page %s.', $region, $session
->getCurrentUrl()));
}
return $regionObj;
}
/**
* Set a variable to mark the current scenario as using javascript.
*
* @BeforeScenario @javascript
*/
public function setJavascript() {
$this->javascript = true;
}
/**
* Unsets the variable marking the current scenario as using javascript.
*
* @AfterScenario @javascript
*/
public function unsetJavascript() {
$this->javascript = false;
}
/**
* Configure a private files path if one isn't already configured.
*
* @BeforeScenario @api&&@drupal_private_files
*/
public function configurePrivateFiles($event) {
$file_private_path = variable_get('file_private_path', '');
if (empty($file_private_path)) {
$file_public_path = variable_get('file_public_path', conf_path() . '/files');
if (empty($file_public_path)) {
throw new \Exception('Files must be configured for @drupal_private_files tests to work!');
}
// Set flag for later cleanup.
$this->private_path_overridden = TRUE;
// Create and setup the private path.
$file_private_path = $file_public_path . '/' . 'private';
variable_set('file_private_path', $file_private_path);
}
}
/**
* Clean up our temporary private files path.
*
* @AfterScenario @api&&@drupal_private_files
*/
public function cleanupPrivateFiles($event) {
if ($this->private_path_overridden) {
variable_del('file_private_path');
}
}
/**
* After every step in a @javascript scenario, we want to wait for AJAX
* loading to finish.
*
* @AfterStep
*/
public function afterStep($event) {
if (isset($this->javascript) && $this->javascript && empty($this->iframe)) {
$text = $event
->getStep()
->getText();
if (preg_match('/(follow|press|click|submit|viewing|visit|reload|attach)/i', $text)) {
$this
->iWaitForAjax();
}
}
}
/**
* Convert escaped characters in arguments.
*
* @Transform :value
* @Transform :text
*/
public function escapeTextArguments($argument) {
$argument = str_replace('\\"', '"', $argument);
$argument = str_replace('\\n', "\n", $argument);
return $argument;
}
/**
* Copies the provided file into the site's files directory.
*
* @Given the managed file :filename
*
* Creates a file object with the URI, and passes that object to a file
* creation function to create the entity.
* The function has to be here for now, as it needs some Mink functions.
*
* @todo See if it can be done without Mink functions?
* @todo Allow creating private files.
* @todo Add before and after event dispatchers.
* @todo Add ability to create multiple files at once using Table.
*/
public function createManagedFile($filename, $public = TRUE) {
// Get location of source file.
if ($this
->getMinkParameter('files_path')) {
$source_path = rtrim(realpath($this
->getMinkParameter('files_path'))) . DIRECTORY_SEPARATOR . $filename;
if (!is_file($source_path)) {
throw new \Exception(sprintf("Cannot find the file at '%s'", $source_path));
}
}
else {
throw new \Exception("files_path not set");
}
$prefix = $public ? 'public://' : 'private://';
$uri = $prefix . $filename;
$this
->fileCreate($source_path, $uri);
}
/**
* Create a managed Drupal file.
*
* @param $source_path
* A file object passed in with the URI already set.
* @param $destination
* (Optional) The desired URI where the file will be uploaded.
*
* @return
* A single Drupal file object.
*/
public function fileCreate($source_path, $destination = NULL) {
$data = file_get_contents($source_path);
// Before working with files, we need to change our current directory to
// DRUPAL_ROOT so that the relative paths that define the stream wrappers
// (like public:// or temporary://) actually work.
$cwd = getcwd();
chdir(DRUPAL_ROOT);
if ($file = file_save_data($data, $destination)) {
$this->files[] = $file;
}
// Then change back.
chdir($cwd);
return $file;
}
/**
* Record all the users created during this scenario.
*
* We need to use this hook so we can get users created in steps on other
* contexts (most probably the DrupalContext).
*
* @AfterUserCreate
*/
public function afterUserCreate(AfterUserCreateScope $scope) {
$user = $scope
->getEntity();
$this->external_users[$user->name] = $user;
}
/**
* Get a list of UIDs.
*
* @return
* An array of numeric UIDs of users created by Given... steps during this scenario.
*/
public function getUIDs() {
$uids = array();
foreach ($this->external_users as $user) {
$uids[] = $user->uid;
}
return $uids;
}
/**
* Cleans up files after every scenario.
*
* @AfterScenario @api
*/
public function cleanFiles($event) {
// Get UIDs of users created during this scenario.
$uids = $this
->getUIDs();
if (!empty($uids)) {
// Add any files created by test users to the $files variable.
$file_ids = db_query('SELECT fid FROM {file_managed} WHERE uid IN (:uids)', array(
':uids' => $uids,
))
->fetchAll();
if (!empty($file_ids)) {
// The file_delete() function expects an object.
foreach ($file_ids as $fid) {
$file = file_load($fid->fid);
$this->files[] = $file;
}
}
}
// Delete any files that were created by test users or our Given step.
if (!empty($this->files)) {
foreach ($this->files as $file) {
$this
->fileDelete($file);
}
}
// Reset the arrays to empty after deletion.
$this->files = array();
}
/**
* Delete a managed Drupal file.
*
* @param $file
* A file object to delete.
*/
public function fileDelete($file) {
// Figure out if there's usage in any nodes.
$fid = $file->fid;
$node_usage = db_query('SELECT id AS nid FROM {file_usage} WHERE fid = (:fid) AND module = (:module) and type = (:node)', array(
':fid' => $fid,
':module' => 'media',
':node' => 'node',
))
->fetchAll();
// If there is, it should be safe to unregister it, because we already know the file is owned by a current test user.
if (!empty($node_usage)) {
foreach ($node_usage as $nid) {
file_usage_delete($file, 'media', 'node', $nid->nid);
}
}
// See CommonsContext::fileCreate() for information on why we do this.
$cwd = getcwd();
chdir(DRUPAL_ROOT);
file_delete($file);
chdir($cwd);
}
/**
* Wait for the given number of seconds. ONLY USE FOR DEBUGGING!
*
* @When (I )wait( for) :seconds second(s)
*/
public function iWaitForSeconds($seconds) {
sleep($seconds);
}
/**
* Wait for AJAX to finish.
*
* @Given I wait for AJAX
*/
public function iWaitForAjax() {
$this
->getSession()
->wait(5000, 'typeof jQuery !== "undefined" && jQuery.active === 0');
}
/**
* Wait until the live preview to finish.
*
* @When I wait for live preview to finish
*/
public function waitForLivePreview() {
// Make sure the live preview has triggered by bluring the current focus.
$this
->getSession()
->executeScript("document.activeElement.blur()");
$this
->getSession()
->wait(5000, 'typeof jQuery !== "undefined" && jQuery.active === 0 && jQuery("#panopoly-form-widget-preview").length > 0 && !jQuery("#panopoly-form-widget-preview").hasClass("panopoly-magic-loading")');
}
/**
* Print the HTML contents of a region for debugging purposes.
*
* @Given print the contents of the :region region
*/
public function printRegionContents($region) {
print $this
->getRegion($region)
->getOuterHtml();
}
/**
* @Given I log in with the One Time Login Url
*/
public function iLogInWithTheOneTimeLoginUrl() {
if ($this
->loggedIn()) {
$this
->logOut();
}
$random = new Random();
// Create user (and project)
$user = (object) array(
'name' => $random
->name(8),
'pass' => $random
->name(16),
'role' => 'authenticated user',
);
$user->mail = "{$user->name}@example.com";
// Create a new user.
$this
->getDriver()
->userCreate($user);
$this->users[$user->name] = $this->user = $user;
$base_url = rtrim($this
->locatePath('/'), '/');
$login_link = $this
->getDriver('drush')
->drush('uli', array(
"'{$user->name}'",
'--browser=0',
"--uri={$base_url}",
));
// Trim EOL characters. Required or else visiting the link won't work.
$login_link = trim($login_link);
$login_link = str_replace("/login", '', $login_link);
$this
->getSession()
->visit($this
->locatePath($login_link));
return TRUE;
}
/**
* @Given I am viewing a landing page
*/
public function iAmViewingALandingPage() {
$node = (object) array(
'type' => 'commons_test_landing_page',
'title' => $this
->getRandom()
->name(8),
);
$saved = $this
->nodeCreate($node);
// Set internal page on the new node.
$this
->getSession()
->visit($this
->locatePath('/node/' . $saved->nid));
}
/**
* @When I switch to the frame :frame
*/
public function iSwitchToTheFrame($frame) {
$this
->getSession()
->switchToIFrame($frame);
$this->iframe = $frame;
}
/**
* @When I switch out of all frames
*/
public function iSwitchOutOfAllFrames() {
$this
->getSession()
->switchToIFrame();
$this->iframe = NULL;
}
/**
* @Then I should see :text in the :tag element in the :region region
*/
public function assertRegionElementText($text, $tag, $region) {
$regionObj = $this
->getRegion($region);
$elements = $regionObj
->findAll('css', $tag);
if (empty($elements)) {
throw new \Exception(sprintf('The element "%s" was not found in the "%s" region on the page %s', $tag, $region, $this
->getSession()
->getCurrentUrl()));
}
$found = FALSE;
foreach ($elements as $element) {
if ($element
->getText() == $text) {
$found = TRUE;
break;
}
}
if (!$found) {
throw new \Exception(sprintf('The text "%s" was not found in the "%s" element in the "%s" region on the page %s', $text, $tag, $region, $this
->getSession()
->getCurrentUrl()));
}
}
/**
* @Then I should not see :text in the :tag element with the :attribute attribute set to :value in the :region region
*/
public function assertNotRegionElementTextAttribute($text, $tag, $attribute, $value, $region) {
$regionObj = $this
->getRegion($region);
$elements = $regionObj
->findAll('css', $tag);
if (!empty($elements)) {
foreach ($elements as $element) {
if ($element
->getText() == $text) {
$attr = $element
->getAttribute($attribute);
if (!empty($attr) && strpos($attr, "{$value}") !== FALSE) {
throw new \Exception(sprintf('The text "%s" was found in the "%s" element with the "%s" attribute set to "%s" in the "%s" region on the page %s', $text, $tag, $attribute, $value, $region, $this
->getSession()
->getCurrentUrl()));
}
}
}
}
}
/**
* Asserts that the region contains text matching specified pattern.
*
* @Then I should see text matching :pattern in the :region region
*/
public function assertRegionMatchesText($pattern, $region) {
$regionObj = $this
->getRegion($region);
// Find the text within the region
$regionText = $regionObj
->getText();
if (!preg_match($pattern, $regionText)) {
throw new \Exception(sprintf("No text matching '%s' was found in the region '%s' on the page %s", $pattern, $region, $this
->getSession()
->getCurrentUrl()));
}
}
/**
* Asserts that the region does not contain text matching specified pattern.
*
* @Then I should not see text matching :pattern in the :region region
*/
public function assertNotRegionMatchesText($pattern, $region) {
$regionObj = $this
->getRegion($region);
// Find the text within the region
$regionText = $regionObj
->getText();
if (preg_match($pattern, $regionText)) {
throw new \Exception(sprintf("Text matching '%s' was found in the region '%s' on the page %s", $pattern, $region, $this
->getSession()
->getCurrentUrl()));
}
}
/**
* Asserts that an image is present and not broken.
*
* @Then I should see an image in the :region region
*/
public function assertValidImageRegion($region) {
$regionObj = $this
->getRegion($region);
$elements = $regionObj
->findAll('css', 'img');
if (empty($elements)) {
throw new \Exception(sprintf('No image was not found in the "%s" region on the page %s', $region, $this
->getSession()
->getCurrentUrl()));
}
if ($src = $elements[0]
->getAttribute('src')) {
$params = array(
'http' => array(
'method' => 'HEAD',
),
);
$context = stream_context_create($params);
$fp = @fopen($src, 'rb', FALSE, $context);
if (!$fp) {
throw new \Exception(sprintf('Unable to download <img src="%s"> in the "%s" region on the page %s', $src, $region, $this
->getSession()
->getCurrentUrl()));
}
$meta = stream_get_meta_data($fp);
fclose($fp);
if ($meta === FALSE) {
throw new \Exception(sprintf('Error reading from <img src="%s"> in the "%s" region on the page %s', $src, $region, $this
->getSession()
->getCurrentUrl()));
}
$wrapper_data = $meta['wrapper_data'];
$found = FALSE;
if (is_array($wrapper_data)) {
foreach ($wrapper_data as $header) {
if (substr(strtolower($header), 0, 19) == 'content-type: image') {
$found = TRUE;
}
}
}
if (!$found) {
throw new \Exception(sprintf('Not a valid image <img src="%s"> in the "%s" region on the page %s', $src, $region, $this
->getSession()
->getCurrentUrl()));
}
}
else {
throw new \Exception(sprintf('No image had no src="..." attribute in the "%s" region on the page %s', $region, $this
->getSession()
->getCurrentUrl()));
}
}
/**
* @Then /^I should see the image alt "(?P<text>(?:[^"]|\\")*)" in the "(?P<region>[^"]*)" region$/
*
* NOTE: We specify a regex to allow escaped quotes in the alt text.
*/
public function assertAltRegion($text, $region) {
$regionObj = $this
->getRegion($region);
$element = $regionObj
->find('css', 'img');
$tmp = $element
->getAttribute('alt');
if ($text == $tmp) {
$result = $text;
}
if (empty($result)) {
throw new \Exception(sprintf('No alt text matching "%s" in the "%s" region on the page %s', $text, $region, $this
->getSession()
->getCurrentUrl()));
}
}
/**
* @Then the :field radio button should be set to :option
*
* @link: https://www.drupal.org/node/1891584 @endlink
*/
public function theRadioButtonShouldBeSetTo($field, $option) {
$page = $this
->getSession()
->getPage();
$div = $page
->find('xpath', "//div[contains(., '{$field}') and @class[contains(.,'form-type-radio')]]");
if ($div) {
$radios = $div
->find('xpath', "//input[@type='radio']");
if ($radios) {
$checkedRadio = $div
->find('xpath', "//input[@type='radio' and @checked='checked']/following-sibling::label[contains(text(), '{$option}')] ");
if (!$checkedRadio) {
throw new \Exception(sprintf('We found the radio buttons for "%s", but "%s" was not selected.', $field, $option));
}
}
elseif (!$radios) {
throw new \Exception(sprintf('We found "%s", but it did not contain any radio buttons".', $field));
}
}
elseif (!$div) {
throw new \Exception(sprintf('We couldn\'nt find "%s" on the page', $field));
}
else {
throw new \Exception('General exception from ' . __FUNCTION__);
}
}
/**
* @Then I should see the radio button :field with the id :id
* @Then I should see the radio button :field
*/
public function assertSeeRadioById($field, $id = FALSE) {
$element = $this
->getSession()
->getPage();
$radiobutton = $id ? $element
->findById($id) : $element
->find('named', array(
'radio',
$this
->getSession()
->getSelectorsHandler()
->xpathLiteral($field),
));
if ($radiobutton === NULL) {
throw new \Exception(sprintf('The radio button with "%s" was not found on the page %s', $id ? $id : $field, $this
->getSession()
->getCurrentUrl()));
}
if ($id) {
$value = $radiobutton
->getAttribute('value');
$labelonpage = $radiobutton
->getParent()
->getText();
if ($field != $labelonpage) {
throw new \Exception(sprintf("Button with id '%s' has label '%s' instead of '%s' on the page %s", $id, $labelonpage, $field, $this
->getSession()
->getCurrentUrl()));
}
}
}
/**
* @Then I should not see the radio button :field with the id :id
* @Then I should not see the radio button :field
*/
public function assertNotSeeRadioById($field, $id = FALSE) {
$element = $this
->getSession()
->getPage();
$radiobutton = $id ? $element
->findById($id) : $element
->find('named', array(
'radio',
$this
->getSession()
->getSelectorsHandler()
->xpathLiteral($field),
));
if ($radiobutton !== NULL) {
throw new \Exception(sprintf('The radio button with "%s" was found on the page %s', $id ? $id : $field, $this
->getSession()
->getCurrentUrl()));
}
}
/**
* @Then the :field select should be set to :value
*/
public function theSelectShouldBeSetTo($field, $value) {
$select = $this
->getSession()
->getPage()
->findField($field);
if (empty($select)) {
throw new \Exception(sprintf('We couldn\'nt find "%s" on the page', $field));
}
$options = $select
->findAll('xpath', '//option[@selected="selected"]');
if (empty($select)) {
throw new \Exception(sprintf('The select "%s" doesn\'t have any options selected', $field));
}
$found = FALSE;
foreach ($options as $option) {
if ($option
->getText() === $value) {
$found = TRUE;
break;
}
}
if (!$found) {
throw new \Exception(sprintf('The select "%s" doesn\'t have the option "%s" selected', $field, $value));
}
}
/**
* @Given the dblog is empty
*/
public function clearDblog() {
db_delete('watchdog')
->execute();
}
/**
* @When I select the first autocomplete option for :text on the :field field
*/
public function iSelectFirstAutocomplete($text, $field) {
$session = $this
->getSession();
$page = $session
->getPage();
$element = $page
->findField($field);
if (empty($element)) {
throw new \Exception(sprintf('We couldn\'t find "%s" on the page', $field));
}
$page
->fillField($field, $text);
$xpath = $element
->getXpath();
$driver = $session
->getDriver();
// autocomplete.js uses key down/up events directly.
// Press the backspace key.
$driver
->keyDown($xpath, 8);
$driver
->keyUp($xpath, 8);
// Retype the last character.
$chars = str_split($text);
$last_char = array_pop($chars);
$driver
->keyDown($xpath, $last_char);
$driver
->keyUp($xpath, $last_char);
// Wait for AJAX to finish.
$this
->iWaitForAJAX();
// And make sure the autocomplete is showing.
$this
->getSession()
->wait(5000, 'jQuery("#autocomplete").show().length > 0');
// And wait for 1 second just to be sure.
sleep(1);
// Press the down arrow to select the first option.
$driver
->keyDown($xpath, 40);
$driver
->keyUp($xpath, 40);
// Press the Enter key to confirm selection, copying the value into the field.
$driver
->keyDown($xpath, 13);
$driver
->keyUp($xpath, 13);
// Wait for AJAX to finish.
$this
->iWaitForAJAX();
}
/**
* @Given :module has the :dependency dependency at position :key
*/
public function moduleHasDependencyAtKey($module, $dependency, $key) {
if (!module_exists($module)) {
throw new \Exception("{$module} is not enabled.");
}
if (!module_exists($dependency)) {
throw new \Exception("{$dependency} is not enabled.");
}
$info = drupal_parse_info_file(drupal_get_path('module', $module) . '/' . $module . '.info');
if ($info['dependencies'][$key] != $dependency) {
throw new \Exception("{$module} did not have {$dependency} dependency at {$key} position");
}
}
}
Members
Name![]() |
Modifiers | Type | Description | Overrides |
---|---|---|---|---|
TestSubContext:: |
private | property | Contains the DrupalDriverManager. | |
TestSubContext:: |
protected | property | An array of Drupal users created by other contexts. | |
TestSubContext:: |
protected | property | Keep track of files added by tests so they can be cleaned up. | |
TestSubContext:: |
private | property | Contains the name of the currently selected iframe. | |
TestSubContext:: |
protected | property | Set to TRUE if we overrid the private files path during this scenario. | |
TestSubContext:: |
public | function | After every step in a @javascript scenario, we want to wait for AJAX loading to finish. | |
TestSubContext:: |
public | function | Record all the users created during this scenario. | |
TestSubContext:: |
public | function | @Then /^I should see the image alt "(?P<text>(?:[^"]|\\")*)" in the "(?P<region>[^"]*)" region$/ | |
TestSubContext:: |
public | function | @Then I should not see :text in the :tag element with the :attribute attribute set to :value in the :region region | |
TestSubContext:: |
public | function | Asserts that the region does not contain text matching specified pattern. | |
TestSubContext:: |
public | function | @Then I should not see the radio button :field with the id :id @Then I should not see the radio button :field | |
TestSubContext:: |
public | function | @Then I should see :text in the :tag element in the :region region | |
TestSubContext:: |
public | function | Asserts that the region contains text matching specified pattern. | |
TestSubContext:: |
public | function | @Then I should see the radio button :field with the id :id @Then I should see the radio button :field | |
TestSubContext:: |
public | function | Asserts that an image is present and not broken. | |
TestSubContext:: |
public | function | Cleans up files after every scenario. | |
TestSubContext:: |
public | function | Clean up our temporary private files path. | |
TestSubContext:: |
public | function | @Given the dblog is empty | |
TestSubContext:: |
public | function | Configure a private files path if one isn't already configured. | |
TestSubContext:: |
public | function | Copies the provided file into the site's files directory. | |
TestSubContext:: |
public | function | Convert escaped characters in arguments. | |
TestSubContext:: |
public | function | Create a managed Drupal file. | |
TestSubContext:: |
public | function | Delete a managed Drupal file. | |
TestSubContext:: |
public | function | Get a region by name. | |
TestSubContext:: |
public | function | Get a list of UIDs. | |
TestSubContext:: |
public | function | @Given I am viewing a landing page | |
TestSubContext:: |
public | function | @Given I log in with the One Time Login Url | |
TestSubContext:: |
public | function | @When I select the first autocomplete option for :text on the :field field | |
TestSubContext:: |
public | function | @When I switch out of all frames | |
TestSubContext:: |
public | function | @When I switch to the frame :frame | |
TestSubContext:: |
public | function | Wait for AJAX to finish. | |
TestSubContext:: |
public | function | Wait for the given number of seconds. ONLY USE FOR DEBUGGING! | |
TestSubContext:: |
public | function | @Given :module has the :dependency dependency at position :key | |
TestSubContext:: |
public | function | Print the HTML contents of a region for debugging purposes. | |
TestSubContext:: |
public | function | Set a variable to mark the current scenario as using javascript. | |
TestSubContext:: |
public | function | @Then the :field radio button should be set to :option | |
TestSubContext:: |
public | function | @Then the :field select should be set to :value | |
TestSubContext:: |
public | function | Unsets the variable marking the current scenario as using javascript. | |
TestSubContext:: |
public | function | Wait until the live preview to finish. | |
TestSubContext:: |
public | function | Initializes context. |