Acceptance testing/Browsers

Jump to: navigation, search

This page complements Acceptance testing providing info about how to run the acceptance tests suite in different browsers.

Drivers

There are Selenium drivers (http://docs.seleniumhq.org/projects/webdriver/) to run acceptance tests in different browsers:

Each driver should be downloaded and Selenium .jar should be started specifying the path to the driver; depending on the driver there could be other requirements.

PhantomJS

PhantomJS is different as it is a headless browser as it is quite faster than other drivers, it doesn't need a GUI to run and can execute JS, it doesn't even need to be used through Selenium (you can do it though, but it's not officially supported) and you can do it

Note that 4444 is the default port used by Selenium so you must specify another one if you want to run them together and specify the port in $CFG->behat_config.

Examples

 # Selenium in Linux (firefox by default + chrome)
 java -jar /opt/selenium-server-standalone.jar -Dwebdriver.chrome.driver=/opt/chromedriver
 # Selenium in OSx (firefox & safari by default + chrome)
 java -jar /Users/moodle/Downloads/selenium-server-standalone.jar -Dwebdriver.chrome.driver=/Users/moodle/Downloads/chromedriver
 # Selenium in Windows (started using git bash) (firefox by default + chrome + internet explorer)
 java -jar /c/seleniumdrivers/selenium-server-standalone.jar -Dwebdriver.chrome.driver=/c/seleniumdrivers/chromedriver.exe -Dwebdriver.ie.driver=/c/seleniumdrivers/IEDriverServer.exe
 # PhantomJS
 /path/to/your/phantomjs/bin/phantomjs --webdriver=4444

Compatibility

Not all the drivers can execute all of Moodle's step definitions; we tagged the step definitions that are using features not supported by all browsers and also limitations that some browsers have; refer to the following table to know which browsers can run which tags:

File uploads (@_file_upload) Browser dialogs (@_alert) Switch window (@_switch_window) Switch frame (@_switch_iframe) Bug in phantomjs (@_bug_phantomjs)
Firefox Yes Yes Yes Yes Yes
Chrome Yes Yes Yes Yes Yes
Internet Explorer Yes Yes No Yes Yes
Safari Yes No No Yes Yes
PhantomJS No No Yes Yes No

Working combinations of OS+Browser+selenium

As OS, Browsers and Selenium keeps updating, some combination of OS+Browser+Selenium will not work on specific moodle version.

We try to support the latest version of these combinations but they are not always BC and hence may not work with older releases. Please refer to Acceptance testing/Browsers/Working combinations of OS+Browser+selenium to ensure you have correct combination of them to run acceptance test.

Moodle configuration

You need to tell behat what browser do you want to run and where it is. The best option could be to use behat profiles (http://docs.behat.org/guides/7.config.html#profiles).

The profiles can be specified in config.php through $CFG->behat_config like all other behat.yml specific configurations.

This is an example of $CFG->behat_config to run behat in multiple environments (Windows, Linux and OSx) to cover all the supported browsers. Note that we are using multiple servers so we skip the tests that involves files uploads when using a remote server.

   // Note that in this case $linuxip is the local server.
   // Set servers IPs.
   $linuxip = '127.0.0.1';
   $windowsip = '192.168.xxx.xxx';
   $osxip = '192.168.xxx.xxx';
   $CFG->behat_config = array(
       'phantomjs-linux' => array(
           'filters' => array(
               'tags' => '~@_bug_phantomjs&&~@_file_upload&&~@_alert'
           ),
          'extensions' => array(
              'Behat\MinkExtension\Extension' => array(
                  'selenium2' => array(
                      'browser' => 'phantomjs',
                      'wd_host' => 'http://' . $linuxip . ':4444/wd/hub'
                  )
              )
          )
       ),
       'chrome-linux' => array(
           'extensions' => array(
               'Behat\MinkExtension\Extension' => array(
                   'selenium2' => array(
                       'browser' => 'chrome',
                       'wd_host' => 'http://' . $linuxip . ':4444/wd/hub'
                   )
               )
           )
       ),
       'chrome-osx' => array(
           'filters' => array(
               'tags' => '~@_file_upload'
           ),
           'extensions' => array(
               'Behat\MinkExtension\Extension' => array(
                   'selenium2' => array(
                       'browser' => 'chrome',
                       'wd_host' => 'http://' . $osxip . ':4444/wd/hub'
                   )
               )
           )
       ),
       'chrome-win' => array(
           'filters' => array(
               'tags' => '~@_file_upload'
           ),
           'extensions' => array(
               'Behat\MinkExtension\Extension' => array(
                   'selenium2' => array(
                       'browser' => 'chrome',
                       'wd_host' => 'http://' . $windowsip . ':4444/wd/hub'
                   )
               )
           )
       ),
       'firefox-linux' => array(
           'extensions' => array(
               'Behat\MinkExtension\Extension' => array(
                   'selenium2' => array(
                       'browser' => 'firefox',
                       'wd_host' => 'http://' . $linuxip . ':4444/wd/hub'
                   )
               )
           )
       ),
       'firefox-osx' => array(
           'filters' => array(
               'tags' => '~@_file_upload'
           ),
           'extensions' => array(
               'Behat\MinkExtension\Extension' => array(
                   'selenium2' => array(
                       'browser' => 'firefox',
                       'wd_host' => 'http://' . $osxip . ':4444/wd/hub'
                   )
               )
           )
       ),
       'firefox-win' => array(
           'filters' => array(
               'tags' => '~@_file_upload'
           ),
           'extensions' => array(
               'Behat\MinkExtension\Extension' => array(
                   'selenium2' => array(
                       'browser' => 'firefox',
                       'wd_host' => 'http://' . $windowsip . ':4444/wd/hub'
                   )
               )
           )
       ),
       'safari-osx' => array(
           'filters' => array(
               'tags' => '~@_alert&&~@_switch_window&&~@_file_upload'
           ),
           'extensions' => array(
               'Behat\MinkExtension\Extension' => array(
                   'selenium2' => array(
                       'browser' => 'safari',
                       'wd_host' => 'http://' . $osxip . ':4444/wd/hub'
                   )
               )
           )
       ),
       'ie-win' => array(
           'filters' => array(
               'tags' => '~@_switch_window&&~@_file_upload'
           ),
           'extensions' => array(
               'Behat\MinkExtension\Extension' => array(
                   'selenium2' => array(
                       'browser' => 'internet explorer',
                       'wd_host' => 'http://' . $windowsip . ':4444/wd/hub'
                   )
               )
           )
       ),
      'edge-win' => array(
           'filters' => array(
               'tags' => '~@_switch_window&&~@_file_upload'
           ),
           'extensions' => array(
               'Behat\MinkExtension\Extension' => array(
                   'selenium2' => array(
                       'browser' => 'MicrosoftEdge',
                       'wd_host' => 'http://' . $windowsip . ':4444/wd/hub'
                   )
               )
           )
       )
   );