Discourse обладает обширным набором тестов фронтенда для ядра, плагинов и тем. Как только у вас будет настроенная локальная среда разработки, эти тесты можно запускать локально несколькими способами.
Запуск тестов в браузере
Ядро / Плагины: откройте /tests в вашей среде разработки
Темы: откройте /theme-qunit в вашей среде разработки (или производства), затем выберите тему
В общем случае, при работе с тестами ядра, следует выбрать “core” в раскрывающемся списке “Target” (Цель), а при работе с плагинами выбрать конкретный плагин.
К сожалению, на момент написания этого документа утечки памяти в наших тестах означают, что попытка запуска всего набора тестов в одном браузере обычно приводит к достижению лимита памяти браузера. Чтобы запустить весь набор тестов параллельно в нескольких браузерах, ознакомьтесь с примерами использования CLI ниже.
Запуск тестов через CLI
Ядро
Из корневой директории Discourse используйте bin/qunit (убедитесь, что вы выполнили pnpm install после последнего получения изменений из upstream). Эта команда оборачивает Ember Exam для рандомизации и параллелизации, и по умолчанию работает с запущенным сервером Rails и существующими JS-ассетами. Выполните bin/qunit --help, чтобы увидеть полный список опций.
Вот несколько полезных примеров:
# Запуск одного тестового файла или всех тестов в директории:
bin/qunit frontend/discourse/tests/integration/components/bookmark-test.gjs
bin/qunit frontend/discourse/tests/integration/components
# Запуск всего набора тестов ядра параллельно в 5 головless-экземплярах Chrome:
bin/qunit --parallel 5
# Запуск всех тестов, чья "module: test name" содержит подстроку (без учета регистра):
bin/qunit --filter "Integration | Component | bookmark"
# Оберните значение в слэши для использования регулярного выражения, например, для альтернации:
bin/qunit --filter "/bookmark|reaction/i"
# Поднимите изолированный сервер и запустите тесты в видимом браузере для более удобной отладки:
bin/qunit --standalone --no-headless
Параметр
--filterпередается в QUnit: обычное значение сопоставляется как подстрока без учета регистра, а значение, обернутое в слэши, например/foo/i, сопоставляется как регулярное выражение. Добавьте флагiдля сопоставления регулярных выражений без учета регистра.
Плагины
Из корневой директории Discourse:
bin/qunit plugins/chat/test/javascripts/unit/lib/chat-audio-test.js # Запуск одного файла
bin/qunit plugins/chat/test/javascripts/unit # Запуск директории
bin/rake "plugin:qunit" # Запуск всех qunit-тестов плагинов
bin/rake "plugin:qunit[discourse-chat-integration]" # Запуск qunit-тестов одного плагина
Темы
Из корневой директории Discourse:
bin/rake "themes:qunit[url,<theme_url>]"
bin/rake "themes:qunit[name,<theme_name>]"
bin/rake "themes:qunit[id,<theme_id>]"
Этот документ находится под контролем версий — предлагаем внести изменения на GitHub.