drupalci-chromedriver

DrupalCI ChromeDriver (Behat, DrupalCI, FunctionalJavascript)

This recipe adds the DrupalCI ChromeDriver container to a project.

Among other things, this supports Drupal's FunctionalJavascript tests. But it also supports Behat with WebDriver or any other use of headless Chrome. It is based on Matt Glaman's excelent blog post

Installation

• Copy docker-compose.chromedriver.yaml to the .ddev folder of your project.
• Set environment variables in the "environment" section of the "web" service in docker-compose.chromedriver.yaml as appropriate. The defaults are for Drupal Functional and FunctionalJavascript testing.
• Verify that your phpunit.xml does not define MINK_DRIVER_ARGS_WEBDRIVER. This should come from our docker-compose.chromedriver.yaml.
• Start (or restart) DDEV to have the service initialized: ddev start
• Your Drupal project must be built with --require-dev to get necessary dependencies like phpunit (for example, ddev composer create drupal/recommended-project --require-dev)
• To test the setup, ddev ssh and run a Drupal unit test that triggers ChromeDriver. Example:

user@demo-web:/var/www/html$ phpunit --verbose -c web/core/phpunit.xml.dist web/core/modules/system/tests/src/FunctionalJavascript/System/DateFormatTest.php

Contributed by @mglaman and @heddn