Search moodle.org's
Developer Documentation
Developer Documentation
- Bug fixes for general core bugs in 4.3.x will end 7 October 2024 (12 months).
- Bug fixes for security issues in 4.3.x will end 21 April 2025 (18 months).
- PHP version: minimum PHP 8.0.0 Note: minimum PHP version has increased since Moodle 4.1. PHP 8.2.x is supported too.
/lib/tests/behat/ -> behat_navigation.php (source)
Differences Between: [Versions 310 and 403] [Versions 311 and 403] [Versions 39 and 403] [Versions 400 and 403] [Versions 401 and 403] [Versions 402 and 403]
1 <?php 2 // This file is part of Moodle - http://moodle.org/ 3 // 4 // Moodle is free software: you can redistribute it and/or modify 5 // it under the terms of the GNU General Public License as published by 6 // the Free Software Foundation, either version 3 of the License, or 7 // (at your option) any later version. 8 // 9 // Moodle is distributed in the hope that it will be useful, 10 // but WITHOUT ANY WARRANTY; without even the implied warranty of 11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 12 // GNU General Public License for more details. 13 // 14 // You should have received a copy of the GNU General Public License 15 // along with Moodle. If not, see <http://www.gnu.org/licenses/>. 16 17 /** 18 * Navigation steps definitions. 19 * 20 * @package core 21 * @category test 22 * @copyright 2012 David Monllaó 23 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later 24 */ 25 26 // NOTE: no MOODLE_INTERNAL test here, this file may be required by behat before including /config.php. 27 28 require_once (__DIR__ . '/../../behat/behat_base.php'); 29 30 use Behat\Mink\Element\NodeElement; 31 use Behat\Mink\Exception\ExpectationException as ExpectationException; 32 use Behat\Mink\Exception\ElementNotFoundException as ElementNotFoundException; 33 34 /** 35 * Steps definitions to navigate through the navigation tree nodes. 36 * 37 * @package core 38 * @category test 39 * @copyright 2012 David Monllaó 40 * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later 41 */ 42 class behat_navigation extends behat_base { 43 44 /** 45 * Checks whether a navigation node is active within the block navigation. 46 * 47 * @Given i should see :name is active in navigation 48 * 49 * @throws ElementNotFoundException 50 * @param string $element The name of the nav elemnent to look for. 51 * @return void 52 */ 53 public function i_should_see_is_active_in_navigation($element) { 54 $this->execute("behat_general::assert_element_contains_text", 55 [$element, '.block_navigation .active_tree_node', 'css_element']); 56 } 57 58 /** 59 * Helper function to get a navigation nodes text element given its text from within the navigation block. 60 * 61 * This function finds the node with the given text from within the navigation block. 62 * It checks to make sure the node is visible, and then returns it. 63 * 64 * @param string $text 65 * @param bool $branch Set this true if you're only interested in the node if its a branch. 66 * @param null|bool $collapsed Set this to true or false if you want the node to either be collapsed or not. 67 * If its left as null then we don't worry about it. 68 * @param null|string|Exception|false $exception The exception to throw if the node is not found. 69 * @return \Behat\Mink\Element\NodeElement 70 */ 71 protected function get_node_text_node($text, $branch = false, $collapsed = null, $exception = null) { 72 if ($exception === null) { 73 $exception = new ExpectationException('The "' . $text . '" node could not be found', $this->getSession()); 74 } else if (is_string($exception)) { 75 $exception = new ExpectationException($exception, $this->getSession()); 76 } 77 78 $nodetextliteral = behat_context_helper::escape($text); 79 $hasblocktree = "[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]"; 80 $hasbranch = "[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]"; 81 $hascollapsed = "li[@aria-expanded='false']/p"; 82 $notcollapsed = "li[@aria-expanded='true']/p"; 83 $match = "[normalize-space(.)={$nodetextliteral}]"; 84 85 // Avoid problems with quotes. 86 $isbranch = ($branch) ? $hasbranch : ''; 87 if ($collapsed === true) { 88 $iscollapsed = $hascollapsed; 89 } else if ($collapsed === false) { 90 $iscollapsed = $notcollapsed; 91 } else { 92 $iscollapsed = 'li/p'; 93 } 94 95 // First check root nodes, it can be a span or link. 96 $xpath = "//ul{$hasblocktree}/{$hascollapsed}{$isbranch}/span{$match}|"; 97 $xpath .= "//ul{$hasblocktree}/{$hascollapsed}{$isbranch}/a{$match}|"; 98 99 // Next search for the node containing the text within a link. 100 $xpath .= "//ul{$hasblocktree}//ul/{$iscollapsed}{$isbranch}/a{$match}|"; 101 102 // Finally search for the node containing the text within a span. 103 $xpath .= "//ul{$hasblocktree}//ul/{$iscollapsed}{$isbranch}/span{$match}"; 104 105 $node = $this->find('xpath', $xpath, $exception); 106 $this->ensure_node_is_visible($node); 107 return $node; 108 } 109 110 /** 111 * Returns true if the navigation node with the given text is expandable. 112 * 113 * @Given /^navigation node "([^"]*)" should be expandable$/ 114 * 115 * @throws ExpectationException 116 * @param string $nodetext 117 * @return bool 118 */ 119 public function navigation_node_should_be_expandable($nodetext) { 120 if (!$this->running_javascript()) { 121 // Nodes are only expandable when JavaScript is enabled. 122 return false; 123 } 124 125 $node = $this->get_node_text_node($nodetext, true); 126 $node = $node->getParent(); 127 if ($node->hasClass('emptybranch')) { 128 throw new ExpectationException('The "' . $nodetext . '" node is not expandable', $this->getSession()); 129 } 130 131 return true; 132 } 133 134 /** 135 * Returns true if the navigation node with the given text is not expandable. 136 * 137 * @Given /^navigation node "([^"]*)" should not be expandable$/ 138 * 139 * @throws ExpectationException 140 * @param string $nodetext 141 * @return bool 142 */ 143 public function navigation_node_should_not_be_expandable($nodetext) { 144 if (!$this->running_javascript()) { 145 // Nodes are only expandable when JavaScript is enabled. 146 return false; 147 } 148 149 $node = $this->get_node_text_node($nodetext); 150 $node = $node->getParent(); 151 152 if ($node->hasClass('emptybranch') || $node->hasClass('tree_item')) { 153 return true; 154 } 155 throw new ExpectationException('The "' . $nodetext . '" node is expandable', $this->getSession()); 156 } 157 158 /** 159 * Click on an entry in the user menu. 160 * @Given /^I follow "(?P<nodetext_string>(?:[^"]|\\")*)" in the user menu$/ 161 * 162 * @param string $nodetext 163 */ 164 public function i_follow_in_the_user_menu($nodetext) { 165 166 if ($this->running_javascript()) { 167 // The user menu must be expanded when JS is enabled. 168 $xpath = "//div[contains(concat(' ', @class, ' '), ' usermenu ')]//a[contains(concat(' ', @class, ' '), ' dropdown-toggle ')]"; 169 $this->execute("behat_general::i_click_on", array($this->escape($xpath), "xpath_element")); 170 } 171 172 // Now select the link. 173 // The CSS path is always present, with or without JS. 174 $csspath = ".usermenu .dropdown-menu"; 175 176 $this->execute('behat_general::i_click_on_in_the', 177 array($nodetext, "link", $csspath, "css_element") 178 ); 179 } 180 181 /** 182 * Expands the selected node of the navigation tree that matches the text. 183 * @Given /^I expand "(?P<nodetext_string>(?:[^"]|\\")*)" node$/ 184 * 185 * @throws ExpectationException 186 * @param string $nodetext 187 * @return bool|void 188 */ 189 public function i_expand_node($nodetext) { 190 191 // This step is useless with Javascript disabled as Moodle auto expands 192 // all of tree's nodes; adding this because of scenarios that shares the 193 // same steps with and without Javascript enabled. 194 if (!$this->running_javascript()) { 195 if ($nodetext === get_string('administrationsite')) { 196 // Administration menu is not loaded by default any more. Click the link to expand. 197 $this->execute('behat_general::i_click_on_in_the', 198 array($nodetext, "link", get_string('administration'), "block") 199 ); 200 return true; 201 } 202 return true; 203 } 204 205 $node = $this->get_node_text_node($nodetext, true, true, 'The "' . $nodetext . '" node can not be expanded'); 206 // Check if the node is a link AND a branch. 207 if (strtolower($node->getTagName()) === 'a') { 208 // We just want to expand the node, we don't want to follow it. 209 $node = $node->getParent(); 210 } 211 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 212 } 213 214 /** 215 * Collapses the selected node of the navigation tree that matches the text. 216 * 217 * @Given /^I collapse "(?P<nodetext_string>(?:[^"]|\\")*)" node$/ 218 * @throws ExpectationException 219 * @param string $nodetext 220 * @return bool|void 221 */ 222 public function i_collapse_node($nodetext) { 223 224 // No collapsible nodes with non-JS browsers. 225 if (!$this->running_javascript()) { 226 return true; 227 } 228 229 $node = $this->get_node_text_node($nodetext, true, false, 'The "' . $nodetext . '" node can not be collapsed'); 230 // Check if the node is a link AND a branch. 231 if (strtolower($node->getTagName()) === 'a') { 232 // We just want to expand the node, we don't want to follow it. 233 $node = $node->getParent(); 234 } 235 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 236 } 237 238 /** 239 * Finds a node in the Navigation or Administration tree 240 * 241 * @param string $nodetext 242 * @param array $parentnodes 243 * @param string $nodetype node type (link or text) 244 * @return NodeElement|null 245 * @throws ExpectationException when one of the parent nodes is not found 246 */ 247 protected function find_node_in_navigation($nodetext, $parentnodes, $nodetype = 'link') { 248 // Site admin is different and needs special treatment. 249 $siteadminstr = get_string('administrationsite'); 250 251 // Create array of all parentnodes. 252 $countparentnode = count($parentnodes); 253 254 // If JS is disabled and Site administration is not expanded we 255 // should follow it, so all the lower-level nodes are available. 256 if (!$this->running_javascript()) { 257 if ($parentnodes[0] === $siteadminstr) { 258 // We don't know if there if Site admin is already expanded so 259 // don't wait, it is non-JS and we already waited for the DOM. 260 $siteadminlink = $this->getSession()->getPage()->find('named_exact', array('link', "'" . $siteadminstr . "'")); 261 if ($siteadminlink) { 262 $this->execute('behat_general::i_click_on', [$siteadminlink, 'NodeElement']); 263 } 264 } 265 } 266 267 // Get top level node. 268 $node = $this->get_top_navigation_node($parentnodes[0]); 269 270 // Expand all nodes. 271 for ($i = 0; $i < $countparentnode; $i++) { 272 if ($i > 0) { 273 // Sub nodes within top level node. 274 $node = $this->get_navigation_node($parentnodes[$i], $node); 275 } 276 277 // The p node contains the aria jazz. 278 $pnodexpath = "/p[contains(concat(' ', normalize-space(@class), ' '), ' tree_item ')]"; 279 $pnode = $node->find('xpath', $pnodexpath); 280 $linode = $pnode->getParent(); 281 282 // Keep expanding all sub-parents if js enabled. 283 if ($pnode && $this->running_javascript() && $linode->hasAttribute('aria-expanded') && 284 ($linode->getAttribute('aria-expanded') == "false")) { 285 $this->js_trigger_click($pnode); 286 287 // Wait for node to load, if not loaded before. 288 if ($linode->hasAttribute('data-loaded') && $linode->getAttribute('data-loaded') == "false") { 289 $jscondition = '(document.evaluate("' . $linode->getXpath() . '", document, null, '. 290 'XPathResult.ANY_TYPE, null).iterateNext().getAttribute(\'data-loaded\') == "true")'; 291 292 $this->getSession()->wait(behat_base::get_extended_timeout() * 1000, $jscondition); 293 } 294 } 295 } 296 297 // Finally, click on requested node under navigation. 298 $nodetextliteral = behat_context_helper::escape($nodetext); 299 $tagname = ($nodetype === 'link') ? 'a' : 'span'; 300 $xpath = "/ul/li/p[contains(concat(' ', normalize-space(@class), ' '), ' tree_item ')]" . 301 "/{$tagname}[normalize-space(.)=" . $nodetextliteral . "]"; 302 return $node->find('xpath', $xpath); 303 } 304 305 /** 306 * Finds a node in the Navigation or Administration tree and clicks on it. 307 * 308 * @param string $nodetext 309 * @param array $parentnodes 310 * @throws ExpectationException 311 */ 312 protected function select_node_in_navigation($nodetext, $parentnodes) { 313 $nodetoclick = $this->find_node_in_navigation($nodetext, $parentnodes); 314 // Throw exception if no node found. 315 if (!$nodetoclick) { 316 throw new ExpectationException('Navigation node "' . $nodetext . '" not found under "' . 317 implode(' > ', $parentnodes) . '"', $this->getSession()); 318 } 319 $this->execute('behat_general::i_click_on', [$nodetoclick, 'NodeElement']); 320 } 321 322 /** 323 * Helper function to get top navigation node in tree. 324 * 325 * @throws ExpectationException if note not found. 326 * @param string $nodetext name of top navigation node in tree. 327 * @return NodeElement 328 */ 329 protected function get_top_navigation_node($nodetext) { 330 331 // Avoid problems with quotes. 332 $nodetextliteral = behat_context_helper::escape($nodetext); 333 $exception = new ExpectationException('Top navigation node "' . $nodetext . ' not found in "', $this->getSession()); 334 335 // First find in navigation block. 336 $xpath = "//div[contains(concat(' ', normalize-space(@class), ' '), ' card-text ')]" . 337 "/ul[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]" . 338 "/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" . 339 "/ul/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" . 340 "[p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" . 341 "/*[contains(normalize-space(.), " . $nodetextliteral .")]]" . 342 "|" . 343 "//div[contains(concat(' ', normalize-space(@class), ' '), ' card-text ')]/div" . 344 "/ul[contains(concat(' ', normalize-space(@class), ' '), ' block_tree ')]" . 345 "/li[p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" . 346 "/*[contains(normalize-space(.), " . $nodetextliteral .")]]"; 347 348 $node = $this->find('xpath', $xpath, $exception); 349 350 return $node; 351 } 352 353 /** 354 * Helper function to get sub-navigation node. 355 * 356 * @throws ExpectationException if note not found. 357 * @param string $nodetext node to find. 358 * @param NodeElement $parentnode parent navigation node. 359 * @return NodeElement. 360 */ 361 protected function get_navigation_node($nodetext, $parentnode = null) { 362 363 // Avoid problems with quotes. 364 $nodetextliteral = behat_context_helper::escape($nodetext); 365 366 $xpath = "/ul/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" . 367 "[child::p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" . 368 "/child::span[normalize-space(.)=" . $nodetextliteral ."]]"; 369 $node = $parentnode->find('xpath', $xpath); 370 if (!$node) { 371 $xpath = "/ul/li[contains(concat(' ', normalize-space(@class), ' '), ' contains_branch ')]" . 372 "[child::p[contains(concat(' ', normalize-space(@class), ' '), ' branch ')]" . 373 "/child::a[normalize-space(.)=" . $nodetextliteral ."]]"; 374 $node = $parentnode->find('xpath', $xpath); 375 } 376 377 if (!$node) { 378 throw new ExpectationException('Sub-navigation node "' . $nodetext . '" not found under "' . 379 $parentnode->getText() . '"', $this->getSession()); 380 } 381 return $node; 382 } 383 384 /** 385 * Step to open the navigation bar if it is needed. 386 * 387 * The top log in and log out links are hidden when middle or small 388 * size windows (or devices) are used. This step returns a step definition 389 * clicking to expand the navbar if it is hidden. 390 * 391 * @Given /^I expand navigation bar$/ 392 */ 393 public function get_expand_navbar_step() { 394 395 // Checking if we need to click the navbar button to show the navigation menu, it 396 // is hidden by default when using clean theme and a medium or small screen size. 397 398 // The DOM and the JS should be all ready and loaded. Running without spinning 399 // as this is a widely used step and we can not spend time here trying to see 400 // a DOM node that is not always there (at the moment clean is not even the 401 // default theme...). 402 $navbuttonjs = "return ( 403 Y.one('.btn-navbar') && 404 Y.one('.btn-navbar').getComputedStyle('display') !== 'none' 405 )"; 406 407 // Adding an extra click we need to show the 'Log in' link. 408 if (!$this->evaluate_script($navbuttonjs)) { 409 return false; 410 } 411 412 $this->execute('behat_general::i_click_on', array(".btn-navbar", "css_element")); 413 } 414 415 /** 416 * Go to current page setting item 417 * 418 * This can be used on front page, course, category or modules pages. 419 * 420 * @Given /^I navigate to "(?P<nodetext_string>(?:[^"]|\\")*)" in current page administration$/ 421 * 422 * @throws ExpectationException 423 * @param string $nodetext navigation node to click, may contain path, for example "Reports > Overview" 424 * @return void 425 */ 426 public function i_navigate_to_in_current_page_administration($nodetext) { 427 $nodelist = array_map('trim', explode('>', $nodetext)); 428 $this->select_from_administration_menu($nodelist); 429 } 430 431 /** 432 * Checks that current page administration contains text 433 * 434 * @Given /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should exist in current page administration$/ 435 * 436 * @throws ExpectationException 437 * @param string $element The locator of the specified selector. 438 * This may be a path, for example "Subscription mode > Forced subscription" 439 * @param string $selectortype The selector type (link or text) 440 * @return void 441 */ 442 public function should_exist_in_current_page_administration($element, $selectortype) { 443 $nodes = array_map('trim', explode('>', $element)); 444 $nodetext = end($nodes); 445 446 // Find administration menu. 447 if (!$menuxpath = $this->find_page_action_menu()) { 448 $menuxpath = $this->find_header_administration_menu() ?: $this->find_page_administration_menu(true); 449 } 450 451 $this->toggle_page_administration_menu($menuxpath); 452 $this->execute('behat_general::should_exist_in_the', [$nodetext, $selectortype, $menuxpath, 'xpath_element']); 453 $this->toggle_page_administration_menu($menuxpath); 454 } 455 456 /** 457 * Checks that current page administration contains text 458 * 459 * @Given /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should not exist in current page administration$/ 460 * 461 * @throws ExpectationException 462 * @param string $element The locator of the specified selector. 463 * This may be a path, for example "Subscription mode > Forced subscription" 464 * @param string $selectortype The selector type (link or text) 465 * @return void 466 */ 467 public function should_not_exist_in_current_page_administration($element, $selectortype) { 468 $nodes = array_map('trim', explode('>', $element)); 469 $nodetext = end($nodes); 470 471 // Find administration menu. 472 $menuxpath = $this->find_header_administration_menu() ?: $this->find_page_administration_menu(); 473 if (!$menuxpath) { 474 // Menu not found, exit. 475 return; 476 } 477 478 $this->toggle_page_administration_menu($menuxpath); 479 $this->execute('behat_general::should_not_exist_in_the', [$nodetext, $selectortype, $menuxpath, 'xpath_element']); 480 $this->toggle_page_administration_menu($menuxpath); 481 } 482 483 /** 484 * Go to site administration item 485 * 486 * @Given /^I navigate to "(?P<nodetext_string>(?:[^"]|\\")*)" in site administration$/ 487 * 488 * @throws ExpectationException 489 * @param string $nodetext navigation node to click, may contain path, for example "Reports > Overview" 490 * @return void 491 */ 492 public function i_navigate_to_in_site_administration($nodetext) { 493 $nodelist = array_map('trim', explode('>', $nodetext)); 494 $this->i_select_from_primary_navigation(get_string('administrationsite')); 495 $this->select_on_administration_page($nodelist); 496 } 497 498 /** 499 * Opens the current users profile page in edit mode. 500 * 501 * @Given /^I open my profile in edit mode$/ 502 * @throws coding_exception 503 * @return void 504 */ 505 public function i_open_my_profile_in_edit_mode() { 506 global $USER; 507 508 $user = $this->get_session_user(); 509 $globuser = $USER; 510 $USER = $user; // We need this set to the behat session user so we can call isloggedin. 511 512 $systemcontext = context_system::instance(); 513 514 $bodynode = $this->find('xpath', 'body'); 515 $bodyclass = $bodynode->getAttribute('class'); 516 $matches = []; 517 if (preg_match('/(?<=^course-|\scourse-)\d+/', $bodyclass, $matches) && !empty($matches)) { 518 $courseid = intval($matches[0]); 519 } else { 520 $courseid = SITEID; 521 } 522 523 if (isloggedin() && !isguestuser($user) && !is_mnet_remote_user($user)) { 524 if (is_siteadmin($user) || has_capability('moodle/user:update', $systemcontext)) { 525 $url = new moodle_url('/user/editadvanced.php', array('id' => $user->id, 'course' => SITEID, 526 'returnto' => 'profile')); 527 } else if (has_capability('moodle/user:editownprofile', $systemcontext)) { 528 $userauthplugin = false; 529 if (!empty($user->auth)) { 530 $userauthplugin = get_auth_plugin($user->auth); 531 } 532 if ($userauthplugin && $userauthplugin->can_edit_profile()) { 533 $url = $userauthplugin->edit_profile_url(); 534 if (empty($url)) { 535 if (empty($course)) { 536 $url = new moodle_url('/user/edit.php', array('id' => $user->id, 'returnto' => 'profile')); 537 } else { 538 $url = new moodle_url('/user/edit.php', array('id' => $user->id, 'course' => $courseid, 539 'returnto' => 'profile')); 540 } 541 } 542 543 } 544 } 545 $this->execute('behat_general::i_visit', [$url]); 546 } 547 548 // Restore global user variable. 549 $USER = $globuser; 550 } 551 552 /** 553 * Open a given page, belonging to a plugin or core component. 554 * 555 * The page-type are interpreted by each plugin to work out the 556 * corresponding URL. See the resolve_url method in each class like 557 * behat_mod_forum. That method should document which page types are 558 * recognised, and how the name identifies them. 559 * 560 * For pages belonging to core, the 'core > ' bit is omitted. 561 * 562 * @When /^I am on the (?<page>[^ "]*) page$/ 563 * @When /^I am on the "(?<page>[^"]*)" page$/ 564 * 565 * @param string $page the component and page name. 566 * E.g. 'Admin notifications' or 'core_user > Preferences'. 567 * @throws Exception if the specified page cannot be determined. 568 */ 569 public function i_am_on_page(string $page) { 570 $this->execute('behat_general::i_visit', [$this->resolve_page_helper($page)]); 571 } 572 573 /** 574 * Open a given page logged in as a given user. 575 * 576 * This is like the combination 577 * When I log in as "..." 578 * And I am on the "..." page 579 * but with the advantage that you go straight to the desired page, without 580 * having to wait for the Dashboard to load. 581 * 582 * @When /^I am on the (?<page>[^ "]*) page logged in as (?<username>[^ "]*)$/ 583 * @When /^I am on the "(?<page>[^"]*)" page logged in as (?<username>[^ "]*)$/ 584 * @When /^I am on the (?<page>[^ "]*) page logged in as "(?<username>[^ "]*)"$/ 585 * @When /^I am on the "(?<page>[^"]*)" page logged in as "(?<username>[^ "]*)"$/ 586 * 587 * @param string $page the type of page. E.g. 'Admin notifications' or 'core_user > Preferences'. 588 * @param string $username the name of the user to log in as. E.g. 'admin'. 589 * @throws Exception if the specified page cannot be determined. 590 */ 591 public function i_am_on_page_logged_in_as(string $page, string $username) { 592 self::execute('behat_auth::i_log_in_as', [$username, $this->resolve_page_helper($page)]); 593 } 594 595 /** 596 * Helper used by i_am_on_page() and i_am_on_page_logged_in_as(). 597 * 598 * @param string $page the type of page. E.g. 'Admin notifications' or 'core_user > Preferences'. 599 * @return moodle_url the corresponding URL. 600 */ 601 protected function resolve_page_helper(string $page): moodle_url { 602 list($component, $name) = $this->parse_page_name($page); 603 if ($component === 'core') { 604 return $this->resolve_core_page_url($name); 605 } else { 606 $context = behat_context_helper::get('behat_' . $component); 607 return $context->resolve_page_url($name); 608 } 609 } 610 611 /** 612 * Parse a full page name like 'Admin notifications' or 'core_user > Preferences'. 613 * 614 * E.g. parsing 'mod_quiz > View' gives ['mod_quiz', 'View']. 615 * 616 * @param string $page the full page name 617 * @return array with two elements, component and page name. 618 */ 619 protected function parse_page_name(string $page): array { 620 $dividercount = substr_count($page, ' > '); 621 if ($dividercount === 0) { 622 return ['core', $page]; 623 } else if ($dividercount >= 1) { 624 [$component, $name] = explode(' > ', $page, 2); 625 if ($component === 'core') { 626 throw new coding_exception('Do not specify the component "core > ..." for core pages.'); 627 } 628 return [$component, $name]; 629 } else { 630 throw new coding_exception('The page name must be in the form ' . 631 '"{page-name}" for core pages, or "{component} > {page-name}" ' . 632 'for pages belonging to other components. ' . 633 'For example "Admin notifications" or "mod_quiz > View".'); 634 } 635 } 636 637 /** 638 * Open a given instance of a page, belonging to a plugin or core component. 639 * 640 * The instance identifier and page-type are interpreted by each plugin to 641 * work out the corresponding URL. See the resolve_page_instance_url method 642 * in each class like behat_mod_forum. That method should document which page 643 * types are recognised, and how the name identifies them. 644 * 645 * For pages belonging to core, the 'core > ' bit is omitted. 646 * 647 * @When /^I am on the (?<identifier>[^ "]*) (?<type>[^ "]*) page$/ 648 * @When /^I am on the "(?<identifier>[^"]*)" "(?<type>[^"]*)" page$/ 649 * @When /^I am on the (?<identifier>[^ "]*) "(?<type>[^"]*)" page$/ 650 * @When /^I am on the "(?<identifier>[^"]*)" (?<type>[^ "]*) page$/ 651 * 652 * @param string $identifier identifies the particular page. E.g. 'Test quiz'. 653 * @param string $type the component and page type. E.g. 'mod_quiz > View'. 654 * @throws Exception if the specified page cannot be determined. 655 */ 656 public function i_am_on_page_instance(string $identifier, string $type) { 657 $this->execute('behat_general::i_visit', [$this->resolve_page_instance_helper($identifier, $type)]); 658 } 659 660 /** 661 * Open a given page logged in as a given user. 662 * 663 * This is like the combination 664 * When I log in as "..." 665 * And I am on the "..." "..." page 666 * but with the advantage that you go straight to the desired page, without 667 * having to wait for the Dashboard to load. 668 * 669 * @When /^I am on the (?<identifier>[^ "]*) (?<type>[^ "]*) page logged in as (?<username>[^ "]*)$/ 670 * @When /^I am on the "(?<identifier>[^"]*)" "(?<type>[^"]*)" page logged in as (?<username>[^ "]*)$/ 671 * @When /^I am on the (?<identifier>[^ "]*) "(?<type>[^"]*)" page logged in as (?<username>[^ "]*)$/ 672 * @When /^I am on the "(?<identifier>[^"]*)" (?<type>[^ "]*) page logged in as (?<username>[^ "]*)$/ 673 * @When /^I am on the (?<identifier>[^ "]*) (?<type>[^ "]*) page logged in as "(?<username>[^"]*)"$/ 674 * @When /^I am on the "(?<identifier>[^"]*)" "(?<type>[^"]*)" page logged in as "(?<username>[^"]*)"$/ 675 * @When /^I am on the (?<identifier>[^ "]*) "(?<type>[^"]*)" page logged in as "(?<username>[^"]*)"$/ 676 * @When /^I am on the "(?<identifier>[^"]*)" (?<type>[^ "]*) page logged in as "(?<username>[^"]*)"$/ 677 * 678 * @param string $identifier identifies the particular page. E.g. 'Test quiz'. 679 * @param string $type the component and page type. E.g. 'mod_quiz > View'. 680 * @param string $username the name of the user to log in as. E.g. 'student'. 681 * @throws Exception if the specified page cannot be determined. 682 */ 683 public function i_am_on_page_instance_logged_in_as(string $identifier, 684 string $type, string $username) { 685 self::execute('behat_auth::i_log_in_as', 686 [$username, $this->resolve_page_instance_helper($identifier, $type)]); 687 } 688 689 /** 690 * Helper used by i_am_on_page() and i_am_on_page_logged_in_as(). 691 * 692 * @param string $identifier identifies the particular page. E.g. 'Test quiz'. 693 * @param string $pagetype the component and page type. E.g. 'mod_quiz > View'. 694 * @return moodle_url the corresponding URL. 695 */ 696 protected function resolve_page_instance_helper(string $identifier, string $pagetype): moodle_url { 697 list($component, $type) = $this->parse_page_name($pagetype); 698 if ($component === 'core') { 699 return $this->resolve_core_page_instance_url($type, $identifier); 700 } else { 701 $context = behat_context_helper::get('behat_' . $component); 702 return $context->resolve_page_instance_url($type, $identifier); 703 } 704 } 705 706 /** 707 * Convert core page names to URLs for steps like 'When I am on the "[page name]" page'. 708 * 709 * Recognised page names are: 710 * | Homepage | Homepage (normally dashboard). | 711 * | Admin notifications | Admin notification screen. | 712 * 713 * @param string $name identifies which identifies this page, e.g. 'Homepage', 'Admin notifications'. 714 * @return moodle_url the corresponding URL. 715 * @throws Exception with a meaningful error message if the specified page cannot be found. 716 */ 717 protected function resolve_core_page_url(string $name): moodle_url { 718 switch ($name) { 719 case 'Homepage': 720 return new moodle_url('/'); 721 722 case 'My courses': 723 return new moodle_url('/my/courses.php'); 724 725 case 'Admin notifications': 726 return new moodle_url('/admin/'); 727 728 case 'My private files': 729 return new moodle_url('/user/files.php'); 730 731 case 'System logs report': 732 return new moodle_url('/report/log/index.php'); 733 734 case 'Profile': 735 return new moodle_url('/user/view.php'); 736 737 case 'Profile advanced editing': 738 return new moodle_url('/user/editadvanced.php', ['returnto' => 'profile']); 739 740 case 'Profile editing': 741 return new moodle_url('/user/edit.php', ['returnto' => 'profile']); 742 743 default: 744 throw new Exception('Unrecognised core page type "' . $name . '."'); 745 } 746 } 747 748 /** 749 * Convert page names to URLs for steps like 'When I am on the "[identifier]" "[page type]" page'. 750 * 751 * Recognised page names are: 752 * | Page type | Identifier meaning | description | 753 * | Category | category idnumber | List of courses in that category. | 754 * | Course | course shortname | Main course home pag | 755 * | Course editing | course shortname | Edit settings page for the course | 756 * | Activity | activity idnumber | Start page for that activity | 757 * | Activity editing | activity idnumber | Edit settings page for that activity | 758 * | [modname] Activity | activity name or idnumber | Start page for that activity | 759 * | [modname] Activity editing | activity name or idnumber | Edit settings page for that activity | 760 * | Backup | course shortname | Course to backup | 761 * | Import | course shortname | Course import from | 762 * | Restore | course shortname | Course to restore from | 763 * | Reset | course shortname | Course to reset | 764 * | Course copy | course shortname | Course to copy | 765 * | Groups | course shortname | Groups page for the course | 766 * | Groups overview | course shortname | Groups overview page for the course | 767 * | Groupings | course shortname | Groupings page for the course | 768 * | Permissions | course shortname | Permissions page for the course | 769 * | Enrolment methods | course shortname | Enrolment methods for the course | 770 * | Enrolled users | course shortname | The main participants page | 771 * | Other users | course shortname | The course other users page | 772 * | Course profile | course shortname | The current user's profile for this course | 773 * | Course profile editing | course shortname | The current user's profile editing page for this course | 774 * | Course profile advanced editing | course shortname | The current user's advanced profile editing page for this course | 775 * 776 * Examples: 777 * 778 * When I am on the "Welcome to ECON101" "forum activity" page logged in as student1 779 * 780 * @param string $type identifies which type of page this is, e.g. 'Category page'. 781 * @param string $identifier identifies the particular page, e.g. 'test-cat'. 782 * @return moodle_url the corresponding URL. 783 * @throws Exception with a meaningful error message if the specified page cannot be found. 784 */ 785 protected function resolve_core_page_instance_url(string $type, string $identifier): moodle_url { 786 $type = strtolower($type); 787 $coursenotfoundexception = new Exception( 788 "The specified course with shortname, fullname, or idnumber '{$identifier}' does not exist", 789 ); 790 791 switch ($type) { 792 case 'category': 793 $categoryid = $this->get_category_id($identifier); 794 if (!$categoryid) { 795 throw new Exception('The specified category with idnumber "' . $identifier . '" does not exist'); 796 } 797 return new moodle_url('/course/index.php', ['categoryid' => $categoryid]); 798 799 case 'course editing': 800 $courseid = $this->get_course_id($identifier); 801 if (!$courseid) { 802 throw $coursenotfoundexception; 803 } 804 return new moodle_url('/course/edit.php', ['id' => $courseid]); 805 806 case 'course': 807 $courseid = $this->get_course_id($identifier); 808 if (!$courseid) { 809 throw $coursenotfoundexception; 810 } 811 return new moodle_url('/course/view.php', ['id' => $courseid]); 812 813 case 'activity': 814 $cm = $this->get_course_module_for_identifier($identifier); 815 if (!$cm) { 816 throw new Exception('The specified activity with idnumber "' . $identifier . '" does not exist'); 817 } 818 return $cm->url; 819 820 case 'activity editing': 821 $cm = $this->get_course_module_for_identifier($identifier); 822 if (!$cm) { 823 throw new Exception('The specified activity with idnumber "' . $identifier . '" does not exist'); 824 } 825 return new moodle_url('/course/modedit.php', [ 826 'update' => $cm->id, 827 ]); 828 case 'backup': 829 $courseid = $this->get_course_id($identifier); 830 if (!$courseid) { 831 throw $coursenotfoundexception; 832 } 833 return new moodle_url('/backup/backup.php', ['id' => $courseid]); 834 case 'import': 835 $courseid = $this->get_course_id($identifier); 836 if (!$courseid) { 837 throw $coursenotfoundexception; 838 } 839 return new moodle_url('/backup/import.php', ['id' => $courseid]); 840 case 'restore': 841 $courseid = $this->get_course_id($identifier); 842 if (!$courseid) { 843 throw $coursenotfoundexception; 844 } 845 $context = context_course::instance($courseid); 846 return new moodle_url('/backup/restorefile.php', ['contextid' => $context->id]); 847 case 'reset': 848 $courseid = $this->get_course_id($identifier); 849 if (!$courseid) { 850 throw $coursenotfoundexception; 851 } 852 return new moodle_url('/course/reset.php', ['id' => $courseid]); 853 case 'course copy': 854 $courseid = $this->get_course_id($identifier); 855 if (!$courseid) { 856 throw $coursenotfoundexception; 857 } 858 return new moodle_url('/backup/copy.php', ['id' => $courseid]); 859 case 'groups': 860 $courseid = $this->get_course_id($identifier); 861 if (!$courseid) { 862 throw $coursenotfoundexception; 863 } 864 return new moodle_url('/group/index.php', ['id' => $courseid]); 865 case 'groups overview': 866 $courseid = $this->get_course_id($identifier); 867 if (!$courseid) { 868 throw $coursenotfoundexception; 869 } 870 return new moodle_url('/group/overview.php', ['id' => $courseid]); 871 case 'groupings': 872 $courseid = $this->get_course_id($identifier); 873 if (!$courseid) { 874 throw $coursenotfoundexception; 875 } 876 return new moodle_url('/group/groupings.php', ['id' => $courseid]); 877 case 'permissions': 878 $courseid = $this->get_course_id($identifier); 879 if (!$courseid) { 880 throw $coursenotfoundexception; 881 } 882 $context = context_course::instance($courseid); 883 return new moodle_url('/admin/roles/permissions.php', ['contextid' => $context->id]); 884 case 'enrolment methods': 885 $courseid = $this->get_course_id($identifier); 886 if (!$courseid) { 887 throw $coursenotfoundexception; 888 } 889 return new moodle_url('/enrol/instances.php', ['id' => $courseid]); 890 case 'enrolled users': 891 $courseid = $this->get_course_id($identifier); 892 if (!$courseid) { 893 throw $coursenotfoundexception; 894 } 895 return new moodle_url('/user/index.php', ['id' => $courseid]); 896 case 'other users': 897 $courseid = $this->get_course_id($identifier); 898 if (!$courseid) { 899 throw $coursenotfoundexception; 900 } 901 return new moodle_url('/enrol/otherusers.php', ['id' => $courseid]); 902 case 'renameroles': 903 $courseid = $this->get_course_id($identifier); 904 if (!$courseid) { 905 throw $coursenotfoundexception; 906 } 907 return new moodle_url('/enrol/renameroles.php', ['id' => $courseid]); 908 909 case 'course profile': 910 $courseid = $this->get_course_id($identifier); 911 if (!$courseid) { 912 throw $coursenotfoundexception; 913 } 914 return new moodle_url('/user/user.php', ['course' => $courseid]); 915 916 case 'course profile editing': 917 $courseid = $this->get_course_id($identifier); 918 if (!$courseid) { 919 throw $coursenotfoundexception; 920 } 921 return new moodle_url('/user/edit.php', [ 922 'course' => $courseid, 923 'returnto' => 'profile', 924 ]); 925 926 case 'course profile advanced editing': 927 $courseid = $this->get_course_id($identifier); 928 if (!$courseid) { 929 throw $coursenotfoundexception; 930 } 931 return new moodle_url('/user/editadvanced.php', [ 932 'course' => $courseid, 933 'returnto' => 'profile', 934 ]); 935 } 936 937 $parts = explode(' ', $type); 938 if (count($parts) > 1) { 939 if ($parts[1] === 'activity') { 940 $modname = $parts[0]; 941 $cm = $this->get_cm_by_activity_name($modname, $identifier); 942 943 if (count($parts) == 2) { 944 // View page. 945 return new moodle_url($cm->url); 946 } 947 948 if ($parts[2] === 'editing') { 949 // Edit settings page. 950 return new moodle_url('/course/modedit.php', ['update' => $cm->id]); 951 } 952 953 if ($parts[2] === 'roles') { 954 // Locally assigned roles page. 955 return new moodle_url('/admin/roles/assign.php', ['contextid' => $cm->context->id]); 956 } 957 958 if ($parts[2] === 'permissions') { 959 // Permissions page. 960 return new moodle_url('/admin/roles/permissions.php', ['contextid' => $cm->context->id]); 961 } 962 } 963 } 964 965 throw new Exception('Unrecognised core page type "' . $type . '."'); 966 } 967 968 /** 969 * Opens a new tab with given name on the same URL as current page and switches to it. 970 * 971 * @param string $name Tab name that can be used for switching later (no whitespace) 972 * @When /^I open a tab named "(?<name>[^"]*)" on the current page$/ 973 */ 974 public function i_open_a_tab_on_the_current_page(string $name): void { 975 $this->open_tab($name, 'location.href'); 976 } 977 978 /** 979 * Opens a new tab with given name on specified page, and switches to it. 980 * 981 * @param string $name Tab name that can be used for switching later (no whitespace) 982 * @param string $page Page name 983 * @When /^I open a tab named "(?<name>[^"]*)" on the "(?<page>[^"]*)" page$/ 984 */ 985 public function i_open_a_tab_on_the_page(string $name, string $page): void { 986 if ($page === 'current') { 987 $jstarget = 'location.href'; 988 } else { 989 $jstarget = '"' . addslashes_js($this->resolve_page_helper($page)->out(false)) . '"'; 990 } 991 $this->open_tab($name, $jstarget); 992 } 993 994 /** 995 * Opens a new tab with given name (on specified page), and switches to it. 996 * 997 * @param string $name Tab name that can be used for switching later (no whitespace) 998 * @param string $identifier Page identifier 999 * @param string $page Page type 1000 * @When /^I open a tab named "(?<name>[^"]*)" on the "(?<identifier>[^"]*)" "(?<page>[^"]*)" page$/ 1001 */ 1002 public function i_open_a_tab_on_the_page_instance(string $name, string $identifier, string $page): void { 1003 $this->open_tab($name, '"' . addslashes_js( 1004 $this->resolve_page_instance_helper($identifier, $page)->out(false)) . '"'); 1005 } 1006 1007 /** 1008 * Opens a new tab at the given target URL. 1009 * 1010 * @param string $name Name for tab 1011 * @param string $jstarget Target in JavaScript syntax, i.e. if a string, must be quoted 1012 */ 1013 protected function open_tab(string $name, string $jstarget): void { 1014 // Tab names aren't allowed spaces, and our JavaScript below doesn't do any escaping. 1015 if (clean_param($name, PARAM_ALPHANUMEXT) !== $name) { 1016 throw new Exception('Tab name may not contain whitespace or special characters: "' . $name . '"'); 1017 } 1018 1019 // Normally you can't open a tab unless in response to a user action, but presumably Behat 1020 // is exempt from this restriction, because it works to just open it directly. 1021 $this->execute_script('window.open(' . $jstarget . ', "' . $name . '");'); 1022 $this->execute('behat_general::switch_to_window', [$name]); 1023 } 1024 1025 /** 1026 * Opens the course homepage. (Consider using 'I am on the "shortname" "Course" page' step instead.) 1027 * 1028 * @Given /^I am on "(?P<coursefullname_string>(?:[^"]|\\")*)" course homepage$/ 1029 * @throws coding_exception 1030 * @param string $coursefullname The full name of the course. 1031 * @return void 1032 */ 1033 public function i_am_on_course_homepage($coursefullname) { 1034 $courseid = $this->get_course_id($coursefullname); 1035 $url = new moodle_url('/course/view.php', ['id' => $courseid]); 1036 $this->execute('behat_general::i_visit', [$url]); 1037 } 1038 1039 /** 1040 * Open the course homepage with editing mode enabled. 1041 * 1042 * @param string $coursefullname The course full name of the course. 1043 */ 1044 public function i_am_on_course_homepage_with_editing_mode_on($coursefullname) { 1045 $this->i_am_on_course_homepage_with_editing_mode_set_to($coursefullname, 'on'); 1046 } 1047 1048 /** 1049 * Open the course homepage with editing mode set to either on, or off. 1050 * 1051 * @Given I am on :coursefullname course homepage with editing mode :onoroff 1052 * @throws coding_exception 1053 * @param string $coursefullname The course full name of the course. 1054 * @param string $onoroff Whehter to switch editing on, or off. 1055 */ 1056 public function i_am_on_course_homepage_with_editing_mode_set_to(string $coursefullname, string $onoroff): void { 1057 if ($onoroff !== 'on' && $onoroff !== 'off') { 1058 throw new coding_exception("Unknown editing mode '{$onoroff}'. Accepted values are 'on' and 'off'"); 1059 } 1060 1061 $courseid = $this->get_course_id($coursefullname); 1062 $context = context_course::instance($courseid); 1063 $courseurl = new moodle_url('/course/view.php', ['id' => $courseid]); 1064 1065 $editmodeurl = new moodle_url('/editmode.php', [ 1066 'context' => $context->id, 1067 'pageurl' => $courseurl->out(true), 1068 'setmode' => ($onoroff === 'on' ? 1 : 0), 1069 ]); 1070 $this->execute('behat_general::i_visit', [$editmodeurl]); 1071 } 1072 1073 /** 1074 * Opens the flat navigation drawer if it is not already open 1075 * 1076 * @When /^I open flat navigation drawer$/ 1077 * @throws ElementNotFoundException Thrown by behat_base::find 1078 */ 1079 public function i_open_flat_navigation_drawer() { 1080 if (!$this->running_javascript()) { 1081 // Navigation drawer is always open without JS. 1082 return; 1083 } 1084 $xpath = "//button[contains(@data-action,'toggle-drawer')]"; 1085 $node = $this->find('xpath', $xpath); 1086 $expanded = $node->getAttribute('aria-expanded'); 1087 if ($expanded === 'false') { 1088 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 1089 $this->ensure_node_attribute_is_set($node, 'aria-expanded', 'true'); 1090 } 1091 } 1092 1093 /** 1094 * Closes the flat navigation drawer if it is open (does nothing if JS disabled) 1095 * 1096 * @When /^I close flat navigation drawer$/ 1097 * @throws ElementNotFoundException Thrown by behat_base::find 1098 */ 1099 public function i_close_flat_navigation_drawer() { 1100 if (!$this->running_javascript()) { 1101 // Navigation drawer can not be closed without JS. 1102 return; 1103 } 1104 $xpath = "//button[contains(@data-action,'toggle-drawer')]"; 1105 $node = $this->find('xpath', $xpath); 1106 $expanded = $node->getAttribute('aria-expanded'); 1107 if ($expanded === 'true') { 1108 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 1109 } 1110 } 1111 1112 /** 1113 * Clicks link with specified id|title|alt|text in the primary navigation 1114 * 1115 * @When /^I select "(?P<link_string>(?:[^"]|\\")*)" from primary navigation$/ 1116 * @throws ElementNotFoundException Thrown by behat_base::find 1117 * @param string $link 1118 */ 1119 public function i_select_from_primary_navigation(string $link) { 1120 $this->execute('behat_general::i_click_on_in_the', 1121 [$link, 'link', '.primary-navigation .moremenu.navigation', 'css_element'] 1122 ); 1123 } 1124 1125 /** 1126 * Clicks link with specified id|title|alt|text in the secondary navigation 1127 * 1128 * @When I select :link from secondary navigation 1129 * @throws ElementNotFoundException Thrown by behat_base::find 1130 * @param string $link 1131 */ 1132 public function i_select_from_secondary_navigation(string $link) { 1133 $this->execute('behat_general::i_click_on_in_the', 1134 [$link, 'link', '.secondary-navigation .moremenu.navigation', 'css_element'] 1135 ); 1136 } 1137 1138 /** 1139 * If we are not on the course main page, click on the course link in the navbar 1140 */ 1141 protected function go_to_main_course_page() { 1142 $url = $this->getSession()->getCurrentUrl(); 1143 if (!preg_match('|/course/view.php\?id=[\d]+$|', $url)) { 1144 $node = $this->find('xpath', 1145 '//header//div[@id=\'page-navbar\']//a[contains(@href,\'/course/view.php?id=\')]' 1146 ); 1147 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 1148 } 1149 } 1150 1151 /** 1152 * Finds and clicks a link on the admin page (site administration or course administration) 1153 * 1154 * @param array $nodelist 1155 */ 1156 protected function select_on_administration_page($nodelist) { 1157 $parentnodes = $nodelist; 1158 $lastnode = array_pop($parentnodes); 1159 $xpath = '//section[@id=\'region-main\']'; 1160 1161 // Check if there is a separate tab for this submenu of the page. If found go to it. 1162 if ($parentnodes) { 1163 $tabname = behat_context_helper::escape($parentnodes[0]); 1164 $tabxpath = '//ul[@role=\'tablist\']/li/a[contains(normalize-space(.), ' . $tabname . ')]'; 1165 $menubarxpath = '//ul[@role=\'menubar\']/li/a[contains(normalize-space(.), ' . $tabname . ')]'; 1166 $linkname = behat_context_helper::escape(get_string('moremenu')); 1167 $menubarmorexpath = '//ul[contains(@class,\'more-nav\')]/li/a[contains(normalize-space(.), ' . $linkname . ')]'; 1168 $tabnode = $this->getSession()->getPage()->find('xpath', $tabxpath); 1169 $menunode = $this->getSession()->getPage()->find('xpath', $menubarxpath); 1170 $menubuttons = $this->getSession()->getPage()->findAll('xpath', $menubarmorexpath); 1171 if ($tabnode || $menunode) { 1172 $node = is_object($tabnode) ? $tabnode : $menunode; 1173 if ($this->running_javascript()) { 1174 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 1175 // Click on the tab and add 'active' tab to the xpath. 1176 $xpath .= '//div[contains(@class,\'active\')]'; 1177 } else { 1178 // Add the tab content selector to the xpath. 1179 $tabid = behat_context_helper::escape(ltrim($node->getAttribute('href'), '#')); 1180 $xpath .= '//div[@id = ' . $tabid . ']'; 1181 } 1182 array_shift($parentnodes); 1183 } else if (count($menubuttons) > 0) { 1184 try { 1185 $menubuttons[0]->isVisible(); 1186 try { 1187 $this->execute('behat_general::i_click_on', [$menubuttons[1], 'NodeElement']); 1188 } catch (Exception $e) { 1189 $this->execute('behat_general::i_click_on', [$menubuttons[0], 'NodeElement']); 1190 } 1191 $moreitemxpath = '//ul[@data-region=\'moredropdown\']/li/a[contains(normalize-space(.), ' . $tabname . ')]'; 1192 if ($morenode = $this->getSession()->getPage()->find('xpath', $moreitemxpath)) { 1193 $this->execute('behat_general::i_click_on', [$morenode, 'NodeElement']); 1194 $xpath .= '//div[contains(@class,\'active\')]'; 1195 array_shift($parentnodes); 1196 } 1197 } catch (Exception $e) { 1198 } 1199 } 1200 } 1201 1202 // Find a section with the parent name in it. 1203 if ($parentnodes) { 1204 // Find the section on the page (links may be repeating in different sections). 1205 $section = behat_context_helper::escape($parentnodes[0]); 1206 $xpath .= '//div[@class=\'row\' and contains(.,'.$section.')]'; 1207 } 1208 1209 // Find a link and click on it. 1210 $linkname = behat_context_helper::escape($lastnode); 1211 $xpathlink = $xpathbutton = $xpath; 1212 $xpathlink .= '//a[contains(normalize-space(.), ' . $linkname . ')]'; 1213 $xpathbutton .= '//button[contains(normalize-space(.), ' . $linkname . ')]'; 1214 if ($node = $this->getSession()->getPage()->find('xpath', $xpathbutton)) { 1215 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 1216 } else if (!$node = $this->getSession()->getPage()->find('xpath', $xpathlink)) { 1217 throw new ElementNotFoundException($this->getSession(), 'Link "' . join(' > ', $nodelist) . '"'); 1218 } else { 1219 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 1220 } 1221 } 1222 1223 /** 1224 * Locates the administration menu in the <header> element and returns its xpath 1225 * 1226 * @param bool $mustexist if specified throws an exception if menu is not found 1227 * @return null|string 1228 */ 1229 protected function find_header_administration_menu($mustexist = false) { 1230 $menuxpath = '//div[contains(@class,\'secondary-navigation\')]//nav[contains(@class,\'moremenu\')]'; 1231 1232 if ($mustexist) { 1233 $exception = new ElementNotFoundException($this->getSession(), 'Page header administration menu'); 1234 $this->find('xpath', $menuxpath, $exception); 1235 } else if (!$this->getSession()->getPage()->find('xpath', $menuxpath)) { 1236 return null; 1237 } 1238 return $menuxpath; 1239 } 1240 1241 /** 1242 * Locates the administration menu on the page (but not in the header) and returns its xpath 1243 * 1244 * @param bool $mustexist if specified throws an exception if menu is not found 1245 * @return null|string 1246 */ 1247 protected function find_page_administration_menu($mustexist = false) { 1248 $menuxpath = '//div[@id=\'region-main-settings-menu\']'; 1249 if ($mustexist) { 1250 $exception = new ElementNotFoundException($this->getSession(), 'Page administration menu'); 1251 $this->find('xpath', $menuxpath, $exception); 1252 } else if (!$this->getSession()->getPage()->find('xpath', $menuxpath)) { 1253 return null; 1254 } 1255 return $menuxpath; 1256 } 1257 1258 /** 1259 * Locates the action menu on the page (but not in the header) and returns its xpath 1260 * 1261 * @param null|bool $mustexist if specified throws an exception if menu is not found 1262 * @return null|string 1263 */ 1264 protected function find_page_action_menu($mustexist = false) { 1265 $menuxpath = '//div[@id=\'action-menu-0-menubar\']'; 1266 1267 if ($mustexist) { 1268 $exception = new ElementNotFoundException($this->getSession(), 'Page check'); 1269 $this->find('xpath', $menuxpath, $exception); 1270 } else if (!$this->getSession()->getPage()->find('xpath', $menuxpath)) { 1271 return null; 1272 } 1273 return $menuxpath; 1274 } 1275 1276 /** 1277 * Toggles administration menu 1278 * 1279 * @param string $menuxpath (optional) xpath to the page administration menu if already known 1280 */ 1281 protected function toggle_page_administration_menu($menuxpath = null) { 1282 if (!$menuxpath) { 1283 $menuxpath = $this->find_header_administration_menu() ?: $this->find_page_administration_menu(); 1284 } 1285 if ($menuxpath && $this->running_javascript()) { 1286 $node = $this->find('xpath', $menuxpath . '//a[@data-toggle=\'dropdown\']'); 1287 if ($node->isVisible()) { 1288 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 1289 } 1290 } 1291 } 1292 1293 /** 1294 * Finds a page edit cog and select an item from it 1295 * 1296 * If the page edit cog is in the page header and the item is not found there, click "More..." link 1297 * and find the item on the course/frontpage administration page 1298 * 1299 * @param array $nodelist 1300 * @throws ElementNotFoundException 1301 */ 1302 protected function select_from_administration_menu($nodelist) { 1303 // Find administration menu. 1304 if ($menuxpath = $this->find_header_administration_menu()) { 1305 $isheader = true; 1306 } else if ($menuxpath = $this->find_page_action_menu(true)) { 1307 $isheader = false; 1308 } else { 1309 $menuxpath = $this->find_page_administration_menu(true); 1310 $isheader = false; 1311 } 1312 1313 $this->execute('behat_navigation::toggle_page_administration_menu', [$menuxpath]); 1314 1315 $firstnode = $nodelist[0]; 1316 $firstlinkname = behat_context_helper::escape($firstnode); 1317 $firstlink = $this->getSession()->getPage()->find('xpath', 1318 $menuxpath . '//a[contains(normalize-space(.), ' . $firstlinkname . ')]' 1319 ); 1320 1321 if (!$isheader || count($nodelist) == 1) { 1322 $lastnode = end($nodelist); 1323 $linkname = behat_context_helper::escape($lastnode); 1324 $link = $this->getSession()->getPage()->find('xpath', $menuxpath . '//a[contains(normalize-space(.), ' . $linkname . ')]'); 1325 if ($link) { 1326 $this->execute('behat_general::i_click_on', [$link, 'NodeElement']); 1327 return; 1328 } 1329 } else if ($firstlink) { 1330 $this->execute('behat_general::i_click_on', [$firstlink, 'NodeElement']); 1331 array_splice($nodelist, 0, 1); 1332 $this->select_on_administration_page($nodelist); 1333 return; 1334 } 1335 1336 if ($isheader) { 1337 // Front page administration will have subnodes under "More...". 1338 $linkname = behat_context_helper::escape(get_string('morenavigationlinks')); 1339 $link = $this->getSession()->getPage()->find('xpath', 1340 $menuxpath . '//a[contains(normalize-space(.), ' . $linkname . ')]' 1341 ); 1342 // Course administration will have subnodes under "Course administration". 1343 $courselinkname = behat_context_helper::escape(get_string('courseadministration')); 1344 $courselink = $this->getSession()->getPage()->find('xpath', 1345 $menuxpath . '//a[contains(normalize-space(.), ' . $courselinkname . ')]' 1346 ); 1347 if ($link) { 1348 $this->execute('behat_general::i_click_on', [$link, 'NodeElement']); 1349 $this->select_on_administration_page($nodelist); 1350 return; 1351 } else if ($courselink) { 1352 $this->execute('behat_general::i_click_on', [$courselink, 'NodeElement']); 1353 $this->select_on_administration_page($nodelist); 1354 return; 1355 } 1356 } 1357 1358 throw new ElementNotFoundException($this->getSession(), 1359 'Link "' . join(' > ', $nodelist) . '" in the current page edit menu"'); 1360 } 1361 1362 /** 1363 * Visit a fixture page for testing stuff that is not available in core. 1364 * 1365 * Please always, to prevent unwanted requests, protect behat fixture files with: 1366 * defined('BEHAT_SITE_RUNNING') || die(); 1367 * 1368 * @Given /^I am on fixture page "(?P<url_string>(?:[^"]|\\")*)"$/ 1369 * @param string $url local path to fixture page 1370 */ 1371 public function i_am_on_fixture_page($url) { 1372 $fixtureregex = '|^/[a-z0-9_\-/]*/tests/behat/fixtures/[a-z0-9_\-]*\.php$|'; 1373 if (!preg_match($fixtureregex, $url)) { 1374 throw new coding_exception("URL {$url} is not a fixture URL"); 1375 } 1376 $this->execute('behat_general::i_visit', [$url]); 1377 } 1378 1379 /** 1380 * First checks to see if we are on this page via the breadcrumb. If not we then attempt to follow the link name given. 1381 * 1382 * @param string $pagename Name of the breadcrumb item to check and follow. 1383 * @Given /^I follow the breadcrumb "(?P<url_string>(?:[^"]|\\")*)"$/ 1384 */ 1385 public function go_to_breadcrumb_location(string $pagename): void { 1386 $link = $this->getSession()->getPage()->find( 1387 'xpath', 1388 "//nav[@aria-label='Navigation bar']/ol/li[last()][contains(normalize-space(.), '" . $pagename . "')]" 1389 ); 1390 if (!$link) { 1391 $this->execute("behat_general::i_click_on_in_the", [$pagename, 'link', 'page', 'region']); 1392 } 1393 } 1394 1395 /** 1396 * Checks whether an item exists in the user menu. 1397 * 1398 * @Given :itemtext :selectortype should exist in the user menu 1399 * @Given :itemtext :selectortype should :not exist in the user menu 1400 * 1401 * @throws ElementNotFoundException 1402 * @param string $itemtext The menu item to find 1403 * @param string $selectortype The selector type 1404 * @param string|null $not Instructs to checks whether the element does not exist in the user menu, if defined 1405 * @return void 1406 */ 1407 public function should_exist_in_user_menu($itemtext, $selectortype, $not = null) { 1408 $callfunction = is_null($not) ? 'should_exist_in_the' : 'should_not_exist_in_the'; 1409 $this->execute("behat_general::{$callfunction}", 1410 [$itemtext, $selectortype, $this->get_user_menu_xpath(), 'xpath_element']); 1411 } 1412 1413 /** 1414 * Checks whether an item exists in a given user submenu. 1415 * 1416 * @Given :itemtext :selectortype should exist in the :submenuname user submenu 1417 * @Given :itemtext :selectortype should :not exist in the :submenuname user submenu 1418 * 1419 * @throws ElementNotFoundException 1420 * @param string $itemtext The submenu item to find 1421 * @param string $selectortype The selector type 1422 * @param string $submenuname The name of the submenu 1423 * @param string|null $not Instructs to checks whether the element does not exist in the user menu, if defined 1424 * @return void 1425 */ 1426 public function should_exist_in_user_submenu($itemtext, $selectortype, $submenuname, $not = null) { 1427 $callfunction = is_null($not) ? 'should_exist_in_the' : 'should_not_exist_in_the'; 1428 $this->execute("behat_general::{$callfunction}", 1429 [$itemtext, $selectortype, $this->get_user_submenu_xpath($submenuname), 'xpath_element']); 1430 } 1431 1432 /** 1433 * Checks whether a given user submenu is visible. 1434 * 1435 * @Then /^I should see "(?P<submenu_string>[^"]*)" user submenu$/ 1436 * 1437 * @throws ElementNotFoundException 1438 * @throws ExpectationException 1439 * @param string $submenuname The name of the submenu 1440 * @return void 1441 */ 1442 public function i_should_see_user_submenu($submenuname) { 1443 $this->execute('behat_general::should_be_visible', 1444 array($this->get_user_submenu_xpath($submenuname), 'xpath_element')); 1445 } 1446 1447 /** 1448 * Return the xpath for the user menu element. 1449 * 1450 * @return string The xpath 1451 */ 1452 protected function get_user_menu_xpath() { 1453 return "//div[contains(concat(' ', @class, ' '), ' usermenu ')]" . 1454 "//div[contains(concat(' ', @class, ' '), ' dropdown-menu ')]" . 1455 "//div[@id='carousel-item-main']"; 1456 } 1457 1458 /** 1459 * Return the xpath for a given user submenu element. 1460 * 1461 * @param string $submenuname The name of the submenu 1462 * @return string The xpath 1463 */ 1464 protected function get_user_submenu_xpath($submenuname) { 1465 return "//div[contains(concat(' ', @class, ' '), ' usermenu ')]" . 1466 "//div[contains(concat(' ', @class, ' '), ' dropdown-menu ')]" . 1467 "//div[contains(concat(' ', @class, ' '), ' submenu ')][@aria-label='" . $submenuname . "']"; 1468 } 1469 1470 /** 1471 * Returns whether the user can edit the current page. 1472 * 1473 * @return bool 1474 */ 1475 protected function is_editing_on() { 1476 $body = $this->find('xpath', "//body", false, false, 0); 1477 return $body->hasClass('editing'); 1478 } 1479 1480 /** 1481 * Turns editing mode on. 1482 * @Given I switch editing mode on 1483 * @Given I turn editing mode on 1484 */ 1485 public function i_turn_editing_mode_on() { 1486 $this->execute('behat_forms::i_set_the_field_to', [get_string('editmode'), 1]); 1487 1488 if (!$this->running_javascript()) { 1489 $this->execute('behat_general::i_click_on', [ 1490 get_string('setmode', 'core'), 1491 'button', 1492 ]); 1493 } 1494 1495 if (!$this->is_editing_on()) { 1496 throw new ExpectationException('The edit mode could not be turned on', $this->getSession()); 1497 } 1498 } 1499 1500 /** 1501 * Turns editing mode off. 1502 * @Given I switch editing mode off 1503 * @Given I turn editing mode off 1504 */ 1505 public function i_turn_editing_mode_off() { 1506 $this->execute('behat_forms::i_set_the_field_to', [get_string('editmode'), 0]); 1507 1508 if (!$this->running_javascript()) { 1509 $this->execute('behat_general::i_click_on', [ 1510 get_string('setmode', 'core'), 1511 'button', 1512 ]); 1513 } 1514 1515 if ($this->is_editing_on()) { 1516 throw new ExpectationException('The edit mode could not be turned off', $this->getSession()); 1517 } 1518 } 1519 1520 /** 1521 * The named item should exist in the named dropdown. 1522 * 1523 * @Then /^the "(?P<item_string>[^"]*)" item should (?P<not_bool>not )?exist in the "(?P<dropdown_string>[^"]*)" dropdown$/ 1524 * @Then /^the "(?P<item_string>[^"]*)" item should (?P<not_bool>not )?exist in the "(?P<dropdown_string>[^"]*)" dropdown of the "(?P<container_string>[^"]*)" "(?P<containertype_string>[^"]*)"$/ 1525 * @param string $item The text on the dropdown menu item 1526 * @param bool $not Whether to negate this search 1527 * @param string $dropdown The name of the dropdown 1528 * @param string $container The name of the container 1529 * @param string $containertype The type of the container 1530 */ 1531 public function should_exist_in_dropdown( 1532 string $item, 1533 bool $not, 1534 string $dropdown, 1535 string $container = null, 1536 string $containertype = null, 1537 ): void { 1538 $containernode = null; 1539 if ($container && $containertype) { 1540 $containernode = $this->find( 1541 selector: $containertype, 1542 locator: $container, 1543 node: null, 1544 ); 1545 } 1546 $this->should_exist_in_dropdown_in( 1547 item: $item, 1548 dropdown: $dropdown, 1549 container: $containernode, 1550 not: $not, 1551 ); 1552 } 1553 1554 /** 1555 * Helper to check whether an item exists in a dropdown. 1556 * 1557 * @param string $item The text of the item to look for 1558 * @param string $dropdown The name of the dropdown 1559 * @param null|NodeElement $container The container to look within 1560 */ 1561 public function should_exist_in_dropdown_in( 1562 string $item, 1563 string $dropdown, 1564 null|NodeElement $container, 1565 bool $not, 1566 ): void { 1567 $dropdownnode = $this->find( 1568 selector: 'named_partial', 1569 locator: ['dropdown', $dropdown], 1570 node: $container ?? false, 1571 ); 1572 1573 if ($not) { 1574 try { 1575 $this->find( 1576 selector: 'named_partial', 1577 locator: ['dropdown_item', $item], 1578 node: $dropdownnode, 1579 ); 1580 1581 throw new ExpectationException( 1582 "The '{$item}' dropdown item was found in the '{$dropdown}' selector", 1583 $this->getSession(), 1584 ); 1585 } catch (ElementNotFoundException $e) { 1586 return; 1587 } 1588 } else { 1589 $this->find( 1590 selector: 'named_partial', 1591 locator: ['dropdown_item', $item], 1592 node: $dropdownnode, 1593 ); 1594 } 1595 } 1596 1597 /** 1598 * Close the block drawer if it is open. 1599 * 1600 * This is necessary as in Behat the block drawer is open at each page load (disregarding user's settings) 1601 * As the block drawer is positioned at the front of some contextual dialogs on the grade report for example. 1602 * @Given I close block drawer if open 1603 * @return void 1604 */ 1605 public function i_close_block_drawer_if_open() { 1606 if ($this->running_javascript()) { 1607 $xpath = "//button[contains(@data-action,'closedrawer')][contains(@data-placement,'left')]"; 1608 $node = $this->getSession()->getPage()->find('xpath', $xpath); 1609 if ($node && $node->isVisible()) { 1610 $ishidden = $node->getAttribute('aria-hidden-tab-index'); 1611 if (!$ishidden) { 1612 $this->execute('behat_general::i_click_on', [$node, 'NodeElement']); 1613 } 1614 } 1615 } 1616 } 1617 1618 /** 1619 * I close the block drawer and keep it closed. 1620 * 1621 * @Given I keep block drawer closed 1622 * @return void 1623 */ 1624 public function i_keep_block_drawer_closed() { 1625 set_user_preference('behat_keep_drawer_closed', 1); 1626 $this->i_close_block_drawer_if_open(); 1627 } 1628 }
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
