Discourse dispose de tests front-end étendus pour le cœur, les extensions et les thèmes. Une fois que vous disposez d’un environnement de développement local fonctionnel, ces tests peuvent être exécutés localement de plusieurs façons différentes.
Exécuter les tests dans le navigateur
Cœur / Extensions : Rendez-vous sur /tests dans votre environnement de développement
Thèmes : Rendez-vous sur /theme-qunit dans votre environnement (de développement ou de production), puis choisissez le thème
En règle générale, lorsque vous travaillez sur les tests du cœur, vous devez sélectionner “core” dans le menu déroulant “Target”, et lorsque vous travaillez sur des extensions, vous devez sélectionner l’extension spécifique.
Malheureusement, au moment où nous écrivons ces lignes, des fuites de mémoire dans nos tests signifient que tenter d’exécuter toute la suite dans un seul navigateur a tendance à atteindre la limite de mémoire du navigateur. Pour exécuter toute la suite sur plusieurs navigateurs en parallèle, consultez les exemples de CLI ci-dessous.
Exécuter les tests via la ligne de commande (CLI)
Cœur
Depuis le répertoire racine de Discourse, utilisez bin/qunit (assurez-vous d’avoir exécuté pnpm install depuis votre dernière récupération des modifications en amont). Cela encapsule Ember Exam pour la randomisation et la parallélisation, et exécute par défaut les tests sur le serveur Rails en cours d’exécution et les ressources JS existantes. Exécutez bin/qunit --help pour obtenir la liste complète des options.
Voici quelques exemples utiles :
# Exécuter un seul fichier de test, ou tous les tests d'un répertoire :
bin/qunit frontend/discourse/tests/integration/components/bookmark-test.gjs
bin/qunit frontend/discourse/tests/integration/components
# Exécuter toute la suite du cœur en parallèle sur 5 instances Chrome sans interface graphique (headless) :
bin/qunit --parallel 5
# Exécuter tous les tests dont le "module: nom du test" contient une sous-chaîne (insensible à la casse) :
bin/qunit --filter "Integration | Component | bookmark"
# Encadrer la valeur à faire correspondre par des barres obliques pour utiliser une expression régulière, par ex. pour une alternative :
bin/qunit --filter "/bookmark|reaction/i"
# Lancer un serveur isolé et exécuter dans un navigateur visible pour un débogage plus facile :
bin/qunit --standalone --no-headless
![]()
--filterest transmis à QUnit : une valeur simple correspond à une sous-chaîne insensible à la casse, tandis qu’une valeur encadrée par des barres obliques comme/foo/icorrespond à une expression régulière. Incluez le drapeauipour une correspondance regex insensible à la casse.
Extensions
Depuis le répertoire racine de Discourse :
bin/qunit plugins/chat/test/javascripts/unit/lib/chat-audio-test.js # Exécuter un fichier
bin/qunit plugins/chat/test/javascripts/unit # Exécuter un répertoire
bin/rake "plugin:qunit" # Exécuter tous les tests qunit des extensions
bin/rake "plugin:qunit[discourse-chat-integration]" # Exécuter les tests qunit d'une seule extension
Thèmes
Depuis le répertoire racine de Discourse :
bin/rake "themes:qunit[url,<theme_url>]"
bin/rake "themes:qunit[name,<theme_name>]"
bin/rake "themes:qunit[id,<theme_id>]"
Ce document est sous contrôle de version - proposez des modifications sur github.