drupal-testing

Drupal Testing — Orchestrator

This skill coordinates test generation for Drupal 10/11 projects. It analyzes the code under test and delegates to the appropriate specialized skill.

Decision Flow

See the drupal-testing rule for the complete decision tree. Quick summary:

Code Type	Test Type	Skill
Pure PHP, no Drupal deps	Unit	Template in drupal-testing rule
Advanced unit mocking	Unit	drupal-unit-test
Services, entities, DB, config, plugins, hooks	Kernel	drupal-kernel-test
UI forms, HTTP permissions, HTML output	Functional	drupal-functional-test
AJAX, modals, autocompletes, JS	FunctionalJavascript	drupal-functionaljs-test
E2E flows, acceptance (Behat project)	Behat	drupal-behat-test
Visual regression, cross-browser, E2E (no Behat)	Playwright	drupal-playwright-test

Tie-breakers (apply them, do not deliberate): touches any Drupal service or needs >4-5 mocks → Kernel. Assertion about logic/data, not HTML/HTTP → Kernel over Functional. No-JS behavior → never FunctionalJS. behat.yml exists → Behat, else Playwright. Pick ONE type per behavior.

Workflow

1. Detect Drupal version — check core/lib/Drupal.php or composer.json
2. Read the code — understand dependencies and Drupal API usage
3. Check existing tests — look at tests/ folder, match existing style
4. Apply decision tree — use the drupal-testing rule
5. Load specialized skill — delegate to the appropriate skill
6. Execute and verify — run the test, fix if it fails

Test Execution Commands

Replace MODULE with the module machine name.

STEP 1 — Pick the config form. Run ONCE, then use the matching form for the whole session:

ssh web test -f phpunit.xml && echo "ROOT" || echo "CORE"

# Form ROOT (project phpunit.xml exists — it already sets env vars):
ssh web ./vendor/bin/phpunit $DDEV_DOCROOT/modules/custom/MODULE/tests/src/Unit
ssh web ./vendor/bin/phpunit $DDEV_DOCROOT/modules/custom/MODULE/tests/src/Kernel
ssh web ./vendor/bin/phpunit $DDEV_DOCROOT/modules/custom/MODULE/tests/src/Functional
ssh web ./vendor/bin/phpunit $DDEV_DOCROOT/modules/custom/MODULE/tests/src/FunctionalJavascript

# Form CORE (no project phpunit.xml — Drupal core config + explicit env vars):
ssh web env SIMPLETEST_DB=mysql://db:db@db/db SIMPLETEST_BASE_URL=http://localhost \
  ./vendor/bin/phpunit -c $DDEV_DOCROOT/core $DDEV_DOCROOT/modules/custom/MODULE/tests/src/Unit

# Single test method (add --filter before the path; works with both forms)
ssh web ./vendor/bin/phpunit --filter testMethodName $DDEV_DOCROOT/modules/custom/MODULE/tests/src/Unit

# Coverage (requires Xdebug; report written to /tmp/coverage in the web container)
ssh web env XDEBUG_MODE=coverage ./vendor/bin/phpunit --coverage-html /tmp/coverage \
  $DDEV_DOCROOT/modules/custom/MODULE/tests/src/Unit

# Behat (uses behat.yml, not phpunit.xml)
ssh web ./vendor/bin/behat --config=behat.yml

# Playwright (runs on the HOST — ask the user to run: npx playwright test)