Testen.

DXPR Builder heeft vier soorten geautomatiseerde controles: een Puppeteer-test van de editor, Bash end-to-end-tests voor de Drush-opdrachten, een Selenium visuele-regressiesuite in de aparte dxpr_maven-repository, en linters. Deze pagina somt elk op, hoe je hem lokaal draait en hoe CI hem draait.

Wat bestaat

De enige PHPUnit-test in de repository is modules/dxpr_builder_media/tests/src/FunctionalJavascript/MediaEntityBrowserTest.php voor de legacy mediasubmodule. Geen GitHub-workflow draait hem; de drupal.org GitLab-pipeline (.gitlab-ci.yml) gebruikt de standaard DrupalCI-templates, waarvan de PHPUnit-job daar niet is uitgeschakeld.

Editorconsoletest

test/test-editor.js start een statische server op poort 3000 (test/start-standalone-server.js) en opent vier standalone pagina's uit test/standalone-editor/ in headless Chrome: test-bs5-anon.html, test-bs5-cms-block.html, test-bs5-editor.html en test-bs5-clean-html.html. Hij faalt wanneer:

• een pagina een JavaScript-fout gooit;
• de volledige editor niet binnen 2000 ms klaar is, of er na laden geen uitgestelde off-screen controls overblijven (de performancegate);
• elementbediening overlapt in de Power user-modus (de baseline is nul overlappende paren);
• de opgeslagen HTML van de volledige editorpagina groter is dan de referentie van 32.094 tekens;
• een paginaspecifieke controle mislukt, bijvoorbeeld het parsen van schone Bootstrap-HTML, de breadcrumb, de Panel types, de lokale video-instelling Muted of de CMS-blokpreview.

De pagina's laden de gebouwde bestanden uit dxpr_builder/, dus bouw eerst.

1. Installeer afhankelijkheden:

   npm install
   

2. Bouw de editorbundle. Het CI-script draait deze taken in deze volgorde (test/scripts/run-fe-tests.sh):

   npx grunt concat
   npx grunt exec:gen
   npx grunt babel
   npx grunt terser
   npx grunt sass
   npx grunt postcss
   

3. Draai de test:

   npm run fe-test
   

   Gebruik npm run fe-test:headed om de browser te bekijken, en npm run fe-test:dev om de standalone pagina's te serveren zonder asserts uit te voeren.

In CI draait .github/workflows/fe-test.yaml dezelfde test via Docker:

docker compose --profile fe-test run --rm fe-test

Drush end-to-end-tests

scripts/drush-e2e/run-e2e-tests.sh installeert een verse Drupal 11-site met SQLite in een Composer-container, symlinkt de module erin, schakelt hem in, maakt een Basic page-inhoudstype met de dxpr_builder_text-formatter, een paginasjabloon en een gebruikerssjabloon, en draait daarna elk scripts/drush-e2e/test-*.sh-bestand:

Draai ze allemaal:

docker compose --profile drush-e2e run --rm e2e-test

Draai één bestand door een deel van zijn naam door te geven; het script matcht scripts/drush-e2e/test-*<filter>*.sh:

docker compose --profile drush-e2e run --rm e2e-test page-create

Om een test toe te voegen, maak je scripts/drush-e2e/test-<name>.sh, roep je section "<Title>" aan, en gebruik je de helpers uit scripts/drush-e2e/_helpers.sh: assert_success, assert_fail, assert_eq, assert_has, assert_not_empty, assert_runs en assert_dry_run. Elke helper neemt een beschrijving en een opdrachtstring.

In CI is deze suite de "Run Drush E2E tests"-job in .github/workflows/review.yaml. Hij draait wanneer een pull request .php-, .module-, .inc-, .install-, .yml-, .md-, composer.json- of composer.lock-bestanden wijzigt.

Selenium visuele-regressiesuite

De browsertests zijn Java TestNG-suites in de dxpr_maven-repository. Ze draaien tegen een Docker-stack gedefinieerd in docker-compose.test.yml (Selenium-hub, Chrome-nodes en een Maven-container) op een site geïnstalleerd uit deze repository. Je draait ze niet vanuit een lokale checkout; je triggert ze vanuit een pull request-reactie. .github/workflows/command-dispatcher.yml maakt van de reactie een workflowrun.

Opties, zoals gedocumenteerd in CONTRIBUTING.md:

• groups=row-element-test,icon-element-test draait de genoemde <test name="...">-groepen uit de suite-XML.
• tests=RowColumnLayoutVisualTest draait de genoemde testklassen.
• maven_ref=branch-name gebruikt een dxpr_maven-branch, waarmee een builderwijziging en zijn testupdate samen worden gereviewd.

De workflow uploadt target/reports/** en de screenshots als buildartefact en post het resultaat als reactie op de pull request, met mislukkingen of tests die alleen bij retry slaagden. Elke suitejob heeft een timeout van 90 minuten.

Linters en statische analyse

Elke linter is een Docker Compose-service, dus behalve Docker is geen lokale toolchain nodig.

Auto-fix-varianten bestaan voor phpcs, ESLint en Stylelint (drupal-lint-auto-fix, eslint-auto-fix, stylelint-auto-fix). Dezelfde controles zijn zonder Docker beschikbaar via npm run lint:scss, npm run lint:no-jquery, npm run lint:no-underscore en npm run lint:html-in-js.

npm install installeert ook een Husky pre-commit hook (.husky/pre-commit). Hij draait de bijpassende auto-fixen lintservices op de gestagede JavaScript-, PHP- en SCSS-bestanden en de Rust-bronnen, en docs/video-tools/bin/lint-videos.mjs wanneer bestanden onder docs/ zijn gestaged.

.github/workflows/review.yaml draait de linters die bij de gewijzigde paden passen op elke pull request. .github/workflows/main.yaml draait drupal-lint, eslint, drupal-check-D11 en rust-lint op elke push naar 3.x. Beide laten de build falen wanneer een controle faalt en schrijven een samenvatting met de overtredende bestanden.

Wat nu?

• Bijdragen voor het pull request-proces en de maven_ref-workflow voor testupdates.
• Drush-opdrachten voor de opdrachten die de Bash-suite oefent.