Тестування.

DXPR Builder має чотири види автоматизованих перевірок: тест редактора Puppeteer, наскрізні тести Bash для команд Drush, набір візуальної регресії Selenium в окремому репозиторії dxpr_maven, і лінтери. Ця сторінка перелічує кожну, як запускати її локально і як її запускає CI.

Що існує

Єдиний PHPUnit-тест у репозиторії це modules/dxpr_builder_media/tests/src/FunctionalJavascript/MediaEntityBrowserTest.php для застарілого медіасубмодуля. Жоден робочий процес GitHub його не запускає; конвеєр GitLab drupal.org (.gitlab-ci.yml) використовує стандартні шаблони DrupalCI, чиє завдання PHPUnit там не вимкнено.

Тест консолі редактора

test/test-editor.js запускає статичний сервер на порту 3000 (test/start-standalone-server.js) і відкриває чотири автономні сторінки з test/standalone-editor/ у headless Chrome: test-bs5-anon.html, test-bs5-cms-block.html, test-bs5-editor.html і test-bs5-clean-html.html. Він не вдається, коли:

• сторінка кидає помилку JavaScript;
• повний редактор не готовий за 2000 мс, або після завантаження не лишилося відкладених позаекранних елементів керування (ворота продуктивності);
• елементи керування елементів перекриваються в режимі Power user (базове значення: нуль пар, що перекриваються);
• збережений HTML сторінки повного редактора більший за еталон у 32 094 символи;
• не вдається перевірка конкретної сторінки, наприклад розбір чистого HTML Bootstrap, хлібні крихти, Panel types, налаштування локального відео Muted або попередній перегляд блока CMS.

Сторінки завантажують зібрані файли з dxpr_builder/, тож спершу зберіть.

1. Встановіть залежності:

   npm install
   

2. Зберіть пакет редактора. Скрипт CI запускає ці завдання в такому порядку (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. Запустіть тест:

   npm run fe-test
   

   Використовуйте npm run fe-test:headed, щоб спостерігати браузер, і npm run fe-test:dev, щоб подавати автономні сторінки без запуску тверджень.

У CI .github/workflows/fe-test.yaml запускає той самий тест через Docker:

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

Наскрізні тести Drush

scripts/drush-e2e/run-e2e-tests.sh встановлює свіжий сайт Drupal 11 із SQLite всередині контейнера Composer, симлінкує в нього модуль, вмикає його, створює тип вмісту Basic page із форматувальником dxpr_builder_text, шаблон сторінки та шаблон користувача, потім запускає кожен файл scripts/drush-e2e/test-*.sh:

Запустіть усі:

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

Запустіть один файл, передавши частину його імені; скрипт зіставляє scripts/drush-e2e/test-*<filter>*.sh:

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

Щоб додати тест, створіть scripts/drush-e2e/test-<name>.sh, викличте section "<Title>", і використовуйте помічників із scripts/drush-e2e/_helpers.sh: assert_success, assert_fail, assert_eq, assert_has, assert_not_empty, assert_runs і assert_dry_run. Кожен помічник приймає опис і рядок команди.

У CI цей набір це завдання «Run Drush E2E tests» у .github/workflows/review.yaml. Він запускається, коли пул-реквест змінює файли .php, .module, .inc, .install, .yml, .md, composer.json або composer.lock.

Набір візуальної регресії Selenium

Браузерні тести це набори Java TestNG. Вони живуть у репозиторії dxpr_maven і запускаються проти стека Docker, визначеного в docker-compose.test.yml (хаб Selenium, ноди Chrome та контейнер Maven), на сайті, встановленому з цього репозиторію. Ви не запускаєте їх із локального клону; ви запускаєте їх коментарем пул-реквесту. .github/workflows/command-dispatcher.yml перетворює коментар на запуск робочого процесу.

Параметри, як задокументовано в CONTRIBUTING.md:

• groups=row-element-test,icon-element-test запускає іменовані групи <test name="..."> із XML набору.
• tests=RowColumnLayoutVisualTest запускає іменовані тестові класи.
• maven_ref=branch-name використовує гілку dxpr_maven, так зміна конструктора та її оновлення тесту переглядаються разом.

Робочий процес завантажує target/reports/** і скриншоти як артефакт збірки й публікує результат коментарем до пул-реквесту, перелічуючи невдачі або тести, які пройшли лише з повтору. Кожне завдання набору має 90-хвилинний тайм-аут.

Лінтери та статичний аналіз

Кожен лінтер це служба Docker Compose, тож локальний інструментарій поза Docker не потрібен.

Варіанти автовправлень існують для phpcs, ESLint і Stylelint (drupal-lint-auto-fix, eslint-auto-fix, stylelint-auto-fix). Ті самі перевірки доступні без Docker через npm run lint:scss, npm run lint:no-jquery, npm run lint:no-underscore і npm run lint:html-in-js.

npm install також встановлює хук pre-commit Husky (.husky/pre-commit). Він запускає відповідні служби автовправлень і лінтингу на підготовлених файлах JavaScript, PHP і SCSS та Rust-джерелах, і docs/video-tools/bin/lint-videos.mjs, коли підготовлено файли під docs/.

.github/workflows/review.yaml запускає лінтери, які відповідають зміненим шляхам, на кожному пул-реквесті. .github/workflows/main.yaml запускає drupal-lint, eslint, drupal-check-D11 і rust-lint на кожному пуші до 3.x. Обидва провалюють збірку, коли перевірка не вдається, і пишуть підсумок із файлами-порушниками.

Що далі?

• Участь у розробці для процесу пул-реквестів і робочого процесу maven_ref для оновлень тестів.
• Команди Drush для команд, які вправляє набір Bash.