Как запустить наборы тестов QUnit для ядра, плагинов и тем Discourse

Discourse обладает обширным набором тестов фронтенда для ядра, плагинов и тем. Как только у вас будет настроенная локальная среда разработки, эти тесты можно запускать локально несколькими способами.

Запуск тестов в браузере

Ядро / Плагины: откройте /tests в вашей среде разработки

Темы: откройте /theme-qunit в вашей среде разработки (или производства), затем выберите тему

В общем случае, при работе с тестами ядра, следует выбрать “core” в раскрывающемся списке “Target” (Цель), а при работе с плагинами выбрать конкретный плагин.

:information_source: К сожалению, на момент написания этого документа утечки памяти в наших тестах означают, что попытка запуска всего набора тестов в одном браузере обычно приводит к достижению лимита памяти браузера. Чтобы запустить весь набор тестов параллельно в нескольких браузерах, ознакомьтесь с примерами использования 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

:information_source: Параметр --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.

20 лайков