<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle. If not, see <http://www.gnu.org/licenses/>.
/**
* Navigation steps definitions.
*
* @package core
* @category test
* @copyright 2012 David MonllaĆ³
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
// NOTE: no MOODLE_INTERNAL test here, this file may be required by behat before including /config.php.
require_once(__DIR__ . '/../../behat/behat_base.php');
use Behat\Mink\Exception\ExpectationException as ExpectationException;
use Behat\Mink\Exception\DriverException as DriverException;
use Behat\Mink\Exception\ElementNotFoundException as ElementNotFoundException;
/**
* Steps definitions to navigate through the navigation tree nodes.
*
* @package core
* @category test
* @copyright 2012 David MonllaĆ³
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class behat_navigation extends behat_base {
/**
> * Checks whether a navigation node is active within the block navigation.
* Helper function to get a navigation nodes text element given its text from within the navigation block.
> *
*
> * @Given i should see :name is active in navigation
* This function finds the node with the given text from within the navigation block.
> *
* It checks to make sure the node is visible, and then returns it.
> * @throws ElementNotFoundException
*
> * @param string $element The name of the nav elemnent to look for.
* @param string $text
> * @return void
* @param bool $branch Set this true if you're only interested in the node if its a branch.
> */
* @param null|bool $collapsed Set this to true or false if you want the node to either be collapsed or not.
> public function i_should_see_is_active_in_navigation($element) {
* If its left as null then we don't worry about it.
> $this->execute("behat_general::assert_element_contains_text",
* @param null|string|Exception|false $exception The exception to throw if the node is not found.
> [$element, '.block_navigation .active_tree_node', 'css_element']);
* @return \Behat\Mink\Element\NodeElement
> }
*/
>
protected function get_node_text_node($text, $branch = false, $collapsed = null, $exception = null) {
> /**
if ($exception === null) {
$exception = new ExpectationException('The "' . $text . '" node could not be found', $this->getSession());
} else if (is_string($exception)) {
$exception = new ExpectationException($exception, $this->getSession());
}
$nodetextliteral = behat_context_helper::escape($text);
$hasblocktree = "[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]";
$hasbranch = "[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]";
$hascollapsed = "li[@aria-expanded='false']/p";
$notcollapsed = "li[@aria-expanded='true']/p";
$match = "[normalize-space(.)={$nodetextliteral}]";
// Avoid problems with quotes.
$isbranch = ($branch) ? $hasbranch : '';
if ($collapsed === true) {
$iscollapsed = $hascollapsed;
} else if ($collapsed === false) {
$iscollapsed = $notcollapsed;
} else {
$iscollapsed = 'li/p';
}
// First check root nodes, it can be a span or link.
$xpath = "//ul{$hasblocktree}/{$hascollapsed}{$isbranch}/span{$match}|";
$xpath .= "//ul{$hasblocktree}/{$hascollapsed}{$isbranch}/a{$match}|";
// Next search for the node containing the text within a link.
$xpath .= "//ul{$hasblocktree}//ul/{$iscollapsed}{$isbranch}/a{$match}|";
// Finally search for the node containing the text within a span.
$xpath .= "//ul{$hasblocktree}//ul/{$iscollapsed}{$isbranch}/span{$match}";
$node = $this->find('xpath', $xpath, $exception);
$this->ensure_node_is_visible($node);
return $node;
}
/**
* Returns true if the navigation node with the given text is expandable.
*
* @Given /^navigation node "([^"]*)" should be expandable$/
*
* @throws ExpectationException
* @param string $nodetext
* @return bool
*/
public function navigation_node_should_be_expandable($nodetext) {
if (!$this->running_javascript()) {
// Nodes are only expandable when JavaScript is enabled.
return false;
}
$node = $this->get_node_text_node($nodetext, true);
$node = $node->getParent();
if ($node->hasClass('emptybranch')) {
throw new ExpectationException('The "' . $nodetext . '" node is not expandable', $this->getSession());
}
return true;
}
/**
* Returns true if the navigation node with the given text is not expandable.
*
* @Given /^navigation node "([^"]*)" should not be expandable$/
*
* @throws ExpectationException
* @param string $nodetext
* @return bool
*/
public function navigation_node_should_not_be_expandable($nodetext) {
if (!$this->running_javascript()) {
// Nodes are only expandable when JavaScript is enabled.
return false;
}
$node = $this->get_node_text_node($nodetext);
$node = $node->getParent();
if ($node->hasClass('emptybranch') || $node->hasClass('tree_item')) {
return true;
}
throw new ExpectationException('The "' . $nodetext . '" node is expandable', $this->getSession());
}
/**
* Click on an entry in the user menu.
* @Given /^I follow "(?P<nodetext_string>(?:[^"]|\\")*)" in the user menu$/
*
* @param string $nodetext
*/
public function i_follow_in_the_user_menu($nodetext) {
if ($this->running_javascript()) {
// The user menu must be expanded when JS is enabled.
$xpath = "//div[contains(concat(' ', @class, ' '), ' usermenu ')]//a[contains(concat(' ', @class, ' '), ' dropdown-toggle ')]";
$this->execute("behat_general::i_click_on", array($this->escape($xpath), "xpath_element"));
}
// Now select the link.
// The CSS path is always present, with or without JS.
$csspath = ".usermenu .dropdown-menu";
$this->execute('behat_general::i_click_on_in_the',
array($nodetext, "link", $csspath, "css_element")
);
}
/**
* Expands the selected node of the navigation tree that matches the text.
* @Given /^I expand "(?P<nodetext_string>(?:[^"]|\\")*)" node$/
*
* @throws ExpectationException
* @param string $nodetext
* @return bool|void
*/
public function i_expand_node($nodetext) {
// This step is useless with Javascript disabled as Moodle auto expands
// all of tree's nodes; adding this because of scenarios that shares the
// same steps with and without Javascript enabled.
if (!$this->running_javascript()) {
if ($nodetext === get_string('administrationsite')) {
// Administration menu is not loaded by default any more. Click the link to expand.
$this->execute('behat_general::i_click_on_in_the',
array($nodetext, "link", get_string('administration'), "block")
);
return true;
}
return true;
}
$node = $this->get_node_text_node($nodetext, true, true, 'The "' . $nodetext . '" node can not be expanded');
// Check if the node is a link AND a branch.
if (strtolower($node->getTagName()) === 'a') {
// We just want to expand the node, we don't want to follow it.
$node = $node->getParent();
}
$this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
}
/**
* Collapses the selected node of the navigation tree that matches the text.
*
* @Given /^I collapse "(?P<nodetext_string>(?:[^"]|\\")*)" node$/
* @throws ExpectationException
* @param string $nodetext
* @return bool|void
*/
public function i_collapse_node($nodetext) {
// No collapsible nodes with non-JS browsers.
if (!$this->running_javascript()) {
return true;
}
$node = $this->get_node_text_node($nodetext, true, false, 'The "' . $nodetext . '" node can not be collapsed');
// Check if the node is a link AND a branch.
if (strtolower($node->getTagName()) === 'a') {
// We just want to expand the node, we don't want to follow it.
$node = $node->getParent();
}
$this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
}
/**
* Finds a node in the Navigation or Administration tree
*
* @param string $nodetext
* @param array $parentnodes
* @param string $nodetype node type (link or text)
* @return NodeElement|null
* @throws ExpectationException when one of the parent nodes is not found
*/
protected function find_node_in_navigation($nodetext, $parentnodes, $nodetype = 'link') {
// Site admin is different and needs special treatment.
$siteadminstr = get_string('administrationsite');
// Create array of all parentnodes.
$countparentnode = count($parentnodes);
// If JS is disabled and Site administration is not expanded we
// should follow it, so all the lower-level nodes are available.
if (!$this->running_javascript()) {
if ($parentnodes[0] === $siteadminstr) {
// We don't know if there if Site admin is already expanded so
// don't wait, it is non-JS and we already waited for the DOM.
$siteadminlink = $this->getSession()->getPage()->find('named_exact', array('link', "'" . $siteadminstr . "'"));
if ($siteadminlink) {
$this->execute('behat_general::i_click_on', [$siteadminlink, 'NodeElement']);
}
}
}
// Get top level node.
$node = $this->get_top_navigation_node($parentnodes[0]);
// Expand all nodes.
for ($i = 0; $i < $countparentnode; $i++) {
if ($i > 0) {
// Sub nodes within top level node.
$node = $this->get_navigation_node($parentnodes[$i], $node);
}
// The p node contains the aria jazz.
$pnodexpath = "/p[contains(concat(' ', normalize-space(@class), ' '), ' tree_item ')]";
$pnode = $node->find('xpath', $pnodexpath);
$linode = $pnode->getParent();
// Keep expanding all sub-parents if js enabled.
if ($pnode && $this->running_javascript() && $linode->hasAttribute('aria-expanded') &&
($linode->getAttribute('aria-expanded') == "false")) {
$this->js_trigger_click($pnode);
// Wait for node to load, if not loaded before.
if ($linode->hasAttribute('data-loaded') && $linode->getAttribute('data-loaded') == "false") {
$jscondition = '(document.evaluate("' . $linode->getXpath() . '", document, null, '.
'XPathResult.ANY_TYPE, null).iterateNext().getAttribute(\'data-loaded\') == "true")';
$this->getSession()->wait(behat_base::get_extended_timeout() * 1000, $jscondition);
}
}
}
// Finally, click on requested node under navigation.
$nodetextliteral = behat_context_helper::escape($nodetext);
$tagname = ($nodetype === 'link') ? 'a' : 'span';
$xpath = "/ul/li/p[contains(concat(' ', normalize-space(@class), ' '), ' tree_item ')]" .
"/{$tagname}[normalize-space(.)=" . $nodetextliteral . "]";
return $node->find('xpath', $xpath);
}
/**
* Finds a node in the Navigation or Administration tree and clicks on it.
*
* @param string $nodetext
* @param array $parentnodes
* @throws ExpectationException
*/
protected function select_node_in_navigation($nodetext, $parentnodes) {
$nodetoclick = $this->find_node_in_navigation($nodetext, $parentnodes);
// Throw exception if no node found.
if (!$nodetoclick) {
throw new ExpectationException('Navigation node "' . $nodetext . '" not found under "' .
implode(' > ', $parentnodes) . '"', $this->getSession());
}
$this->execute('behat_general::i_click_on', [$nodetoclick, 'NodeElement']);
}
/**
* Helper function to get top navigation node in tree.
*
* @throws ExpectationException if note not found.
* @param string $nodetext name of top navigation node in tree.
* @return NodeElement
*/
protected function get_top_navigation_node($nodetext) {
// Avoid problems with quotes.
$nodetextliteral = behat_context_helper::escape($nodetext);
$exception = new ExpectationException('Top navigation node "' . $nodetext . ' not found in "', $this->getSession());
// First find in navigation block.
$xpath = "//div[contains(concat(' ', normalize-space(@class), ' '), ' card-text ')]" .
"/ul[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]" .
"/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" .
"/ul/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" .
"[p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" .
"/*[contains(normalize-space(.), " . $nodetextliteral .")]]" .
"|" .
"//div[contains(concat(' ', normalize-space(@class), ' '), ' card-text ')]/div" .
"/ul[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]" .
"/li[p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" .
"/*[contains(normalize-space(.), " . $nodetextliteral .")]]";
$node = $this->find('xpath', $xpath, $exception);
return $node;
}
/**
* Helper function to get sub-navigation node.
*
* @throws ExpectationException if note not found.
* @param string $nodetext node to find.
* @param NodeElement $parentnode parent navigation node.
* @return NodeElement.
*/
protected function get_navigation_node($nodetext, $parentnode = null) {
// Avoid problems with quotes.
$nodetextliteral = behat_context_helper::escape($nodetext);
$xpath = "/ul/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" .
"[child::p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" .
"/child::span[normalize-space(.)=" . $nodetextliteral ."]]";
$node = $parentnode->find('xpath', $xpath);
if (!$node) {
$xpath = "/ul/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" .
"[child::p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" .
"/child::a[normalize-space(.)=" . $nodetextliteral ."]]";
$node = $parentnode->find('xpath', $xpath);
}
if (!$node) {
throw new ExpectationException('Sub-navigation node "' . $nodetext . '" not found under "' .
$parentnode->getText() . '"', $this->getSession());
}
return $node;
}
/**
* Step to open the navigation bar if it is needed.
*
* The top log in and log out links are hidden when middle or small
* size windows (or devices) are used. This step returns a step definition
* clicking to expand the navbar if it is hidden.
*
* @Given /^I expand navigation bar$/
*/
public function get_expand_navbar_step() {
// Checking if we need to click the navbar button to show the navigation menu, it
// is hidden by default when using clean theme and a medium or small screen size.
// The DOM and the JS should be all ready and loaded. Running without spinning
// as this is a widely used step and we can not spend time here trying to see
// a DOM node that is not always there (at the moment clean is not even the
// default theme...).
$navbuttonjs = "return (
Y.one('.btn-navbar') &&
Y.one('.btn-navbar').getComputedStyle('display') !== 'none'
)";
// Adding an extra click we need to show the 'Log in' link.
if (!$this->evaluate_script($navbuttonjs)) {
return false;
}
$this->execute('behat_general::i_click_on', array(".btn-navbar", "css_element"));
}
/**
* Go to current page setting item
*
* This can be used on front page, course, category or modules pages.
*
* @Given /^I navigate to "(?P<nodetext_string>(?:[^"]|\\")*)" in current page administration$/
*
* @throws ExpectationException
* @param string $nodetext navigation node to click, may contain path, for example "Reports > Overview"
* @return void
*/
public function i_navigate_to_in_current_page_administration($nodetext) {
$nodelist = array_map('trim', explode('>', $nodetext));
$this->select_from_administration_menu($nodelist);
}
/**
* Checks that current page administration contains text
*
* @Given /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should exist in current page administration$/
*
* @throws ExpectationException
* @param string $element The locator of the specified selector.
* This may be a path, for example "Subscription mode > Forced subscription"
* @param string $selectortype The selector type (link or text)
* @return void
*/
public function should_exist_in_current_page_administration($element, $selectortype) {
$nodes = array_map('trim', explode('>', $element));
$nodetext = end($nodes);
// Find administration menu.
> if (!$menuxpath = $this->find_page_action_menu()) {
$menuxpath = $this->find_header_administration_menu() ?: $this->find_page_administration_menu(true);
> }
$this->toggle_page_administration_menu($menuxpath);
$this->execute('behat_general::should_exist_in_the', [$nodetext, $selectortype, $menuxpath, 'xpath_element']);
$this->toggle_page_administration_menu($menuxpath);
}
/**
* Checks that current page administration contains text
*
* @Given /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should not exist in current page administration$/
*
* @throws ExpectationException
* @param string $element The locator of the specified selector.
* This may be a path, for example "Subscription mode > Forced subscription"
* @param string $selectortype The selector type (link or text)
* @return void
*/
public function should_not_exist_in_current_page_administration($element, $selectortype) {
$nodes = array_map('trim', explode('>', $element));
$nodetext = end($nodes);
// Find administration menu.
$menuxpath = $this->find_header_administration_menu() ?: $this->find_page_administration_menu();
if (!$menuxpath) {
// Menu not found, exit.
return;
}
$this->toggle_page_administration_menu($menuxpath);
$this->execute('behat_general::should_not_exist_in_the', [$nodetext, $selectortype, $menuxpath, 'xpath_element']);
$this->toggle_page_administration_menu($menuxpath);
}
/**
* Go to site administration item
*
* @Given /^I navigate to "(?P<nodetext_string>(?:[^"]|\\")*)" in site administration$/
*
* @throws ExpectationException
* @param string $nodetext navigation node to click, may contain path, for example "Reports > Overview"
* @return void
*/
public function i_navigate_to_in_site_administration($nodetext) {
$nodelist = array_map('trim', explode('>', $nodetext));
< $this->i_select_from_flat_navigation_drawer(get_string('administrationsite'));
> $this->i_select_from_primary_navigation(get_string('administrationsite'));
$this->select_on_administration_page($nodelist);
}
/**
* Opens the current users profile page in edit mode.
*
* @Given /^I open my profile in edit mode$/
* @throws coding_exception
* @return void
*/
public function i_open_my_profile_in_edit_mode() {
global $USER;
$user = $this->get_session_user();
$globuser = $USER;
$USER = $user; // We need this set to the behat session user so we can call isloggedin.
$systemcontext = context_system::instance();
$bodynode = $this->find('xpath', 'body');
$bodyclass = $bodynode->getAttribute('class');
$matches = [];
if (preg_match('/(?<=^course-|\scourse-)\d+/', $bodyclass, $matches) && !empty($matches)) {
$courseid = intval($matches[0]);
} else {
$courseid = SITEID;
}
if (isloggedin() && !isguestuser($user) && !is_mnet_remote_user($user)) {
if (is_siteadmin($user) || has_capability('moodle/user:update', $systemcontext)) {
$url = new moodle_url('/user/editadvanced.php', array('id' => $user->id, 'course' => SITEID,
'returnto' => 'profile'));
} else if (has_capability('moodle/user:editownprofile', $systemcontext)) {
$userauthplugin = false;
if (!empty($user->auth)) {
$userauthplugin = get_auth_plugin($user->auth);
}
if ($userauthplugin && $userauthplugin->can_edit_profile()) {
$url = $userauthplugin->edit_profile_url();
if (empty($url)) {
if (empty($course)) {
$url = new moodle_url('/user/edit.php', array('id' => $user->id, 'returnto' => 'profile'));
} else {
$url = new moodle_url('/user/edit.php', array('id' => $user->id, 'course' => $courseid,
'returnto' => 'profile'));
}
}
}
}
$this->execute('behat_general::i_visit', [$url]);
}
// Restore global user variable.
$USER = $globuser;
}
/**
* Open a given page, belonging to a plugin or core component.
*
* The page-type are interpreted by each plugin to work out the
* corresponding URL. See the resolve_url method in each class like
* behat_mod_forum. That method should document which page types are
* recognised, and how the name identifies them.
*
* For pages belonging to core, the 'core > ' bit is omitted.
*
* @When /^I am on the (?<page>[^ "]*) page$/
* @When /^I am on the "(?<page>[^"]*)" page$/
*
* @param string $page the component and page name.
* E.g. 'Admin notifications' or 'core_user > Preferences'.
* @throws Exception if the specified page cannot be determined.
*/
public function i_am_on_page(string $page) {
$this->execute('behat_general::i_visit', [$this->resolve_page_helper($page)]);
}
/**
* Open a given page logged in as a given user.
*
* This is like the combination
* When I log in as "..."
* And I am on the "..." page
* but with the advantage that you go straight to the desired page, without
* having to wait for the Dashboard to load.
*
* @When /^I am on the (?<page>[^ "]*) page logged in as (?<username>[^ "]*)$/
* @When /^I am on the "(?<page>[^"]*)" page logged in as (?<username>[^ "]*)$/
* @When /^I am on the (?<page>[^ "]*) page logged in as "(?<username>[^ "]*)"$/
* @When /^I am on the "(?<page>[^"]*)" page logged in as "(?<username>[^ "]*)"$/
*
* @param string $page the type of page. E.g. 'Admin notifications' or 'core_user > Preferences'.
* @param string $username the name of the user to log in as. E.g. 'admin'.
* @throws Exception if the specified page cannot be determined.
*/
public function i_am_on_page_logged_in_as(string $page, string $username) {
self::execute('behat_auth::i_log_in_as', [$username, $this->resolve_page_helper($page)]);
}
/**
* Helper used by i_am_on_page() and i_am_on_page_logged_in_as().
*
* @param string $page the type of page. E.g. 'Admin notifications' or 'core_user > Preferences'.
* @return moodle_url the corresponding URL.
*/
protected function resolve_page_helper(string $page): moodle_url {
list($component, $name) = $this->parse_page_name($page);
if ($component === 'core') {
return $this->resolve_core_page_url($name);
} else {
$context = behat_context_helper::get('behat_' . $component);
return $context->resolve_page_url($name);
}
}
/**
* Parse a full page name like 'Admin notifications' or 'core_user > Preferences'.
*
* E.g. parsing 'mod_quiz > View' gives ['mod_quiz', 'View'].
*
* @param string $page the full page name
* @return array with two elements, component and page name.
*/
protected function parse_page_name(string $page): array {
$dividercount = substr_count($page, ' > ');
if ($dividercount === 0) {
return ['core', $page];
} else if ($dividercount >= 1) {
[$component, $name] = explode(' > ', $page, 2);
if ($component === 'core') {
throw new coding_exception('Do not specify the component "core > ..." for core pages.');
}
return [$component, $name];
} else {
throw new coding_exception('The page name must be in the form ' .
'"{page-name}" for core pages, or "{component} > {page-name}" ' .
'for pages belonging to other components. ' .
'For example "Admin notifications" or "mod_quiz > View".');
}
}
/**
* Open a given instance of a page, belonging to a plugin or core component.
*
* The instance identifier and page-type are interpreted by each plugin to
* work out the corresponding URL. See the resolve_page_instance_url method
* in each class like behat_mod_forum. That method should document which page
* types are recognised, and how the name identifies them.
*
* For pages belonging to core, the 'core > ' bit is omitted.
*
* @When /^I am on the (?<identifier>[^ "]*) (?<type>[^ "]*) page$/
* @When /^I am on the "(?<identifier>[^"]*)" "(?<type>[^"]*)" page$/
* @When /^I am on the (?<identifier>[^ "]*) "(?<type>[^"]*)" page$/
* @When /^I am on the "(?<identifier>[^"]*)" (?<type>[^ "]*) page$/
*
* @param string $identifier identifies the particular page. E.g. 'Test quiz'.
* @param string $type the component and page type. E.g. 'mod_quiz > View'.
* @throws Exception if the specified page cannot be determined.
*/
public function i_am_on_page_instance(string $identifier, string $type) {
$this->execute('behat_general::i_visit', [$this->resolve_page_instance_helper($identifier, $type)]);
}
/**
* Open a given page logged in as a given user.
*
* This is like the combination
* When I log in as "..."
* And I am on the "..." "..." page
* but with the advantage that you go straight to the desired page, without
* having to wait for the Dashboard to load.
*
* @When /^I am on the (?<identifier>[^ "]*) (?<type>[^ "]*) page logged in as (?<username>[^ "]*)$/
* @When /^I am on the "(?<identifier>[^"]*)" "(?<type>[^"]*)" page logged in as (?<username>[^ "]*)$/
* @When /^I am on the (?<identifier>[^ "]*) "(?<type>[^"]*)" page logged in as (?<username>[^ "]*)$/
* @When /^I am on the "(?<identifier>[^"]*)" (?<type>[^ "]*) page logged in as (?<username>[^ "]*)$/
* @When /^I am on the (?<identifier>[^ "]*) (?<type>[^ "]*) page logged in as "(?<username>[^"]*)"$/
* @When /^I am on the "(?<identifier>[^"]*)" "(?<type>[^"]*)" page logged in as "(?<username>[^"]*)"$/
* @When /^I am on the (?<identifier>[^ "]*) "(?<type>[^"]*)" page logged in as "(?<username>[^"]*)"$/
* @When /^I am on the "(?<identifier>[^"]*)" (?<type>[^ "]*) page logged in as "(?<username>[^"]*)"$/
*
* @param string $identifier identifies the particular page. E.g. 'Test quiz'.
* @param string $type the component and page type. E.g. 'mod_quiz > View'.
* @param string $username the name of the user to log in as. E.g. 'student'.
* @throws Exception if the specified page cannot be determined.
*/
public function i_am_on_page_instance_logged_in_as(string $identifier,
string $type, string $username) {
self::execute('behat_auth::i_log_in_as',
[$username, $this->resolve_page_instance_helper($identifier, $type)]);
}
/**
* Helper used by i_am_on_page() and i_am_on_page_logged_in_as().
*
* @param string $identifier identifies the particular page. E.g. 'Test quiz'.
* @param string $pagetype the component and page type. E.g. 'mod_quiz > View'.
* @return moodle_url the corresponding URL.
*/
protected function resolve_page_instance_helper(string $identifier, string $pagetype): moodle_url {
list($component, $type) = $this->parse_page_name($pagetype);
if ($component === 'core') {
return $this->resolve_core_page_instance_url($type, $identifier);
} else {
$context = behat_context_helper::get('behat_' . $component);
return $context->resolve_page_instance_url($type, $identifier);
}
}
/**
* Convert core page names to URLs for steps like 'When I am on the "[page name]" page'.
*
* Recognised page names are:
* | Homepage | Homepage (normally dashboard). |
* | Admin notifications | Admin notification screen. |
*
* @param string $name identifies which identifies this page, e.g. 'Homepage', 'Admin notifications'.
* @return moodle_url the corresponding URL.
* @throws Exception with a meaningful error message if the specified page cannot be found.
*/
protected function resolve_core_page_url(string $name): moodle_url {
switch ($name) {
case 'Homepage':
return new moodle_url('/');
> case 'My courses':
case 'Admin notifications':
> return new moodle_url('/my/courses.php');
return new moodle_url('/admin/');
>
default:
throw new Exception('Unrecognised core page type "' . $name . '."');
}
}
/**
* Convert page names to URLs for steps like 'When I am on the "[identifier]" "[page type]" page'.
*
* Recognised page names are:
* | Page type | Identifier meaning | description |
* | Category | category idnumber | List of courses in that category. |
< * | Course | course shortname | Main course home pag |
> * | Course | course shortname | Main course home page |
* | Course editing | course shortname | Edit settings page for the course |
* | Activity | activity idnumber | Start page for that activity |
* | Activity editing | activity idnumber | Edit settings page for that activity |
* | [modname] Activity | activity name or idnumber | Start page for that activity |
* | [modname] Activity editing | activity name or idnumber | Edit settings page for that activity |
> * | Backup | course shortname | Course to backup |
*
> * | Import | course shortname | Course import from |
* Examples:
> * | Restore | course shortname | Course to restore from |
*
> * | Reset | course shortname | Course to reset |
* When I am on the "Welcome to ECON101" "forum activity" page logged in as student1
> * | Course copy | course shortname | Course to copy |
*
> * | Groups | course shortname | Groups page for the course |
* @param string $type identifies which type of page this is, e.g. 'Category page'.
> * | Permissions | course shortname | Permissions page for the course |
* @param string $identifier identifies the particular page, e.g. 'test-cat'.
> * | Enrolment methods | course shortname | Enrolment methods for the course |
* @return moodle_url the corresponding URL.
> * | Enrolled users | course shortname | The main participants page |
* @throws Exception with a meaningful error message if the specified page cannot be found.
> * | Other users | course shortname | The course other users page |
*/
protected function resolve_core_page_instance_url(string $type, string $identifier): moodle_url {
$type = strtolower($type);
switch ($type) {
case 'category':
$categoryid = $this->get_category_id($identifier);
if (!$categoryid) {
throw new Exception('The specified category with idnumber "' . $identifier . '" does not exist');
}
return new moodle_url('/course/index.php', ['categoryid' => $categoryid]);
case 'course editing':
$courseid = $this->get_course_id($identifier);
if (!$courseid) {
throw new Exception('The specified course with shortname, fullname, or idnumber "' .
$identifier . '" does not exist');
}
return new moodle_url('/course/edit.php', ['id' => $courseid]);
case 'course':
$courseid = $this->get_course_id($identifier);
if (!$courseid) {
throw new Exception('The specified course with shortname, fullname, or idnumber "' .
$identifier . '" does not exist');
}
return new moodle_url('/course/view.php', ['id' => $courseid]);
case 'activity':
$cm = $this->get_course_module_for_identifier($identifier);
if (!$cm) {
throw new Exception('The specified activity with idnumber "' . $identifier . '" does not exist');
}
return $cm->url;
case 'activity editing':
$cm = $this->get_course_module_for_identifier($identifier);
if (!$cm) {
throw new Exception('The specified activity with idnumber "' . $identifier . '" does not exist');
}
return new moodle_url('/course/modedit.php', [
'update' => $cm->id,
]);
> case 'backup':
}
> $courseid = $this->get_course_id($identifier);
> if (!$courseid) {
$parts = explode(' ', $type);
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
if (count($parts) > 1) {
> $identifier . '" does not exist');
if ($parts[1] === 'activity') {
> }
$modname = $parts[0];
> return new moodle_url('/backup/backup.php', ['id' => $courseid]);
$cm = $this->get_cm_by_activity_name($modname, $identifier);
> case 'import':
> $courseid = $this->get_course_id($identifier);
if (count($parts) == 2) {
> if (!$courseid) {
// View page.
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
return new moodle_url($cm->url);
> $identifier . '" does not exist');
}
> }
> return new moodle_url('/backup/import.php', ['id' => $courseid]);
if ($parts[2] === 'editing') {
> case 'restore':
// Edit settings page.
> $courseid = $this->get_course_id($identifier);
return new moodle_url('/course/modedit.php', ['update' => $cm->id]);
> if (!$courseid) {
}
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
> $identifier . '" does not exist');
if ($parts[2] === 'roles') {
> }
// Locally assigned roles page.
> $context = context_course::instance($courseid);
return new moodle_url('/admin/roles/assign.php', ['contextid' => $cm->context->id]);
> return new moodle_url('/backup/restorefile.php', ['contextid' => $context->id]);
}
> case 'reset':
> $courseid = $this->get_course_id($identifier);
if ($parts[2] === 'permissions') {
> if (!$courseid) {
// Permissions page.
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
return new moodle_url('/admin/roles/permissions.php', ['contextid' => $cm->context->id]);
> $identifier . '" does not exist');
}
> }
}
> return new moodle_url('/course/reset.php', ['id' => $courseid]);
}
> case 'course copy':
> $courseid = $this->get_course_id($identifier);
throw new Exception('Unrecognised core page type "' . $type . '."');
> if (!$courseid) {
}
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
> $identifier . '" does not exist');
/**
> }
* Opens the course homepage. (Consider using 'I am on the "shortname" "Course" page' step instead.)
> return new moodle_url('/backup/copy.php', ['id' => $courseid]);
*
> case 'groups':
* @Given /^I am on "(?P<coursefullname_string>(?:[^"]|\\")*)" course homepage$/
> $courseid = $this->get_course_id($identifier);
* @throws coding_exception
> if (!$courseid) {
* @param string $coursefullname The full name of the course.
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
* @return void
> $identifier . '" does not exist');
*/
> }
public function i_am_on_course_homepage($coursefullname) {
> return new moodle_url('/group/index.php', ['id' => $courseid]);
$courseid = $this->get_course_id($coursefullname);
> case 'permissions':
$url = new moodle_url('/course/view.php', ['id' => $courseid]);
> $courseid = $this->get_course_id($identifier);
$this->execute('behat_general::i_visit', [$url]);
> if (!$courseid) {
}
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
> $identifier . '" does not exist');
/**
> }
* Open the course homepage with editing mode enabled.
> $context = context_course::instance($courseid);
*
> return new moodle_url('/admin/roles/permissions.php', ['contextid' => $context->id]);
* @Given /^I am on "(?P<coursefullname_string>(?:[^"]|\\")*)" course homepage with editing mode on$/
> case 'enrolment methods':
* @throws coding_exception
> $courseid = $this->get_course_id($identifier);
* @param string $coursefullname The course full name of the course.
> if (!$courseid) {
* @return void
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
*/
> $identifier . '" does not exist');
public function i_am_on_course_homepage_with_editing_mode_on($coursefullname) {
> }
$courseid = $this->get_course_id($coursefullname);
> return new moodle_url('/enrol/instances.php', ['id' => $courseid]);
$url = new moodle_url('/course/view.php', ['id' => $courseid]);
> case 'enrolled users':
> $courseid = $this->get_course_id($identifier);
if ($this->running_javascript() && $sesskey = $this->get_sesskey()) {
> if (!$courseid) {
// Javascript is running so it is possible to grab the session ket and jump straight to editing mode.
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
$url->param('edit', 1);
> $identifier . '" does not exist');
$url->param('sesskey', $sesskey);
> }
$this->execute('behat_general::i_visit', [$url]);
> return new moodle_url('/user/index.php', ['id' => $courseid]);
> case 'other users':
return;
> $courseid = $this->get_course_id($identifier);
}
> if (!$courseid) {
> throw new Exception('The specified course with shortname, fullname, or idnumber "' .
// Visit the course page.
> $identifier . '" does not exist');
$this->execute('behat_general::i_visit', [$url]);
> }
> return new moodle_url('/enrol/otherusers.php', ['id' => $courseid]);
< * @Given /^I am on "(?P<coursefullname_string>(?:[^"]|\\")*)" course homepage with editing mode on$/
< * @throws coding_exception
< * @return void
< $courseid = $this->get_course_id($coursefullname);
< $url = new moodle_url('/course/view.php', ['id' => $courseid]);
<
< if ($this->running_javascript() && $sesskey = $this->get_sesskey()) {
< // Javascript is running so it is possible to grab the session ket and jump straight to editing mode.
< $url->param('edit', 1);
< $url->param('sesskey', $sesskey);
< $this->execute('behat_general::i_visit', [$url]);
> $this->i_am_on_course_homepage_with_editing_mode_set_to($coursefullname, 'on');
> }
< return;
> /**
> * Open the course homepage with editing mode set to either on, or off.
> *
> * @Given I am on :coursefullname course homepage with editing mode :onoroff
> * @throws coding_exception
> * @param string $coursefullname The course full name of the course.
> * @param string $onoroff Whehter to switch editing on, or off.
> */
> public function i_am_on_course_homepage_with_editing_mode_set_to(string $coursefullname, string $onoroff): void {
> if ($onoroff !== 'on' && $onoroff !== 'off') {
> throw new coding_exception("Unknown editing mode '{$onoroff}'. Accepted values are 'on' and 'off'");
< // Visit the course page.
< $this->execute('behat_general::i_visit', [$url]);
> $courseid = $this->get_course_id($coursefullname);
> $context = context_course::instance($courseid);
> $courseurl = new moodle_url('/course/view.php', ['id' => $courseid]);
< try {
< $this->execute("behat_forms::press_button", get_string('turneditingon'));
< } catch (Exception $e) {
< $this->execute("behat_navigation::i_navigate_to_in_current_page_administration", [get_string('turneditingon')]);
< }
> $editmodeurl = new moodle_url('/editmode.php', [
> 'context' => $context->id,
> 'pageurl' => $courseurl->out(true),
> 'setmode' => ($onoroff === 'on' ? 1 : 0),
> ]);
> $this->execute('behat_general::i_visit', [$editmodeurl]);
$node = $this->find('xpath', $xpath);
$expanded = $node->getAttribute('aria-expanded');
if ($expanded === 'false') {
$this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
$this->ensure_node_attribute_is_set($node, 'aria-expanded', 'true');
}
}
/**
* Closes the flat navigation drawer if it is open (does nothing if JS disabled)
*
* @When /^I close flat navigation drawer$/
* @throws ElementNotFoundException Thrown by behat_base::find
*/
public function i_close_flat_navigation_drawer() {
if (!$this->running_javascript()) {
// Navigation drawer can not be closed without JS.
return;
}
$xpath = "//button[contains(@data-action,'toggle-drawer')]";
$node = $this->find('xpath', $xpath);
$expanded = $node->getAttribute('aria-expanded');
if ($expanded === 'true') {
$this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
}
}
/**
< * Clicks link with specified id|title|alt|text in the flat navigation drawer.
> * Clicks link with specified id|title|alt|text in the primary navigation
> *
> * @When /^I select "(?P<link_string>(?:[^"]|\\")*)" from primary navigation$/
> * @throws ElementNotFoundException Thrown by behat_base::find
> * @param string $link
> */
> public function i_select_from_primary_navigation(string $link) {
> $this->execute('behat_general::i_click_on_in_the',
> [$link, 'link', '.primary-navigation .moremenu.navigation', 'css_element']
> );
> }
>
> /**
> * Clicks link with specified id|title|alt|text in the secondary navigation
*
< * @When /^I select "(?P<link_string>(?:[^"]|\\")*)" from flat navigation drawer$/
> * @When I select :link from secondary navigation
* @throws ElementNotFoundException Thrown by behat_base::find
* @param string $link
*/
< public function i_select_from_flat_navigation_drawer($link) {
< $this->i_open_flat_navigation_drawer();
< $this->execute('behat_general::i_click_on_in_the', [$link, 'link', '#nav-drawer', 'css_element']);
> public function i_select_from_secondary_navigation(string $link) {
> $this->execute('behat_general::i_click_on_in_the',
> [$link, 'link', '.secondary-navigation .moremenu.navigation', 'css_element']
> );
}
/**
* If we are not on the course main page, click on the course link in the navbar
*/
protected function go_to_main_course_page() {
$url = $this->getSession()->getCurrentUrl();
if (!preg_match('|/course/view.php\?id=[\d]+$|', $url)) {
< $node = $this->find('xpath', '//header//div[@id=\'page-navbar\']//a[contains(@href,\'/course/view.php?id=\')]');
> $node = $this->find('xpath',
> '//header//div[@id=\'page-navbar\']//a[contains(@href,\'/course/view.php?id=\')]'
> );
$this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
}
}
/**
* Finds and clicks a link on the admin page (site administration or course administration)
*
* @param array $nodelist
*/
protected function select_on_administration_page($nodelist) {
$parentnodes = $nodelist;
$lastnode = array_pop($parentnodes);
$xpath = '//section[@id=\'region-main\']';
// Check if there is a separate tab for this submenu of the page. If found go to it.
if ($parentnodes) {
$tabname = behat_context_helper::escape($parentnodes[0]);
$tabxpath = '//ul[@role=\'tablist\']/li/a[contains(normalize-space(.), ' . $tabname . ')]';
< if ($node = $this->getSession()->getPage()->find('xpath', $tabxpath)) {
> $menubarxpath = '//ul[@role=\'menubar\']/li/a[contains(normalize-space(.), ' . $tabname . ')]';
> $linkname = behat_context_helper::escape(get_string('moremenu'));
> $menubarmorexpath = '//ul[contains(@class,\'more-nav\')]/li/a[contains(normalize-space(.), ' . $linkname . ')]';
> $tabnode = $this->getSession()->getPage()->find('xpath', $tabxpath);
> $menunode = $this->getSession()->getPage()->find('xpath', $menubarxpath);
> $menubuttons = $this->getSession()->getPage()->findAll('xpath', $menubarmorexpath);
> if ($tabnode || $menunode) {
> $node = is_object($tabnode) ? $tabnode : $menunode;
if ($this->running_javascript()) {
$this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
// Click on the tab and add 'active' tab to the xpath.
$xpath .= '//div[contains(@class,\'active\')]';
} else {
// Add the tab content selector to the xpath.
$tabid = behat_context_helper::escape(ltrim($node->getAttribute('href'), '#'));
$xpath .= '//div[@id = ' . $tabid . ']';
}
array_shift($parentnodes);
> } else if (count($menubuttons) > 0) {
}
> try {
}
> $menubuttons[0]->isVisible();
> try {
// Find a section with the parent name in it.
> $this->execute('behat_general::i_click_on', [$menubuttons[1], 'NodeElement']);
if ($parentnodes) {
> } catch (Exception $e) {
// Find the section on the page (links may be repeating in different sections).
> $this->execute('behat_general::i_click_on', [$menubuttons[0], 'NodeElement']);
$section = behat_context_helper::escape($parentnodes[0]);
> }
$xpath .= '//div[@class=\'row\' and contains(.,'.$section.')]';
> $moreitemxpath = '//ul[@data-region=\'moredropdown\']/li/a[contains(normalize-space(.), ' . $tabname . ')]';
}
> if ($morenode = $this->getSession()->getPage()->find('xpath', $moreitemxpath)) {
> $this->execute('behat_general::i_click_on', [$morenode, 'NodeElement']);
// Find a link and click on it.
> $xpath .= '//div[contains(@class,\'active\')]';
$linkname = behat_context_helper::escape($lastnode);
> array_shift($parentnodes);
$xpath .= '//a[contains(normalize-space(.), ' . $linkname . ')]';
> }
if (!$node = $this->getSession()->getPage()->find('xpath', $xpath)) {
> } catch (Exception $e) {
throw new ElementNotFoundException($this->getSession(), 'Link "' . join(' > ', $nodelist) . '"');
> }
< $xpath .= '//a[contains(normalize-space(.), ' . $linkname . ')]';
< if (!$node = $this->getSession()->getPage()->find('xpath', $xpath)) {
> $xpathlink = $xpathbutton = $xpath;
> $xpathlink .= '//a[contains(normalize-space(.), ' . $linkname . ')]';
> $xpathbutton .= '//button[contains(normalize-space(.), ' . $linkname . ')]';
> if ($node = $this->getSession()->getPage()->find('xpath', $xpathbutton)) {
> $this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
> } else if (!$node = $this->getSession()->getPage()->find('xpath', $xpathlink)) {
< }
> } else {
> }
/**
* Locates the administration menu in the <header> element and returns its xpath
*
* @param bool $mustexist if specified throws an exception if menu is not found
* @return null|string
*/
protected function find_header_administration_menu($mustexist = false) {
< $menuxpath = '//header[@id=\'page-header\']//div[contains(@class,\'moodle-actionmenu\')]';
> $menuxpath = '//div[contains(@class,\'secondary-navigation\')]//nav[contains(@class,\'moremenu\')]';
>
if ($mustexist) {
$exception = new ElementNotFoundException($this->getSession(), 'Page header administration menu');
$this->find('xpath', $menuxpath, $exception);
} else if (!$this->getSession()->getPage()->find('xpath', $menuxpath)) {
return null;
}
return $menuxpath;
}
/**
* Locates the administration menu on the page (but not in the header) and returns its xpath
*
* @param bool $mustexist if specified throws an exception if menu is not found
* @return null|string
*/
protected function find_page_administration_menu($mustexist = false) {
$menuxpath = '//div[@id=\'region-main-settings-menu\']';
if ($mustexist) {
$exception = new ElementNotFoundException($this->getSession(), 'Page administration menu');
$this->find('xpath', $menuxpath, $exception);
} else if (!$this->getSession()->getPage()->find('xpath', $menuxpath)) {
return null;
}
return $menuxpath;
}
/**
> * Locates the action menu on the page (but not in the header) and returns its xpath
* Toggles administration menu
> *
*
> * @param null|bool $mustexist if specified throws an exception if menu is not found
* @param string $menuxpath (optional) xpath to the page administration menu if already known
> * @return null|string
*/
> */
protected function toggle_page_administration_menu($menuxpath = null) {
> protected function find_page_action_menu($mustexist = false) {
if (!$menuxpath) {
> $menuxpath = '//div[@id=\'action-menu-0-menubar\']';
$menuxpath = $this->find_header_administration_menu() ?: $this->find_page_administration_menu();
>
}
> if ($mustexist) {
if ($menuxpath && $this->running_javascript()) {
> $exception = new ElementNotFoundException($this->getSession(), 'Page check');
$node = $this->find('xpath', $menuxpath . '//a[@data-toggle=\'dropdown\']');
> $this->find('xpath', $menuxpath, $exception);
$this->execute('behat_general::i_click_on', [$node, 'NodeElement']);
> } else if (!$this->getSession()->getPage()->find('xpath', $menuxpath)) {
}
> return null;
}
> }
> return $menuxpath;
/**
> }
* Finds a page edit cog and select an item from it
>
*
> /**
* If the page edit cog is in the page header and the item is not found there, click "More..." link
> if ($node->isVisible()) {
* and find the item on the course/frontpage administration page
> }
*
* @param array $nodelist
* @throws ElementNotFoundException
*/
protected function select_from_administration_menu($nodelist) {
// Find administration menu.
if ($menuxpath = $this->find_header_administration_menu()) {
$isheader = true;
> } else if ($menuxpath = $this->find_page_action_menu(true)) {
} else {
> $isheader = false;
$menuxpath = $this->find_page_administration_menu(true);
$isheader = false;
}
$this->execute('behat_navigation::toggle_page_administration_menu', [$menuxpath]);
> $firstnode = $nodelist[0];
if (!$isheader || count($nodelist) == 1) {
> $firstlinkname = behat_context_helper::escape($firstnode);
$lastnode = end($nodelist);
> $firstlink = $this->getSession()->getPage()->find('xpath',
$linkname = behat_context_helper::escape($lastnode);
> $menuxpath . '//a[contains(normalize-space(.), ' . $firstlinkname . ')]'
$link = $this->getSession()->getPage()->find('xpath', $menuxpath . '//a[contains(normalize-space(.), ' . $linkname . ')]');
> );
if ($link) {
>
$this->execute('behat_general::i_click_on', [$link, 'NodeElement']);
return;
}
> } else if ($firstlink) {
}
> $this->execute('behat_general::i_click_on', [$firstlink, 'NodeElement']);
> array_splice($nodelist, 0, 1);
if ($isheader) {
> $this->select_on_administration_page($nodelist);
// Course administration and Front page administration will have subnodes under "More...".
> return;
< // Course administration and Front page administration will have subnodes under "More...".
> // Front page administration will have subnodes under "More...".
< $link = $this->getSession()->getPage()->find('xpath', $menuxpath . '//a[contains(normalize-space(.), ' . $linkname . ')]');
> $link = $this->getSession()->getPage()->find('xpath',
> $menuxpath . '//a[contains(normalize-space(.), ' . $linkname . ')]'
> );
> // Course administration will have subnodes under "Course administration".
> $courselinkname = behat_context_helper::escape(get_string('courseadministration'));
> $courselink = $this->getSession()->getPage()->find('xpath',
> $menuxpath . '//a[contains(normalize-space(.), ' . $courselinkname . ')]'
> );
if ($link) {
$this->execute('behat_general::i_click_on', [$link, 'NodeElement']);
$this->select_on_administration_page($nodelist);
return;
> } else if ($courselink) {
}
> $this->execute('behat_general::i_click_on', [$courselink, 'NodeElement']);
}
> $this->select_on_administration_page($nodelist);
> return;
throw new ElementNotFoundException($this->getSession(),
'Link "' . join(' > ', $nodelist) . '" in the current page edit menu"');
}
/**
* Visit a fixture page for testing stuff that is not available in core.
*
* Please always, to prevent unwanted requests, protect behat fixture files with:
* defined('BEHAT_SITE_RUNNING') || die();
*
* @Given /^I am on fixture page "(?P<url_string>(?:[^"]|\\")*)"$/
* @param string $url local path to fixture page
*/
public function i_am_on_fixture_page($url) {
$fixtureregex = '|^/[a-z0-9_\-/]*/tests/behat/fixtures/[a-z0-9_\-]*\.php$|';
if (!preg_match($fixtureregex, $url)) {
throw new coding_exception("URL {$url} is not a fixture URL");
}
$this->execute('behat_general::i_visit', [$url]);
> }
}
>
}
> /**
> * First checks to see if we are on this page via the breadcrumb. If not we then attempt to follow the link name given.
> *
> * @param string $pagename Name of the breadcrumb item to check and follow.
> * @Given /^I follow the breadcrumb "(?P<url_string>(?:[^"]|\\")*)"$/
> */
> public function go_to_breadcrumb_location(string $pagename): void {
> $link = $this->getSession()->getPage()->find(
> 'xpath',
> "//nav[@aria-label='Navigation bar']/ol/li[last()][contains(normalize-space(.), '" . $pagename . "')]"
> );
> if (!$link) {
> $this->execute("behat_general::i_click_on_in_the", [$pagename, 'link', 'page', 'region']);
> }
> }
>
> /**
> * Checks whether an item exists in the user menu.
> *
> * @Given :itemtext :selectortype should exist in the user menu
> * @Given :itemtext :selectortype should :not exist in the user menu
> *
> * @throws ElementNotFoundException
> * @param string $itemtext The menu item to find
> * @param string $selectortype The selector type
> * @param string|null $not Instructs to checks whether the element does not exist in the user menu, if defined
> * @return void
> */
> public function should_exist_in_user_menu($itemtext, $selectortype, $not = null) {
> $callfunction = is_null($not) ? 'should_exist_in_the' : 'should_not_exist_in_the';
> $this->execute("behat_general::{$callfunction}",
> [$itemtext, $selectortype, $this->get_user_menu_xpath(), 'xpath_element']);
> }
>
> /**
> * Checks whether an item exists in a given user submenu.
> *
> * @Given :itemtext :selectortype should exist in the :submenuname user submenu
> * @Given :itemtext :selectortype should :not exist in the :submenuname user submenu
> *
> * @throws ElementNotFoundException
> * @param string $itemtext The submenu item to find
> * @param string $selectortype The selector type
> * @param string $submenuname The name of the submenu
> * @param string|null $not Instructs to checks whether the element does not exist in the user menu, if defined
> * @return void
> */
> public function should_exist_in_user_submenu($itemtext, $selectortype, $submenuname, $not = null) {
> $callfunction = is_null($not) ? 'should_exist_in_the' : 'should_not_exist_in_the';
> $this->execute("behat_general::{$callfunction}",
> [$itemtext, $selectortype, $this->get_user_submenu_xpath($submenuname), 'xpath_element']);
> }
>
> /**
> * Checks whether a given user submenu is visible.
> *
> * @Then /^I should see "(?P<submenu_string>[^"]*)" user submenu$/
> *
> * @throws ElementNotFoundException
> * @throws ExpectationException
> * @param string $submenuname The name of the submenu
> * @return void
> */
> public function i_should_see_user_submenu($submenuname) {
> $this->execute('behat_general::should_be_visible',
> array($this->get_user_submenu_xpath($submenuname), 'xpath_element'));
> }
>
> /**
> * Return the xpath for the user menu element.
> *
> * @return string The xpath
> */
> protected function get_user_menu_xpath() {
> return "//div[contains(concat(' ', @class, ' '), ' usermenu ')]" .
> "//div[contains(concat(' ', @class, ' '), ' dropdown-menu ')]" .
> "//div[@id='carousel-item-main']";
> }
>
> /**
> * Return the xpath for a given user submenu element.
> *
> * @param string $submenuname The name of the submenu
> * @return string The xpath
> */
> protected function get_user_submenu_xpath($submenuname) {
> return "//div[contains(concat(' ', @class, ' '), ' usermenu ')]" .
> "//div[contains(concat(' ', @class, ' '), ' dropdown-menu ')]" .
> "//div[contains(concat(' ', @class, ' '), ' submenu ')][@aria-label='" . $submenuname . "']";
> }
>
> /**
> * Returns whether the user can edit the current page.
> *
> * @return bool
> */
> protected function is_editing_on() {
> $body = $this->find('xpath', "//body", false, false, 0);
> return $body->hasClass('editing');
> }
>
> /**
> * Turns editing mode on.
> * @Given I switch editing mode on
> * @Given I turn editing mode on
> */
> public function i_turn_editing_mode_on() {
> $this->execute('behat_forms::i_set_the_field_to', [get_string('editmode'), 1]);
>
> if (!$this->running_javascript()) {
> $this->execute('behat_general::i_click_on', [
> get_string('setmode', 'core'),
> 'button',
> ]);
> }
>
> if (!$this->is_editing_on()) {
> throw new ExpectationException('The edit mode could not be turned on', $this->getSession());
> }
> }
>
> /**
> * Turns editing mode off.
> * @Given I switch editing mode off
> * @Given I turn editing mode off
> */
> public function i_turn_editing_mode_off() {
> $this->execute('behat_forms::i_set_the_field_to', [get_string('editmode'), 0]);
>
> if (!$this->running_javascript()) {
> $this->execute('behat_general::i_click_on', [
> get_string('setmode', 'core'),
> 'button',
> ]);
> }
>
> if ($this->is_editing_on()) {
> throw new ExpectationException('The edit mode could not be turned off', $this->getSession());
> }