Drupal & Nightwatch.js training

Example of using Drupal's Nightwatch.js test suite

Notes

Setting this up for Drupal core contribution

This repository is based on a Composer build and not meant for core contributions, it is fine for contrib.

To set up your own core contribution environments follow the following:

git clone https://git.drupalcode.org/project/drupal.git
cd drupal

# If lando
wget https://raw.githubusercontent.com/bluehorndigital/drupal-testing-workshop/main/.lando.yml

# if DDEV
ddev config --yes
cd .ddev
wget https://raw.githubusercontent.com/bluehorndigital/drupal-testing-workshop/main/.ddev/docker-compose.testing.yaml

Chromedriver `--no-sandbox` in containers

When running headless Chrome via Chromedriver in a container, you must specify the --no-sandbox flag. Without this flag, Chrome will not start. This can be mitigated if the container has an appropriate user configured (the DrupalCI image used here does not*)

Source: https://developers.google.com/web/updates/2017/04/headless-chrome

* The example provided by Google shows an example from Lighthouse Bot that sets the user to chrome. The drupalci/chromedriver performs nearly the same operation but as chromeuser. I have opened an issue for the DrupalCI image here: https://www.drupal.org/project/drupalci_environments/issues/3205271

Nightwatch error on installProfileTest

Probably memory. Umami demo takes a lot to install.

TODO

Write up how to do this locally
Lando complains private/browsertest_output is not writeable, it should be generated on install but is missing

Locally

Getting tests running: Locally

Locally using

https://mglaman.dev/blog/my-phpunit-configuration-my-drupal-projects

DDEV

Getting tests running: DDEV

There are DDEV commands to run PHPUnit and Nightwatch setup in this project.

ddev phpunit core/modules/action
ddev nightwatch --tag core

Commands documented: https://ddev.readthedocs.io/en/stable/users/extend/custom-commands/#container-commands

Blogs:

Lando

Getting tests running: Lando

With tooling definitions preconfigured in this project, we can run the tests

lando phpunit core/modules/action
lando nightwatch --tag core

bluehorndigital/drupal-testing-workshop