Introduction

This service can be used with any project type. The examples below are Drupal-specific. Contributions for docs and tests that show this service working with other project types are appreciated.

Install/Update

1. ddev get drud/ddev-selenium-standalone-chrome
2. Optional. Update the provided .ddev/config.selenium-standalone-chrome.yaml as you see fit(and remove the #ddev-generated line). You can also just override lines in your .ddev/config.yaml
3. Optional. Check config.selenium-standalone-chrome.yaml and docker-compose.selenium-chrome.yaml into your source control.
4. Update by re-running ddev get drud/ddev-selenium-standalone-chrome.

Use

• Your project is now ready to run FunctionalJavascript and Nightwatch tests from Drupal core, or Drupal Test Traits (DTT). All these types are tested in this repo. Some examples to try:
  • FunctionalJavascript:
    • Ensure you have the drupal/core-dev Composer package or equivalent.
    • ddev exec -d /var/www/html/web "../vendor/bin/phpunit -v -c ./core/phpunit.xml.dist ./core/modules/system/tests/src/FunctionalJavascript/FrameworkTest.php"
  • Nightwatch
    • ddev exec -d /var/www/html/web/core yarn install (do this once)
    • ddev exec -d /var/www/html/web/core touch .env ((do this once))
    • ddev exec -d /var/www/html/web/core yarn test:nightwatch tests/Drupal/Nightwatch/Tests/exampleTest.js
  • Drupal Test Traits
    • Ensure you have a working site that has the weitzman/drupal-test-traits Composer package.
    • ddev exec -d /var/www/html/web "../vendor/bin/phpunit --bootstrap=../vendor/weitzman/drupal-test-traits/src/bootstrap-fast.php --printer '\Drupal\Tests\Listeners\HtmlOutputPrinter' ../vendor/weitzman/drupal-test-traits/tests/ExampleSelenium2DriverTest.php"
• On your host, browse to https://[DDEV SITE URL]:7900 (password: secret) to watch tests run (neat!).

Contribute

• Anyone is welcome to submit a PR to this repo. See README.md at https://github.com/drud/ddev-addon-template, the parent of this repo.

Maintainer

• Contributed and maintained by @weitzman.