6951b15466c5e119564f7961a8eb39375da18b88
[moodle.git] / lib / tests / behat / behat_general.php
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/>.
17 /**
18  * General use 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  */
26 // NOTE: no MOODLE_INTERNAL test here, this file may be required by behat before including /config.php.
28 require_once(__DIR__ . '/../../behat/behat_base.php');
30 use Behat\Mink\Exception\ExpectationException as ExpectationException,
31     Behat\Mink\Exception\ElementNotFoundException as ElementNotFoundException,
32     Behat\Mink\Exception\DriverException as DriverException,
33     WebDriver\Exception\NoSuchElement as NoSuchElement,
34     WebDriver\Exception\StaleElementReference as StaleElementReference,
35     Behat\Gherkin\Node\TableNode as TableNode;
37 /**
38  * Cross component steps definitions.
39  *
40  * Basic web application definitions from MinkExtension and
41  * BehatchExtension. Definitions modified according to our needs
42  * when necessary and including only the ones we need to avoid
43  * overlapping and confusion.
44  *
45  * @package   core
46  * @category  test
47  * @copyright 2012 David MonllaĆ³
48  * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
49  */
50 class behat_general extends behat_base {
52     /**
53      * @var string used by {@link switch_to_window()} and
54      * {@link switch_to_the_main_window()} to work-around a Chrome browser issue.
55      */
56     const MAIN_WINDOW_NAME = '__moodle_behat_main_window_name';
58     /**
59      * @var string when we want to check whether or not a new page has loaded,
60      * we first write this unique string into the page. Then later, by checking
61      * whether it is still there, we can tell if a new page has been loaded.
62      */
63     const PAGE_LOAD_DETECTION_STRING = 'new_page_not_loaded_since_behat_started_watching';
65     /**
66      * @var $pageloaddetectionrunning boolean Used to ensure that page load detection was started before a page reload
67      * was checked for.
68      */
69     private $pageloaddetectionrunning = false;
71     /**
72      * Opens Moodle homepage.
73      *
74      * @Given /^I am on homepage$/
75      */
76     public function i_am_on_homepage() {
77         $this->getSession()->visit($this->locate_path('/'));
78     }
80     /**
81      * Opens Moodle site homepage.
82      *
83      * @Given /^I am on site homepage$/
84      */
85     public function i_am_on_site_homepage() {
86         $this->getSession()->visit($this->locate_path('/?redirect=0'));
87     }
89     /**
90      * Opens course index page.
91      *
92      * @Given /^I am on course index$/
93      */
94     public function i_am_on_course_index() {
95         $this->getSession()->visit($this->locate_path('/course/index.php'));
96     }
98     /**
99      * Reloads the current page.
100      *
101      * @Given /^I reload the page$/
102      */
103     public function reload() {
104         $this->getSession()->reload();
105     }
107     /**
108      * Follows the page redirection. Use this step after any action that shows a message and waits for a redirection
109      *
110      * @Given /^I wait to be redirected$/
111      */
112     public function i_wait_to_be_redirected() {
114         // Xpath and processes based on core_renderer::redirect_message(), core_renderer::$metarefreshtag and
115         // moodle_page::$periodicrefreshdelay possible values.
116         if (!$metarefresh = $this->getSession()->getPage()->find('xpath', "//head/descendant::meta[@http-equiv='refresh']")) {
117             // We don't fail the scenario if no redirection with message is found to avoid race condition false failures.
118             return true;
119         }
121         // Wrapped in try & catch in case the redirection has already been executed.
122         try {
123             $content = $metarefresh->getAttribute('content');
124         } catch (NoSuchElement $e) {
125             return true;
126         } catch (StaleElementReference $e) {
127             return true;
128         }
130         // Getting the refresh time and the url if present.
131         if (strstr($content, 'url') != false) {
133             list($waittime, $url) = explode(';', $content);
135             // Cleaning the URL value.
136             $url = trim(substr($url, strpos($url, 'http')));
138         } else {
139             // Just wait then.
140             $waittime = $content;
141         }
144         // Wait until the URL change is executed.
145         if ($this->running_javascript()) {
146             $this->getSession()->wait($waittime * 1000);
148         } else if (!empty($url)) {
149             // We redirect directly as we can not wait for an automatic redirection.
150             $this->getSession()->getDriver()->getClient()->request('get', $url);
152         } else {
153             // Reload the page if no URL was provided.
154             $this->getSession()->getDriver()->reload();
155         }
156     }
158     /**
159      * Switches to the specified iframe.
160      *
161      * @Given /^I switch to "(?P<iframe_name_string>(?:[^"]|\\")*)" iframe$/
162      * @param string $iframename
163      */
164     public function switch_to_iframe($iframename) {
166         // We spin to give time to the iframe to be loaded.
167         // Using extended timeout as we don't know about which
168         // kind of iframe will be loaded.
169         $this->spin(
170             function($context, $iframename) {
171                 $context->getSession()->switchToIFrame($iframename);
173                 // If no exception we are done.
174                 return true;
175             },
176             $iframename,
177             self::EXTENDED_TIMEOUT
178         );
179     }
181     /**
182      * Switches to the main Moodle frame.
183      *
184      * @Given /^I switch to the main frame$/
185      */
186     public function switch_to_the_main_frame() {
187         $this->getSession()->switchToIFrame();
188     }
190     /**
191      * Switches to the specified window. Useful when interacting with popup windows.
192      *
193      * @Given /^I switch to "(?P<window_name_string>(?:[^"]|\\")*)" window$/
194      * @param string $windowname
195      */
196     public function switch_to_window($windowname) {
197         // In Behat, some browsers (e.g. Chrome) are unable to switch to a
198         // window without a name, and by default the main browser window does
199         // not have a name. To work-around this, when we switch away from an
200         // unnamed window (presumably the main window) to some other named
201         // window, then we first set the main window name to a conventional
202         // value that we can later use this name to switch back.
203         $this->getSession()->executeScript(
204                 'if (window.name == "") window.name = "' . self::MAIN_WINDOW_NAME . '"');
206         $this->getSession()->switchToWindow($windowname);
207     }
209     /**
210      * Switches to the main Moodle window. Useful when you finish interacting with popup windows.
211      *
212      * @Given /^I switch to the main window$/
213      */
214     public function switch_to_the_main_window() {
215         $this->getSession()->switchToWindow(self::MAIN_WINDOW_NAME);
216     }
218     /**
219      * Accepts the currently displayed alert dialog. This step does not work in all the browsers, consider it experimental.
220      * @Given /^I accept the currently displayed dialog$/
221      */
222     public function accept_currently_displayed_alert_dialog() {
223         $this->getSession()->getDriver()->getWebDriverSession()->accept_alert();
224     }
226     /**
227      * Dismisses the currently displayed alert dialog. This step does not work in all the browsers, consider it experimental.
228      * @Given /^I dismiss the currently displayed dialog$/
229      */
230     public function dismiss_currently_displayed_alert_dialog() {
231         $this->getSession()->getDriver()->getWebDriverSession()->dismiss_alert();
232     }
234     /**
235      * Clicks link with specified id|title|alt|text.
236      *
237      * @When /^I follow "(?P<link_string>(?:[^"]|\\")*)"$/
238      * @throws ElementNotFoundException Thrown by behat_base::find
239      * @param string $link
240      */
241     public function click_link($link) {
243         $linknode = $this->find_link($link);
244         $this->ensure_node_is_visible($linknode);
245         $linknode->click();
246     }
248     /**
249      * Waits X seconds. Required after an action that requires data from an AJAX request.
250      *
251      * @Then /^I wait "(?P<seconds_number>\d+)" seconds$/
252      * @param int $seconds
253      */
254     public function i_wait_seconds($seconds) {
255         if ($this->running_javascript()) {
256             $this->getSession()->wait($seconds * 1000);
257         } else {
258             sleep($seconds);
259         }
260     }
262     /**
263      * Waits until the page is completely loaded. This step is auto-executed after every step.
264      *
265      * @Given /^I wait until the page is ready$/
266      */
267     public function wait_until_the_page_is_ready() {
269         // No need to wait if not running JS.
270         if (!$this->running_javascript()) {
271             return;
272         }
274         $this->getSession()->wait(self::TIMEOUT * 1000, self::PAGE_READY_JS);
275     }
277     /**
278      * Waits until the provided element selector exists in the DOM
279      *
280      * Using the protected method as this method will be usually
281      * called by other methods which are not returning a set of
282      * steps and performs the actions directly, so it would not
283      * be executed if it returns another step.
285      * @Given /^I wait until "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" exists$/
286      * @param string $element
287      * @param string $selector
288      * @return void
289      */
290     public function wait_until_exists($element, $selectortype) {
291         $this->ensure_element_exists($element, $selectortype);
292     }
294     /**
295      * Waits until the provided element does not exist in the DOM
296      *
297      * Using the protected method as this method will be usually
298      * called by other methods which are not returning a set of
299      * steps and performs the actions directly, so it would not
300      * be executed if it returns another step.
302      * @Given /^I wait until "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" does not exist$/
303      * @param string $element
304      * @param string $selector
305      * @return void
306      */
307     public function wait_until_does_not_exists($element, $selectortype) {
308         $this->ensure_element_does_not_exist($element, $selectortype);
309     }
311     /**
312      * Generic mouse over action. Mouse over a element of the specified type.
313      *
314      * @When /^I hover "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)"$/
315      * @param string $element Element we look for
316      * @param string $selectortype The type of what we look for
317      */
318     public function i_hover($element, $selectortype) {
320         // Gets the node based on the requested selector type and locator.
321         $node = $this->get_selected_node($selectortype, $element);
322         $node->mouseOver();
323     }
325     /**
326      * Generic click action. Click on the element of the specified type.
327      *
328      * @When /^I click on "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)"$/
329      * @param string $element Element we look for
330      * @param string $selectortype The type of what we look for
331      */
332     public function i_click_on($element, $selectortype) {
334         // Gets the node based on the requested selector type and locator.
335         $node = $this->get_selected_node($selectortype, $element);
336         $this->ensure_node_is_visible($node);
337         $node->click();
338     }
340     /**
341      * Sets the focus and takes away the focus from an element, generating blur JS event.
342      *
343      * @When /^I take focus off "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)"$/
344      * @param string $element Element we look for
345      * @param string $selectortype The type of what we look for
346      */
347     public function i_take_focus_off_field($element, $selectortype) {
348         if (!$this->running_javascript()) {
349             throw new ExpectationException('Can\'t take focus off from "' . $element . '" in non-js mode', $this->getSession());
350         }
351         // Gets the node based on the requested selector type and locator.
352         $node = $this->get_selected_node($selectortype, $element);
353         $this->ensure_node_is_visible($node);
355         // Ensure element is focused before taking it off.
356         $node->focus();
357         $node->blur();
358     }
360     /**
361      * Clicks the specified element and confirms the expected dialogue.
362      *
363      * @When /^I click on "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" confirming the dialogue$/
364      * @throws ElementNotFoundException Thrown by behat_base::find
365      * @param string $element Element we look for
366      * @param string $selectortype The type of what we look for
367      */
368     public function i_click_on_confirming_the_dialogue($element, $selectortype) {
369         $this->i_click_on($element, $selectortype);
370         $this->accept_currently_displayed_alert_dialog();
371     }
373     /**
374      * Clicks the specified element and dismissing the expected dialogue.
375      *
376      * @When /^I click on "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" dismissing the dialogue$/
377      * @throws ElementNotFoundException Thrown by behat_base::find
378      * @param string $element Element we look for
379      * @param string $selectortype The type of what we look for
380      */
381     public function i_click_on_dismissing_the_dialogue($element, $selectortype) {
382         $this->i_click_on($element, $selectortype);
383         $this->dismiss_currently_displayed_alert_dialog();
384     }
386     /**
387      * Click on the element of the specified type which is located inside the second element.
388      *
389      * @When /^I click on "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" in the "(?P<element_container_string>(?:[^"]|\\")*)" "(?P<text_selector_string>[^"]*)"$/
390      * @param string $element Element we look for
391      * @param string $selectortype The type of what we look for
392      * @param string $nodeelement Element we look in
393      * @param string $nodeselectortype The type of selector where we look in
394      */
395     public function i_click_on_in_the($element, $selectortype, $nodeelement, $nodeselectortype) {
397         $node = $this->get_node_in_container($selectortype, $element, $nodeselectortype, $nodeelement);
398         $this->ensure_node_is_visible($node);
399         $node->click();
400     }
402     /**
403      * Drags and drops the specified element to the specified container. This step does not work in all the browsers, consider it experimental.
404      *
405      * The steps definitions calling this step as part of them should
406      * manage the wait times by themselves as the times and when the
407      * waits should be done depends on what is being dragged & dropper.
408      *
409      * @Given /^I drag "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector1_string>(?:[^"]|\\")*)" and I drop it in "(?P<container_element_string>(?:[^"]|\\")*)" "(?P<selector2_string>(?:[^"]|\\")*)"$/
410      * @param string $element
411      * @param string $selectortype
412      * @param string $containerelement
413      * @param string $containerselectortype
414      */
415     public function i_drag_and_i_drop_it_in($element, $selectortype, $containerelement, $containerselectortype) {
417         list($sourceselector, $sourcelocator) = $this->transform_selector($selectortype, $element);
418         $sourcexpath = $this->getSession()->getSelectorsHandler()->selectorToXpath($sourceselector, $sourcelocator);
420         list($containerselector, $containerlocator) = $this->transform_selector($containerselectortype, $containerelement);
421         $destinationxpath = $this->getSession()->getSelectorsHandler()->selectorToXpath($containerselector, $containerlocator);
423         $node = $this->get_selected_node("xpath_element", $sourcexpath);
424         if (!$node->isVisible()) {
425             throw new ExpectationException('"' . $sourcexpath . '" "xpath_element" is not visible', $this->getSession());
426         }
427         $node = $this->get_selected_node("xpath_element", $destinationxpath);
428         if (!$node->isVisible()) {
429             throw new ExpectationException('"' . $destinationxpath . '" "xpath_element" is not visible', $this->getSession());
430         }
432         $this->getSession()->getDriver()->dragTo($sourcexpath, $destinationxpath);
433     }
435     /**
436      * Checks, that the specified element is visible. Only available in tests using Javascript.
437      *
438      * @Then /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>(?:[^"]|\\")*)" should be visible$/
439      * @throws ElementNotFoundException
440      * @throws ExpectationException
441      * @throws DriverException
442      * @param string $element
443      * @param string $selectortype
444      * @return void
445      */
446     public function should_be_visible($element, $selectortype) {
448         if (!$this->running_javascript()) {
449             throw new DriverException('Visible checks are disabled in scenarios without Javascript support');
450         }
452         $node = $this->get_selected_node($selectortype, $element);
453         if (!$node->isVisible()) {
454             throw new ExpectationException('"' . $element . '" "' . $selectortype . '" is not visible', $this->getSession());
455         }
456     }
458     /**
459      * Checks, that the existing element is not visible. Only available in tests using Javascript.
460      *
461      * As a "not" method, it's performance could not be good, but in this
462      * case the performance is good because the element must exist,
463      * otherwise there would be a ElementNotFoundException, also here we are
464      * not spinning until the element is visible.
465      *
466      * @Then /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>(?:[^"]|\\")*)" should not be visible$/
467      * @throws ElementNotFoundException
468      * @throws ExpectationException
469      * @param string $element
470      * @param string $selectortype
471      * @return void
472      */
473     public function should_not_be_visible($element, $selectortype) {
475         try {
476             $this->should_be_visible($element, $selectortype);
477         } catch (ExpectationException $e) {
478             // All as expected.
479             return;
480         }
481         throw new ExpectationException('"' . $element . '" "' . $selectortype . '" is visible', $this->getSession());
482     }
484     /**
485      * Checks, that the specified element is visible inside the specified container. Only available in tests using Javascript.
486      *
487      * @Then /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" in the "(?P<element_container_string>(?:[^"]|\\")*)" "(?P<text_selector_string>[^"]*)" should be visible$/
488      * @throws ElementNotFoundException
489      * @throws DriverException
490      * @throws ExpectationException
491      * @param string $element Element we look for
492      * @param string $selectortype The type of what we look for
493      * @param string $nodeelement Element we look in
494      * @param string $nodeselectortype The type of selector where we look in
495      */
496     public function in_the_should_be_visible($element, $selectortype, $nodeelement, $nodeselectortype) {
498         if (!$this->running_javascript()) {
499             throw new DriverException('Visible checks are disabled in scenarios without Javascript support');
500         }
502         $node = $this->get_node_in_container($selectortype, $element, $nodeselectortype, $nodeelement);
503         if (!$node->isVisible()) {
504             throw new ExpectationException(
505                 '"' . $element . '" "' . $selectortype . '" in the "' . $nodeelement . '" "' . $nodeselectortype . '" is not visible',
506                 $this->getSession()
507             );
508         }
509     }
511     /**
512      * Checks, that the existing element is not visible inside the existing container. Only available in tests using Javascript.
513      *
514      * As a "not" method, it's performance could not be good, but in this
515      * case the performance is good because the element must exist,
516      * otherwise there would be a ElementNotFoundException, also here we are
517      * not spinning until the element is visible.
518      *
519      * @Then /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" in the "(?P<element_container_string>(?:[^"]|\\")*)" "(?P<text_selector_string>[^"]*)" should not be visible$/
520      * @throws ElementNotFoundException
521      * @throws ExpectationException
522      * @param string $element Element we look for
523      * @param string $selectortype The type of what we look for
524      * @param string $nodeelement Element we look in
525      * @param string $nodeselectortype The type of selector where we look in
526      */
527     public function in_the_should_not_be_visible($element, $selectortype, $nodeelement, $nodeselectortype) {
529         try {
530             $this->in_the_should_be_visible($element, $selectortype, $nodeelement, $nodeselectortype);
531         } catch (ExpectationException $e) {
532             // All as expected.
533             return;
534         }
535         throw new ExpectationException(
536             '"' . $element . '" "' . $selectortype . '" in the "' . $nodeelement . '" "' . $nodeselectortype . '" is visible',
537             $this->getSession()
538         );
539     }
541     /**
542      * Checks, that page contains specified text. It also checks if the text is visible when running Javascript tests.
543      *
544      * @Then /^I should see "(?P<text_string>(?:[^"]|\\")*)"$/
545      * @throws ExpectationException
546      * @param string $text
547      */
548     public function assert_page_contains_text($text) {
550         // Looking for all the matching nodes without any other descendant matching the
551         // same xpath (we are using contains(., ....).
552         $xpathliteral = behat_context_helper::escape($text);
553         $xpath = "/descendant-or-self::*[contains(., $xpathliteral)]" .
554             "[count(descendant::*[contains(., $xpathliteral)]) = 0]";
556         try {
557             $nodes = $this->find_all('xpath', $xpath);
558         } catch (ElementNotFoundException $e) {
559             throw new ExpectationException('"' . $text . '" text was not found in the page', $this->getSession());
560         }
562         // If we are not running javascript we have enough with the
563         // element existing as we can't check if it is visible.
564         if (!$this->running_javascript()) {
565             return;
566         }
568         // We spin as we don't have enough checking that the element is there, we
569         // should also ensure that the element is visible. Using microsleep as this
570         // is a repeated step and global performance is important.
571         $this->spin(
572             function($context, $args) {
574                 foreach ($args['nodes'] as $node) {
575                     if ($node->isVisible()) {
576                         return true;
577                     }
578                 }
580                 // If non of the nodes is visible we loop again.
581                 throw new ExpectationException('"' . $args['text'] . '" text was found but was not visible', $context->getSession());
582             },
583             array('nodes' => $nodes, 'text' => $text),
584             false,
585             false,
586             true
587         );
589     }
591     /**
592      * Checks, that page doesn't contain specified text. When running Javascript tests it also considers that texts may be hidden.
593      *
594      * @Then /^I should not see "(?P<text_string>(?:[^"]|\\")*)"$/
595      * @throws ExpectationException
596      * @param string $text
597      */
598     public function assert_page_not_contains_text($text) {
600         // Looking for all the matching nodes without any other descendant matching the
601         // same xpath (we are using contains(., ....).
602         $xpathliteral = behat_context_helper::escape($text);
603         $xpath = "/descendant-or-self::*[contains(., $xpathliteral)]" .
604             "[count(descendant::*[contains(., $xpathliteral)]) = 0]";
606         // We should wait a while to ensure that the page is not still loading elements.
607         // Waiting less than self::TIMEOUT as we already waited for the DOM to be ready and
608         // all JS to be executed.
609         try {
610             $nodes = $this->find_all('xpath', $xpath, false, false, self::REDUCED_TIMEOUT);
611         } catch (ElementNotFoundException $e) {
612             // All ok.
613             return;
614         }
616         // If we are not running javascript we have enough with the
617         // element existing as we can't check if it is hidden.
618         if (!$this->running_javascript()) {
619             throw new ExpectationException('"' . $text . '" text was found in the page', $this->getSession());
620         }
622         // If the element is there we should be sure that it is not visible.
623         $this->spin(
624             function($context, $args) {
626                 foreach ($args['nodes'] as $node) {
627                     // If element is removed from dom, then just exit.
628                     try {
629                         // If element is visible then throw exception, so we keep spinning.
630                         if ($node->isVisible()) {
631                             throw new ExpectationException('"' . $args['text'] . '" text was found in the page',
632                                 $context->getSession());
633                         }
634                     } catch (WebDriver\Exception\NoSuchElement $e) {
635                         // Do nothing just return, as element is no more on page.
636                         return true;
637                     } catch (ElementNotFoundException $e) {
638                         // Do nothing just return, as element is no more on page.
639                         return true;
640                     }
641                 }
643                 // If non of the found nodes is visible we consider that the text is not visible.
644                 return true;
645             },
646             array('nodes' => $nodes, 'text' => $text),
647             self::REDUCED_TIMEOUT,
648             false,
649             true
650         );
651     }
653     /**
654      * Checks, that the specified element contains the specified text. When running Javascript tests it also considers that texts may be hidden.
655      *
656      * @Then /^I should see "(?P<text_string>(?:[^"]|\\")*)" in the "(?P<element_string>(?:[^"]|\\")*)" "(?P<text_selector_string>[^"]*)"$/
657      * @throws ElementNotFoundException
658      * @throws ExpectationException
659      * @param string $text
660      * @param string $element Element we look in.
661      * @param string $selectortype The type of element where we are looking in.
662      */
663     public function assert_element_contains_text($text, $element, $selectortype) {
665         // Getting the container where the text should be found.
666         $container = $this->get_selected_node($selectortype, $element);
668         // Looking for all the matching nodes without any other descendant matching the
669         // same xpath (we are using contains(., ....).
670         $xpathliteral = behat_context_helper::escape($text);
671         $xpath = "/descendant-or-self::*[contains(., $xpathliteral)]" .
672             "[count(descendant::*[contains(., $xpathliteral)]) = 0]";
674         // Wait until it finds the text inside the container, otherwise custom exception.
675         try {
676             $nodes = $this->find_all('xpath', $xpath, false, $container);
677         } catch (ElementNotFoundException $e) {
678             throw new ExpectationException('"' . $text . '" text was not found in the "' . $element . '" element', $this->getSession());
679         }
681         // If we are not running javascript we have enough with the
682         // element existing as we can't check if it is visible.
683         if (!$this->running_javascript()) {
684             return;
685         }
687         // We also check the element visibility when running JS tests. Using microsleep as this
688         // is a repeated step and global performance is important.
689         $this->spin(
690             function($context, $args) {
692                 foreach ($args['nodes'] as $node) {
693                     if ($node->isVisible()) {
694                         return true;
695                     }
696                 }
698                 throw new ExpectationException('"' . $args['text'] . '" text was found in the "' . $args['element'] . '" element but was not visible', $context->getSession());
699             },
700             array('nodes' => $nodes, 'text' => $text, 'element' => $element),
701             false,
702             false,
703             true
704         );
705     }
707     /**
708      * Checks, that the specified element does not contain the specified text. When running Javascript tests it also considers that texts may be hidden.
709      *
710      * @Then /^I should not see "(?P<text_string>(?:[^"]|\\")*)" in the "(?P<element_string>(?:[^"]|\\")*)" "(?P<text_selector_string>[^"]*)"$/
711      * @throws ElementNotFoundException
712      * @throws ExpectationException
713      * @param string $text
714      * @param string $element Element we look in.
715      * @param string $selectortype The type of element where we are looking in.
716      */
717     public function assert_element_not_contains_text($text, $element, $selectortype) {
719         // Getting the container where the text should be found.
720         $container = $this->get_selected_node($selectortype, $element);
722         // Looking for all the matching nodes without any other descendant matching the
723         // same xpath (we are using contains(., ....).
724         $xpathliteral = behat_context_helper::escape($text);
725         $xpath = "/descendant-or-self::*[contains(., $xpathliteral)]" .
726             "[count(descendant::*[contains(., $xpathliteral)]) = 0]";
728         // We should wait a while to ensure that the page is not still loading elements.
729         // Giving preference to the reliability of the results rather than to the performance.
730         try {
731             $nodes = $this->find_all('xpath', $xpath, false, $container, self::REDUCED_TIMEOUT);
732         } catch (ElementNotFoundException $e) {
733             // All ok.
734             return;
735         }
737         // If we are not running javascript we have enough with the
738         // element not being found as we can't check if it is visible.
739         if (!$this->running_javascript()) {
740             throw new ExpectationException('"' . $text . '" text was found in the "' . $element . '" element', $this->getSession());
741         }
743         // We need to ensure all the found nodes are hidden.
744         $this->spin(
745             function($context, $args) {
747                 foreach ($args['nodes'] as $node) {
748                     if ($node->isVisible()) {
749                         throw new ExpectationException('"' . $args['text'] . '" text was found in the "' . $args['element'] . '" element', $context->getSession());
750                     }
751                 }
753                 // If all the found nodes are hidden we are happy.
754                 return true;
755             },
756             array('nodes' => $nodes, 'text' => $text, 'element' => $element),
757             self::REDUCED_TIMEOUT,
758             false,
759             true
760         );
761     }
763     /**
764      * Checks, that the first specified element appears before the second one.
765      *
766      * @Given /^"(?P<preceding_element_string>(?:[^"]|\\")*)" "(?P<selector1_string>(?:[^"]|\\")*)" should appear before "(?P<following_element_string>(?:[^"]|\\")*)" "(?P<selector2_string>(?:[^"]|\\")*)"$/
767      * @throws ExpectationException
768      * @param string $preelement The locator of the preceding element
769      * @param string $preselectortype The locator of the preceding element
770      * @param string $postelement The locator of the latest element
771      * @param string $postselectortype The selector type of the latest element
772      */
773     public function should_appear_before($preelement, $preselectortype, $postelement, $postselectortype) {
775         // We allow postselectortype as a non-text based selector.
776         list($preselector, $prelocator) = $this->transform_selector($preselectortype, $preelement);
777         list($postselector, $postlocator) = $this->transform_selector($postselectortype, $postelement);
779         $prexpath = $this->find($preselector, $prelocator)->getXpath();
780         $postxpath = $this->find($postselector, $postlocator)->getXpath();
782         // Using following xpath axe to find it.
783         $msg = '"'.$preelement.'" "'.$preselectortype.'" does not appear before "'.$postelement.'" "'.$postselectortype.'"';
784         $xpath = $prexpath.'/following::*[contains(., '.$postxpath.')]';
785         if (!$this->getSession()->getDriver()->find($xpath)) {
786             throw new ExpectationException($msg, $this->getSession());
787         }
788     }
790     /**
791      * Checks, that the first specified element appears after the second one.
792      *
793      * @Given /^"(?P<following_element_string>(?:[^"]|\\")*)" "(?P<selector1_string>(?:[^"]|\\")*)" should appear after "(?P<preceding_element_string>(?:[^"]|\\")*)" "(?P<selector2_string>(?:[^"]|\\")*)"$/
794      * @throws ExpectationException
795      * @param string $postelement The locator of the latest element
796      * @param string $postselectortype The selector type of the latest element
797      * @param string $preelement The locator of the preceding element
798      * @param string $preselectortype The locator of the preceding element
799      */
800     public function should_appear_after($postelement, $postselectortype, $preelement, $preselectortype) {
802         // We allow postselectortype as a non-text based selector.
803         list($postselector, $postlocator) = $this->transform_selector($postselectortype, $postelement);
804         list($preselector, $prelocator) = $this->transform_selector($preselectortype, $preelement);
806         $postxpath = $this->find($postselector, $postlocator)->getXpath();
807         $prexpath = $this->find($preselector, $prelocator)->getXpath();
809         // Using preceding xpath axe to find it.
810         $msg = '"'.$postelement.'" "'.$postselectortype.'" does not appear after "'.$preelement.'" "'.$preselectortype.'"';
811         $xpath = $postxpath.'/preceding::*[contains(., '.$prexpath.')]';
812         if (!$this->getSession()->getDriver()->find($xpath)) {
813             throw new ExpectationException($msg, $this->getSession());
814         }
815     }
817     /**
818      * Checks, that element of specified type is disabled.
819      *
820      * @Then /^the "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should be disabled$/
821      * @throws ExpectationException Thrown by behat_base::find
822      * @param string $element Element we look in
823      * @param string $selectortype The type of element where we are looking in.
824      */
825     public function the_element_should_be_disabled($element, $selectortype) {
827         // Transforming from steps definitions selector/locator format to Mink format and getting the NodeElement.
828         $node = $this->get_selected_node($selectortype, $element);
830         if (!$node->hasAttribute('disabled')) {
831             throw new ExpectationException('The element "' . $element . '" is not disabled', $this->getSession());
832         }
833     }
835     /**
836      * Checks, that element of specified type is enabled.
837      *
838      * @Then /^the "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should be enabled$/
839      * @throws ExpectationException Thrown by behat_base::find
840      * @param string $element Element we look on
841      * @param string $selectortype The type of where we look
842      */
843     public function the_element_should_be_enabled($element, $selectortype) {
845         // Transforming from steps definitions selector/locator format to mink format and getting the NodeElement.
846         $node = $this->get_selected_node($selectortype, $element);
848         if ($node->hasAttribute('disabled')) {
849             throw new ExpectationException('The element "' . $element . '" is not enabled', $this->getSession());
850         }
851     }
853     /**
854      * Checks the provided element and selector type are readonly on the current page.
855      *
856      * @Then /^the "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should be readonly$/
857      * @throws ExpectationException Thrown by behat_base::find
858      * @param string $element Element we look in
859      * @param string $selectortype The type of element where we are looking in.
860      */
861     public function the_element_should_be_readonly($element, $selectortype) {
862         // Transforming from steps definitions selector/locator format to Mink format and getting the NodeElement.
863         $node = $this->get_selected_node($selectortype, $element);
865         if (!$node->hasAttribute('readonly')) {
866             throw new ExpectationException('The element "' . $element . '" is not readonly', $this->getSession());
867         }
868     }
870     /**
871      * Checks the provided element and selector type are not readonly on the current page.
872      *
873      * @Then /^the "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should not be readonly$/
874      * @throws ExpectationException Thrown by behat_base::find
875      * @param string $element Element we look in
876      * @param string $selectortype The type of element where we are looking in.
877      */
878     public function the_element_should_not_be_readonly($element, $selectortype) {
879         // Transforming from steps definitions selector/locator format to Mink format and getting the NodeElement.
880         $node = $this->get_selected_node($selectortype, $element);
882         if ($node->hasAttribute('readonly')) {
883             throw new ExpectationException('The element "' . $element . '" is readonly', $this->getSession());
884         }
885     }
887     /**
888      * Checks the provided element and selector type exists in the current page.
889      *
890      * This step is for advanced users, use it if you don't find anything else suitable for what you need.
891      *
892      * @Then /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should exist$/
893      * @throws ElementNotFoundException Thrown by behat_base::find
894      * @param string $element The locator of the specified selector
895      * @param string $selectortype The selector type
896      */
897     public function should_exist($element, $selectortype) {
899         // Getting Mink selector and locator.
900         list($selector, $locator) = $this->transform_selector($selectortype, $element);
902         // Will throw an ElementNotFoundException if it does not exist.
903         $this->find($selector, $locator);
904     }
906     /**
907      * Checks that the provided element and selector type not exists in the current page.
908      *
909      * This step is for advanced users, use it if you don't find anything else suitable for what you need.
910      *
911      * @Then /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should not exist$/
912      * @throws ExpectationException
913      * @param string $element The locator of the specified selector
914      * @param string $selectortype The selector type
915      */
916     public function should_not_exist($element, $selectortype) {
918         // Getting Mink selector and locator.
919         list($selector, $locator) = $this->transform_selector($selectortype, $element);
921         try {
923             // Using directly the spin method as we want a reduced timeout but there is no
924             // need for a 0.1 seconds interval because in the optimistic case we will timeout.
925             $params = array('selector' => $selector, 'locator' => $locator);
926             // The exception does not really matter as we will catch it and will never "explode".
927             $exception = new ElementNotFoundException($this->getSession(), $selectortype, null, $element);
929             // If all goes good it will throw an ElementNotFoundExceptionn that we will catch.
930             $this->spin(
931                 function($context, $args) {
932                     return $context->getSession()->getPage()->findAll($args['selector'], $args['locator']);
933                 },
934                 $params,
935                 self::REDUCED_TIMEOUT,
936                 $exception,
937                 false
938             );
939         } catch (ElementNotFoundException $e) {
940             // It passes.
941             return;
942         }
944         throw new ExpectationException('The "' . $element . '" "' . $selectortype .
945                 '" exists in the current page', $this->getSession());
946     }
948     /**
949      * This step triggers cron like a user would do going to admin/cron.php.
950      *
951      * @Given /^I trigger cron$/
952      */
953     public function i_trigger_cron() {
954         $this->getSession()->visit($this->locate_path('/admin/cron.php'));
955     }
957     /**
958      * Runs a scheduled task immediately, given full class name.
959      *
960      * This is faster and more reliable than running cron (running cron won't
961      * work more than once in the same test, for instance). However it is
962      * a little less 'realistic'.
963      *
964      * While the task is running, we suppress mtrace output because it makes
965      * the Behat result look ugly.
966      *
967      * Note: Most of the code relating to running a task is based on
968      * admin/tool/task/cli/schedule_task.php.
969      *
970      * @Given /^I run the scheduled task "(?P<task_name>[^"]+)"$/
971      * @param string $taskname Name of task e.g. 'mod_whatever\task\do_something'
972      */
973     public function i_run_the_scheduled_task($taskname) {
974         $task = \core\task\manager::get_scheduled_task($taskname);
975         if (!$task) {
976             throw new DriverException('The "' . $taskname . '" scheduled task does not exist');
977         }
979         // Do setup for cron task.
980         raise_memory_limit(MEMORY_EXTRA);
981         cron_setup_user();
983         // Get lock.
984         $cronlockfactory = \core\lock\lock_config::get_lock_factory('cron');
985         if (!$cronlock = $cronlockfactory->get_lock('core_cron', 10)) {
986             throw new DriverException('Unable to obtain core_cron lock for scheduled task');
987         }
988         if (!$lock = $cronlockfactory->get_lock('\\' . get_class($task), 10)) {
989             $cronlock->release();
990             throw new DriverException('Unable to obtain task lock for scheduled task');
991         }
992         $task->set_lock($lock);
993         if (!$task->is_blocking()) {
994             $cronlock->release();
995         } else {
996             $task->set_cron_lock($cronlock);
997         }
999         try {
1000             // Discard task output as not appropriate for Behat output!
1001             ob_start();
1002             $task->execute();
1003             ob_end_clean();
1005             // Mark task complete.
1006             \core\task\manager::scheduled_task_complete($task);
1007         } catch (Exception $e) {
1008             // Mark task failed and throw exception.
1009             \core\task\manager::scheduled_task_failed($task);
1010             throw new DriverException('The "' . $taskname . '" scheduled task failed', 0, $e);
1011         }
1012     }
1014     /**
1015      * Runs all ad-hoc tasks in the queue.
1016      *
1017      * This is faster and more reliable than running cron (running cron won't
1018      * work more than once in the same test, for instance). However it is
1019      * a little less 'realistic'.
1020      *
1021      * While the task is running, we suppress mtrace output because it makes
1022      * the Behat result look ugly.
1023      *
1024      * @Given /^I run all adhoc tasks$/
1025      * @throws DriverException
1026      */
1027     public function i_run_all_adhoc_tasks() {
1028         // Do setup for cron task.
1029         cron_setup_user();
1031         // Run tasks. Locking is handled by get_next_adhoc_task.
1032         $now = time();
1033         ob_start(); // Discard task output as not appropriate for Behat output!
1034         while (($task = \core\task\manager::get_next_adhoc_task($now)) !== null) {
1036             try {
1037                 $task->execute();
1039                 // Mark task complete.
1040                 \core\task\manager::adhoc_task_complete($task);
1041             } catch (Exception $e) {
1042                 // Mark task failed and throw exception.
1043                 \core\task\manager::adhoc_task_failed($task);
1044                 ob_end_clean();
1045                 throw new DriverException('An adhoc task failed', 0, $e);
1046             }
1047         }
1048         ob_end_clean();
1049     }
1051     /**
1052      * Checks that an element and selector type exists in another element and selector type on the current page.
1053      *
1054      * This step is for advanced users, use it if you don't find anything else suitable for what you need.
1055      *
1056      * @Then /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should exist in the "(?P<element2_string>(?:[^"]|\\")*)" "(?P<selector2_string>[^"]*)"$/
1057      * @throws ElementNotFoundException Thrown by behat_base::find
1058      * @param string $element The locator of the specified selector
1059      * @param string $selectortype The selector type
1060      * @param string $containerelement The container selector type
1061      * @param string $containerselectortype The container locator
1062      */
1063     public function should_exist_in_the($element, $selectortype, $containerelement, $containerselectortype) {
1064         // Get the container node.
1065         $containernode = $this->get_selected_node($containerselectortype, $containerelement);
1067         list($selector, $locator) = $this->transform_selector($selectortype, $element);
1069         // Specific exception giving info about where can't we find the element.
1070         $locatorexceptionmsg = $element . '" in the "' . $containerelement. '" "' . $containerselectortype. '"';
1071         $exception = new ElementNotFoundException($this->getSession(), $selectortype, null, $locatorexceptionmsg);
1073         // Looks for the requested node inside the container node.
1074         $this->find($selector, $locator, $exception, $containernode);
1075     }
1077     /**
1078      * Checks that an element and selector type does not exist in another element and selector type on the current page.
1079      *
1080      * This step is for advanced users, use it if you don't find anything else suitable for what you need.
1081      *
1082      * @Then /^"(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should not exist in the "(?P<element2_string>(?:[^"]|\\")*)" "(?P<selector2_string>[^"]*)"$/
1083      * @throws ExpectationException
1084      * @param string $element The locator of the specified selector
1085      * @param string $selectortype The selector type
1086      * @param string $containerelement The container selector type
1087      * @param string $containerselectortype The container locator
1088      */
1089     public function should_not_exist_in_the($element, $selectortype, $containerelement, $containerselectortype) {
1091         // Get the container node; here we throw an exception
1092         // if the container node does not exist.
1093         $containernode = $this->get_selected_node($containerselectortype, $containerelement);
1095         list($selector, $locator) = $this->transform_selector($selectortype, $element);
1097         // Will throw an ElementNotFoundException if it does not exist, but, actually
1098         // it should not exist, so we try & catch it.
1099         try {
1100             // Would be better to use a 1 second sleep because the element should not be there,
1101             // but we would need to duplicate the whole find_all() logic to do it, the benefit of
1102             // changing to 1 second sleep is not significant.
1103             $this->find($selector, $locator, false, $containernode, self::REDUCED_TIMEOUT);
1104         } catch (ElementNotFoundException $e) {
1105             // It passes.
1106             return;
1107         }
1108         throw new ExpectationException('The "' . $element . '" "' . $selectortype . '" exists in the "' .
1109                 $containerelement . '" "' . $containerselectortype . '"', $this->getSession());
1110     }
1112     /**
1113      * Change browser window size small: 640x480, medium: 1024x768, large: 2560x1600, custom: widthxheight
1114      *
1115      * Example: I change window size to "small" or I change window size to "1024x768"
1116      * or I change viewport size to "800x600". The viewport option is useful to guarantee that the
1117      * browser window has same viewport size even when you run Behat on multiple operating systems.
1118      *
1119      * @throws ExpectationException
1120      * @Then /^I change (window|viewport) size to "(small|medium|large|\d+x\d+)"$/
1121      * @param string $windowsize size of the window (small|medium|large|wxh).
1122      */
1123     public function i_change_window_size_to($windowviewport, $windowsize) {
1124         $this->resize_window($windowsize, $windowviewport === 'viewport');
1125     }
1127     /**
1128      * Checks whether there is an attribute on the given element that contains the specified text.
1129      *
1130      * @Then /^the "(?P<attribute_string>[^"]*)" attribute of "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should contain "(?P<text_string>(?:[^"]|\\")*)"$/
1131      * @throws ExpectationException
1132      * @param string $attribute Name of attribute
1133      * @param string $element The locator of the specified selector
1134      * @param string $selectortype The selector type
1135      * @param string $text Expected substring
1136      */
1137     public function the_attribute_of_should_contain($attribute, $element, $selectortype, $text) {
1138         // Get the container node (exception if it doesn't exist).
1139         $containernode = $this->get_selected_node($selectortype, $element);
1140         $value = $containernode->getAttribute($attribute);
1141         if ($value == null) {
1142             throw new ExpectationException('The attribute "' . $attribute. '" does not exist',
1143                     $this->getSession());
1144         } else if (strpos($value, $text) === false) {
1145             throw new ExpectationException('The attribute "' . $attribute .
1146                     '" does not contain "' . $text . '" (actual value: "' . $value . '")',
1147                     $this->getSession());
1148         }
1149     }
1151     /**
1152      * Checks that the attribute on the given element does not contain the specified text.
1153      *
1154      * @Then /^the "(?P<attribute_string>[^"]*)" attribute of "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" should not contain "(?P<text_string>(?:[^"]|\\")*)"$/
1155      * @throws ExpectationException
1156      * @param string $attribute Name of attribute
1157      * @param string $element The locator of the specified selector
1158      * @param string $selectortype The selector type
1159      * @param string $text Expected substring
1160      */
1161     public function the_attribute_of_should_not_contain($attribute, $element, $selectortype, $text) {
1162         // Get the container node (exception if it doesn't exist).
1163         $containernode = $this->get_selected_node($selectortype, $element);
1164         $value = $containernode->getAttribute($attribute);
1165         if ($value == null) {
1166             throw new ExpectationException('The attribute "' . $attribute. '" does not exist',
1167                     $this->getSession());
1168         } else if (strpos($value, $text) !== false) {
1169             throw new ExpectationException('The attribute "' . $attribute .
1170                     '" contains "' . $text . '" (value: "' . $value . '")',
1171                     $this->getSession());
1172         }
1173     }
1175     /**
1176      * Checks the provided value exists in specific row/column of table.
1177      *
1178      * @Then /^"(?P<row_string>[^"]*)" row "(?P<column_string>[^"]*)" column of "(?P<table_string>[^"]*)" table should contain "(?P<value_string>[^"]*)"$/
1179      * @throws ElementNotFoundException
1180      * @param string $row row text which will be looked in.
1181      * @param string $column column text to search (or numeric value for the column position)
1182      * @param string $table table id/class/caption
1183      * @param string $value text to check.
1184      */
1185     public function row_column_of_table_should_contain($row, $column, $table, $value) {
1186         $tablenode = $this->get_selected_node('table', $table);
1187         $tablexpath = $tablenode->getXpath();
1189         $rowliteral = behat_context_helper::escape($row);
1190         $valueliteral = behat_context_helper::escape($value);
1191         $columnliteral = behat_context_helper::escape($column);
1193         if (preg_match('/^-?(\d+)-?$/', $column, $columnasnumber)) {
1194             // Column indicated as a number, just use it as position of the column.
1195             $columnpositionxpath = "/child::*[position() = {$columnasnumber[1]}]";
1196         } else {
1197             // Header can be in thead or tbody (first row), following xpath should work.
1198             $theadheaderxpath = "thead/tr[1]/th[(normalize-space(.)=" . $columnliteral . " or a[normalize-space(text())=" .
1199                     $columnliteral . "] or div[normalize-space(text())=" . $columnliteral . "])]";
1200             $tbodyheaderxpath = "tbody/tr[1]/td[(normalize-space(.)=" . $columnliteral . " or a[normalize-space(text())=" .
1201                     $columnliteral . "] or div[normalize-space(text())=" . $columnliteral . "])]";
1203             // Check if column exists.
1204             $columnheaderxpath = $tablexpath . "[" . $theadheaderxpath . " | " . $tbodyheaderxpath . "]";
1205             $columnheader = $this->getSession()->getDriver()->find($columnheaderxpath);
1206             if (empty($columnheader)) {
1207                 $columnexceptionmsg = $column . '" in table "' . $table . '"';
1208                 throw new ElementNotFoundException($this->getSession(), "\n$columnheaderxpath\n\n".'Column', null, $columnexceptionmsg);
1209             }
1210             // Following conditions were considered before finding column count.
1211             // 1. Table header can be in thead/tr/th or tbody/tr/td[1].
1212             // 2. First column can have th (Gradebook -> user report), so having lenient sibling check.
1213             $columnpositionxpath = "/child::*[position() = count(" . $tablexpath . "/" . $theadheaderxpath .
1214                 "/preceding-sibling::*) + 1]";
1215         }
1217         // Check if value exists in specific row/column.
1218         // Get row xpath.
1219         // GoutteDriver uses DomCrawler\Crawler and it is making XPath relative to the current context, so use descendant.
1220         $rowxpath = $tablexpath."/tbody/tr[descendant::th[normalize-space(.)=" . $rowliteral .
1221                     "] | descendant::td[normalize-space(.)=" . $rowliteral . "]]";
1223         $columnvaluexpath = $rowxpath . $columnpositionxpath . "[contains(normalize-space(.)," . $valueliteral . ")]";
1225         // Looks for the requested node inside the container node.
1226         $coumnnode = $this->getSession()->getDriver()->find($columnvaluexpath);
1227         if (empty($coumnnode)) {
1228             $locatorexceptionmsg = $value . '" in "' . $row . '" row with column "' . $column;
1229             throw new ElementNotFoundException($this->getSession(), "\n$columnvaluexpath\n\n".'Column value', null, $locatorexceptionmsg);
1230         }
1231     }
1233     /**
1234      * Checks the provided value should not exist in specific row/column of table.
1235      *
1236      * @Then /^"(?P<row_string>[^"]*)" row "(?P<column_string>[^"]*)" column of "(?P<table_string>[^"]*)" table should not contain "(?P<value_string>[^"]*)"$/
1237      * @throws ElementNotFoundException
1238      * @param string $row row text which will be looked in.
1239      * @param string $column column text to search
1240      * @param string $table table id/class/caption
1241      * @param string $value text to check.
1242      */
1243     public function row_column_of_table_should_not_contain($row, $column, $table, $value) {
1244         try {
1245             $this->row_column_of_table_should_contain($row, $column, $table, $value);
1246         } catch (ElementNotFoundException $e) {
1247             // Table row/column doesn't contain this value. Nothing to do.
1248             return;
1249         }
1250         // Throw exception if found.
1251         throw new ExpectationException(
1252             '"' . $column . '" with value "' . $value . '" is present in "' . $row . '"  row for table "' . $table . '"',
1253             $this->getSession()
1254         );
1255     }
1257     /**
1258      * Checks that the provided value exist in table.
1259      * More info in http://docs.moodle.org/dev/Acceptance_testing#Providing_values_to_steps.
1260      *
1261      * First row may contain column headers or numeric indexes of the columns
1262      * (syntax -1- is also considered to be column index). Column indexes are
1263      * useful in case of multirow headers and/or presence of cells with colspan.
1264      *
1265      * @Then /^the following should exist in the "(?P<table_string>[^"]*)" table:$/
1266      * @throws ExpectationException
1267      * @param string $table name of table
1268      * @param TableNode $data table with first row as header and following values
1269      *        | Header 1 | Header 2 | Header 3 |
1270      *        | Value 1 | Value 2 | Value 3|
1271      */
1272     public function following_should_exist_in_the_table($table, TableNode $data) {
1273         $datahash = $data->getHash();
1275         foreach ($datahash as $row) {
1276             $firstcell = null;
1277             foreach ($row as $column => $value) {
1278                 if ($firstcell === null) {
1279                     $firstcell = $value;
1280                 } else {
1281                     $this->row_column_of_table_should_contain($firstcell, $column, $table, $value);
1282                 }
1283             }
1284         }
1285     }
1287     /**
1288      * Checks that the provided value exist in table.
1289      * More info in http://docs.moodle.org/dev/Acceptance_testing#Providing_values_to_steps.
1290      *
1291      * @Then /^the following should not exist in the "(?P<table_string>[^"]*)" table:$/
1292      * @throws ExpectationException
1293      * @param string $table name of table
1294      * @param TableNode $data table with first row as header and following values
1295      *        | Header 1 | Header 2 | Header 3 |
1296      *        | Value 1 | Value 2 | Value 3|
1297      */
1298     public function following_should_not_exist_in_the_table($table, TableNode $data) {
1299         $datahash = $data->getHash();
1301         foreach ($datahash as $value) {
1302             $row = array_shift($value);
1303             foreach ($value as $column => $value) {
1304                 try {
1305                     $this->row_column_of_table_should_contain($row, $column, $table, $value);
1306                     // Throw exception if found.
1307                 } catch (ElementNotFoundException $e) {
1308                     // Table row/column doesn't contain this value. Nothing to do.
1309                     continue;
1310                 }
1311                 throw new ExpectationException('"' . $column . '" with value "' . $value . '" is present in "' .
1312                     $row . '"  row for table "' . $table . '"', $this->getSession()
1313                 );
1314             }
1315         }
1316     }
1318     /**
1319      * Given the text of a link, download the linked file and return the contents.
1320      *
1321      * This is a helper method used by {@link following_should_download_bytes()}
1322      * and {@link following_should_download_between_and_bytes()}
1323      *
1324      * @param string $link the text of the link.
1325      * @return string the content of the downloaded file.
1326      */
1327     public function download_file_from_link($link) {
1328         // Find the link.
1329         $linknode = $this->find_link($link);
1330         $this->ensure_node_is_visible($linknode);
1332         // Get the href and check it.
1333         $url = $linknode->getAttribute('href');
1334         if (!$url) {
1335             throw new ExpectationException('Download link does not have href attribute',
1336                     $this->getSession());
1337         }
1338         if (!preg_match('~^https?://~', $url)) {
1339             throw new ExpectationException('Download link not an absolute URL: ' . $url,
1340                     $this->getSession());
1341         }
1343         // Download the URL and check the size.
1344         $session = $this->getSession()->getCookie('MoodleSession');
1345         return download_file_content($url, array('Cookie' => 'MoodleSession=' . $session));
1346     }
1348     /**
1349      * Downloads the file from a link on the page and checks the size.
1350      *
1351      * Only works if the link has an href attribute. Javascript downloads are
1352      * not supported. Currently, the href must be an absolute URL.
1353      *
1354      * @Then /^following "(?P<link_string>[^"]*)" should download "(?P<expected_bytes>\d+)" bytes$/
1355      * @throws ExpectationException
1356      * @param string $link the text of the link.
1357      * @param number $expectedsize the expected file size in bytes.
1358      */
1359     public function following_should_download_bytes($link, $expectedsize) {
1360         $exception = new ExpectationException('Error while downloading data from ' . $link, $this->getSession());
1362         // It will stop spinning once file is downloaded or time out.
1363         $result = $this->spin(
1364             function($context, $args) {
1365                 $link = $args['link'];
1366                 return $this->download_file_from_link($link);
1367             },
1368             array('link' => $link),
1369             self::EXTENDED_TIMEOUT,
1370             $exception
1371         );
1373         // Check download size.
1374         $actualsize = (int)strlen($result);
1375         if ($actualsize !== (int)$expectedsize) {
1376             throw new ExpectationException('Downloaded data was ' . $actualsize .
1377                     ' bytes, expecting ' . $expectedsize, $this->getSession());
1378         }
1379     }
1381     /**
1382      * Downloads the file from a link on the page and checks the size is in a given range.
1383      *
1384      * Only works if the link has an href attribute. Javascript downloads are
1385      * not supported. Currently, the href must be an absolute URL.
1386      *
1387      * The range includes the endpoints. That is, a 10 byte file in considered to
1388      * be between "5" and "10" bytes, and between "10" and "20" bytes.
1389      *
1390      * @Then /^following "(?P<link_string>[^"]*)" should download between "(?P<min_bytes>\d+)" and "(?P<max_bytes>\d+)" bytes$/
1391      * @throws ExpectationException
1392      * @param string $link the text of the link.
1393      * @param number $minexpectedsize the minimum expected file size in bytes.
1394      * @param number $maxexpectedsize the maximum expected file size in bytes.
1395      */
1396     public function following_should_download_between_and_bytes($link, $minexpectedsize, $maxexpectedsize) {
1397         // If the minimum is greater than the maximum then swap the values.
1398         if ((int)$minexpectedsize > (int)$maxexpectedsize) {
1399             list($minexpectedsize, $maxexpectedsize) = array($maxexpectedsize, $minexpectedsize);
1400         }
1402         $exception = new ExpectationException('Error while downloading data from ' . $link, $this->getSession());
1404         // It will stop spinning once file is downloaded or time out.
1405         $result = $this->spin(
1406             function($context, $args) {
1407                 $link = $args['link'];
1409                 return $this->download_file_from_link($link);
1410             },
1411             array('link' => $link),
1412             self::EXTENDED_TIMEOUT,
1413             $exception
1414         );
1416         // Check download size.
1417         $actualsize = (int)strlen($result);
1418         if ($actualsize < $minexpectedsize || $actualsize > $maxexpectedsize) {
1419             throw new ExpectationException('Downloaded data was ' . $actualsize .
1420                     ' bytes, expecting between ' . $minexpectedsize . ' and ' .
1421                     $maxexpectedsize, $this->getSession());
1422         }
1423     }
1425     /**
1426      * Prepare to detect whether or not a new page has loaded (or the same page reloaded) some time in the future.
1427      *
1428      * @Given /^I start watching to see if a new page loads$/
1429      */
1430     public function i_start_watching_to_see_if_a_new_page_loads() {
1431         if (!$this->running_javascript()) {
1432             throw new DriverException('Page load detection requires JavaScript.');
1433         }
1435         $session = $this->getSession();
1437         if ($this->pageloaddetectionrunning || $session->getPage()->find('xpath', $this->get_page_load_xpath())) {
1438             // If we find this node at this point we are already watching for a reload and the behat steps
1439             // are out of order. We will treat this as an error - really it needs to be fixed as it indicates a problem.
1440             throw new ExpectationException(
1441                 'Page load expectation error: page reloads are already been watched for.', $session);
1442         }
1444         $this->pageloaddetectionrunning = true;
1446         $session->executeScript(
1447                 'var span = document.createElement("span");
1448                 span.setAttribute("data-rel", "' . self::PAGE_LOAD_DETECTION_STRING . '");
1449                 span.setAttribute("style", "display: none;");
1450                 document.body.appendChild(span);');
1451     }
1453     /**
1454      * Verify that a new page has loaded (or the same page has reloaded) since the
1455      * last "I start watching to see if a new page loads" step.
1456      *
1457      * @Given /^a new page should have loaded since I started watching$/
1458      */
1459     public function a_new_page_should_have_loaded_since_i_started_watching() {
1460         $session = $this->getSession();
1462         // Make sure page load tracking was started.
1463         if (!$this->pageloaddetectionrunning) {
1464             throw new ExpectationException(
1465                 'Page load expectation error: page load tracking was not started.', $session);
1466         }
1468         // As the node is inserted by code above it is either there or not, and we do not need spin and it is safe
1469         // to use the native API here which is great as exception handling (the alternative is slow).
1470         if ($session->getPage()->find('xpath', $this->get_page_load_xpath())) {
1471             // We don't want to find this node, if we do we have an error.
1472             throw new ExpectationException(
1473                 'Page load expectation error: a new page has not been loaded when it should have been.', $session);
1474         }
1476         // Cancel the tracking of pageloaddetectionrunning.
1477         $this->pageloaddetectionrunning = false;
1478     }
1480     /**
1481      * Verify that a new page has not loaded (or the same page has reloaded) since the
1482      * last "I start watching to see if a new page loads" step.
1483      *
1484      * @Given /^a new page should not have loaded since I started watching$/
1485      */
1486     public function a_new_page_should_not_have_loaded_since_i_started_watching() {
1487         $session = $this->getSession();
1489         // Make sure page load tracking was started.
1490         if (!$this->pageloaddetectionrunning) {
1491             throw new ExpectationException(
1492                 'Page load expectation error: page load tracking was not started.', $session);
1493         }
1495         // We use our API here as we can use the exception handling provided by it.
1496         $this->find(
1497             'xpath',
1498             $this->get_page_load_xpath(),
1499             new ExpectationException(
1500                 'Page load expectation error: A new page has been loaded when it should not have been.',
1501                 $this->getSession()
1502             )
1503         );
1504     }
1506     /**
1507      * Helper used by {@link a_new_page_should_have_loaded_since_i_started_watching}
1508      * and {@link a_new_page_should_not_have_loaded_since_i_started_watching}
1509      * @return string xpath expression.
1510      */
1511     protected function get_page_load_xpath() {
1512         return "//span[@data-rel = '" . self::PAGE_LOAD_DETECTION_STRING . "']";
1513     }
1515     /**
1516      * Wait unit user press Enter/Return key. Useful when debugging a scenario.
1517      *
1518      * @Then /^(?:|I )pause(?:| scenario execution)$/
1519      */
1520     public function i_pause_scenario_executon() {
1521         global $CFG;
1523         $posixexists = function_exists('posix_isatty');
1525         // Make sure this step is only used with interactive terminal (if detected).
1526         if ($posixexists && !@posix_isatty(STDOUT)) {
1527             $session = $this->getSession();
1528             throw new ExpectationException('Break point should only be used with interative terminal.', $session);
1529         }
1531         // Windows don't support ANSI code by default, but with ANSICON.
1532         $isansicon = getenv('ANSICON');
1533         if (($CFG->ostype === 'WINDOWS') && empty($isansicon)) {
1534             fwrite(STDOUT, "Paused. Press Enter/Return to continue.");
1535             fread(STDIN, 1024);
1536         } else {
1537             fwrite(STDOUT, "\033[s\n\033[0;93mPaused. Press \033[1;31mEnter/Return\033[0;93m to continue.\033[0m");
1538             fread(STDIN, 1024);
1539             fwrite(STDOUT, "\033[2A\033[u\033[2B");
1540         }
1541     }
1543     /**
1544      * Presses a given button in the browser.
1545      * NOTE: Phantomjs and goutte driver reloads page while navigating back and forward.
1546      *
1547      * @Then /^I press the "(back|forward|reload)" button in the browser$/
1548      * @param string $button the button to press.
1549      * @throws ExpectationException
1550      */
1551     public function i_press_in_the_browser($button) {
1552         $session = $this->getSession();
1554         if ($button == 'back') {
1555             $session->back();
1556         } else if ($button == 'forward') {
1557             $session->forward();
1558         } else if ($button == 'reload') {
1559             $session->reload();
1560         } else {
1561             throw new ExpectationException('Unknown browser button.', $session);
1562         }
1563     }
1565     /**
1566      * Trigger a keydown event for a key on a specific element.
1567      *
1568      * @When /^I press key "(?P<key_string>(?:[^"]|\\")*)" in "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)"$/
1569      * @param string $key either char-code or character itself,
1570      *               may optionally be prefixed with ctrl-, alt-, shift- or meta-
1571      * @param string $element Element we look for
1572      * @param string $selectortype The type of what we look for
1573      * @throws DriverException
1574      * @throws ExpectationException
1575      */
1576     public function i_press_key_in_element($key, $element, $selectortype) {
1577         if (!$this->running_javascript()) {
1578             throw new DriverException('Key down step is not available with Javascript disabled');
1579         }
1580         // Gets the node based on the requested selector type and locator.
1581         $node = $this->get_selected_node($selectortype, $element);
1582         $modifier = null;
1583         $validmodifiers = array('ctrl', 'alt', 'shift', 'meta');
1584         $char = $key;
1585         if (strpos($key, '-')) {
1586             list($modifier, $char) = preg_split('/-/', $key, 2);
1587             $modifier = strtolower($modifier);
1588             if (!in_array($modifier, $validmodifiers)) {
1589                 throw new ExpectationException(sprintf('Unknown key modifier: %s.', $modifier));
1590             }
1591         }
1592         if (is_numeric($char)) {
1593             $char = (int)$char;
1594         }
1596         $node->keyDown($char, $modifier);
1597         $node->keyPress($char, $modifier);
1598         $node->keyUp($char, $modifier);
1599     }
1601     /**
1602      * Press tab key on a specific element.
1603      *
1604      * @When /^I press tab key in "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)"$/
1605      * @param string $element Element we look for
1606      * @param string $selectortype The type of what we look for
1607      * @throws DriverException
1608      * @throws ExpectationException
1609      */
1610     public function i_post_tab_key_in_element($element, $selectortype) {
1611         if (!$this->running_javascript()) {
1612             throw new DriverException('Tab press step is not available with Javascript disabled');
1613         }
1614         // Gets the node based on the requested selector type and locator.
1615         $node = $this->get_selected_node($selectortype, $element);
1616         $driver = $this->getSession()->getDriver();
1617         if ($driver instanceof \Moodle\BehatExtension\Driver\MoodleSelenium2Driver) {
1618             $driver->post_key("\xEE\x80\x84", $node->getXpath());
1619         } else {
1620             $driver->keyDown($node->getXpath(), "\t");
1621         }
1622     }
1624     /**
1625      * Checks if database family used is using one of the specified, else skip. (mysql, postgres, mssql, oracle, etc.)
1626      *
1627      * @Given /^database family used is one of the following:$/
1628      * @param TableNode $databasefamilies list of database.
1629      * @return void.
1630      * @throws \Moodle\BehatExtension\Exception\SkippedException
1631      */
1632     public function database_family_used_is_one_of_the_following(TableNode $databasefamilies) {
1633         global $DB;
1635         $dbfamily = $DB->get_dbfamily();
1637         // Check if used db family is one of the specified ones. If yes then return.
1638         foreach ($databasefamilies->getRows() as $dbfamilytocheck) {
1639             if ($dbfamilytocheck[0] == $dbfamily) {
1640                 return;
1641             }
1642         }
1644         throw new \Moodle\BehatExtension\Exception\SkippedException();
1645     }
1647     /**
1648      * Checks focus is with the given element.
1649      *
1650      * @Then /^the focused element is( not)? "(?P<node_string>(?:[^"]|\\")*)" "(?P<node_selector_string>[^"]*)"$/
1651      * @param string $not optional step verifier
1652      * @param string $nodeelement Element identifier
1653      * @param string $nodeselectortype Element type
1654      * @throws DriverException If not using JavaScript
1655      * @throws ExpectationException
1656      */
1657     public function the_focused_element_is($not, $nodeelement, $nodeselectortype) {
1658         if (!$this->running_javascript()) {
1659             throw new DriverException('Checking focus on an element requires JavaScript');
1660         }
1661         list($a, $b) = $this->transform_selector($nodeselectortype, $nodeelement);
1662         $element = $this->find($a, $b);
1663         $xpath = addslashes_js($element->getXpath());
1664         $script = 'return (function() { return document.activeElement === document.evaluate("' . $xpath . '",
1665                 document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue; })(); ';
1666         $targetisfocused = $this->getSession()->evaluateScript($script);
1667         if ($not == ' not') {
1668             if ($targetisfocused) {
1669                 throw new ExpectationException("$nodeelement $nodeselectortype is focused", $this->getSession());
1670             }
1671         } else {
1672             if (!$targetisfocused) {
1673                 throw new ExpectationException("$nodeelement $nodeselectortype is not focused", $this->getSession());
1674             }
1675         }
1676     }
1678     /**
1679      * Checks focus is with the given element.
1680      *
1681      * @Then /^the focused element is( not)? "(?P<n>(?:[^"]|\\")*)" "(?P<ns>[^"]*)" in the "(?P<c>(?:[^"]|\\")*)" "(?P<cs>[^"]*)"$/
1682      * @param string $not string optional step verifier
1683      * @param string $element Element identifier
1684      * @param string $selectortype Element type
1685      * @param string $nodeelement Element we look in
1686      * @param string $nodeselectortype The type of selector where we look in
1687      * @throws DriverException If not using JavaScript
1688      * @throws ExpectationException
1689      */
1690     public function the_focused_element_is_in_the($not, $element, $selectortype, $nodeelement, $nodeselectortype) {
1691         if (!$this->running_javascript()) {
1692             throw new DriverException('Checking focus on an element requires JavaScript');
1693         }
1694         $element = $this->get_node_in_container($selectortype, $element, $nodeselectortype, $nodeelement);
1695         $xpath = addslashes_js($element->getXpath());
1696         $script = 'return (function() { return document.activeElement === document.evaluate("' . $xpath . '",
1697                 document, null, XPathResult.FIRST_ORDERED_NODE_TYPE, null).singleNodeValue; })(); ';
1698         $targetisfocused = $this->getSession()->evaluateScript($script);
1699         if ($not == ' not') {
1700             if ($targetisfocused) {
1701                 throw new ExpectationException("$nodeelement $nodeselectortype is focused", $this->getSession());
1702             }
1703         } else {
1704             if (!$targetisfocused) {
1705                 throw new ExpectationException("$nodeelement $nodeselectortype is not focused", $this->getSession());
1706             }
1707         }
1708     }
1710     /**
1711      * Manually press tab key.
1712      *
1713      * @When /^I press( shift)? tab$/
1714      * @param string $shift string optional step verifier
1715      * @throws DriverException
1716      */
1717     public function i_manually_press_tab($shift = '') {
1718         if (!$this->running_javascript()) {
1719             throw new DriverException($shift . ' Tab press step is not available with Javascript disabled');
1720         }
1722         $value = ($shift == ' shift') ? [\WebDriver\Key::SHIFT . \WebDriver\Key::TAB] : [\WebDriver\Key::TAB];
1723         $this->getSession()->getDriver()->getWebDriverSession()->activeElement()->postValue(['value' => $value]);
1724     }
1726     /**
1727      * Trigger click on node via javascript instead of actually clicking on it via pointer.
1728      * This function resolves the issue of nested elements.
1729      *
1730      * @When /^I click on "(?P<element_string>(?:[^"]|\\")*)" "(?P<selector_string>[^"]*)" skipping visibility check$/
1731      * @param string $element
1732      * @param string $selectortype
1733      */
1734     public function i_click_on_skipping_visibility_check($element, $selectortype) {
1736         // Gets the node based on the requested selector type and locator.
1737         $node = $this->get_selected_node($selectortype, $element);
1738         $this->js_trigger_click($node);
1739     }