Discourse verfügt über umfangreiche Frontend-Tests für Core, Plugins und Themes. Sobald Sie eine funktionsfähige lokale Entwicklungsumgebung eingerichtet haben, können diese Tests auf verschiedene Weisen lokal ausgeführt werden.
Tests im Browser ausführen
Core / Plugins: Besuchen Sie /tests in Ihrer Entwicklungsumgebung
Themes: Besuchen Sie /theme-qunit in Ihrer Entwicklungs- (oder Produktions-)Umgebung und wählen Sie anschließend das Theme aus
Allgemein gilt: Bei der Arbeit an Core-Tests sollten Sie “core” aus der Dropdown-Liste “Target” auswählen, und bei der Arbeit an Plugins sollten Sie das jeweilige spezifische Plugin auswählen.
Leider bedeutet ein Speicherleck in unseren Tests zum Zeitpunkt der Erstellung dieses Dokuments, dass der Versuch, die gesamte Testsuite in einem einzigen Browser auszuführen, häufig das Speicherlimit des Browsers erreicht. Um die gesamte Suite parallel über mehrere Browser hinweg auszuführen, siehe die CLI-Beispiele unten.
Tests auf der Befehlszeile (CLI) ausführen
Core
Geben Sie im Stammverzeichnis von Discourse bin/qunit ein (stellen Sie sicher, dass Sie pnpm install ausgeführt haben, seit Sie die letzten Upstream-Änderungen übernommen haben). Es kapselt Ember Exam für Randomisierung und Parallelisierung und führt standardmäßig gegen den laufenden Rails-Server und die vorhandenen JS-Assets aus. Führen Sie bin/qunit --help aus, um die vollständige Liste der Optionen anzuzeigen.
Hier sind einige nützliche Beispiele:
# Eine einzelne Testdatei oder alle Tests in einem Verzeichnis ausführen:
bin/qunit frontend/discourse/tests/integration/components/bookmark-test.gjs
bin/qunit frontend/discourse/tests/integration/components
# Die gesamte Core-Suite parallel über 5 headless Chrome-Instanzen ausführen:
bin/qunit --parallel 5
# Alle Tests ausführen, deren "Modul: Testname" eine bestimmte Zeichenkette enthält (Groß-/Kleinschreibung ignoriert):
bin/qunit --filter "Integration | Component | bookmark"
# Umschließen Sie den Wert mit Schrägstrichen, um einen regulären Ausdruck zu verwenden, z.B. für Alternation:
bin/qunit --filter "/bookmark|reaction/i"
# Starten Sie einen isolierten Server und führen Sie die Tests in einem sichtbaren Browser aus, um das Debugging zu erleichtern:
bin/qunit --standalone --no-headless
![]()
--filterwird an QUnit weitergegeben: Ein einfacher Wert wird als Zeichenkette (case-insensitive) abgeglichen, während ein von Schrägstrichen umschlossener Wert wie/foo/ials regulärer Ausdruck abgeglichen wird. Fügen Sie den Flagihinzu, um case-insensitive Regex-Matching zu aktivieren.
Plugins
Im Stammverzeichnis von Discourse:
bin/qunit plugins/chat/test/javascripts/unit/lib/chat-audio-test.js # Eine einzelne Datei ausführen
bin/qunit plugins/chat/test/javascripts/unit # Ein Verzeichnis ausführen
bin/rake "plugin:qunit" # Alle qunit-Tests der Plugins ausführen
bin/rake "plugin:qunit[discourse-chat-integration]" # qunit-Tests eines einzelnen Plugins ausführen
Themes
Im Stammverzeichnis von Discourse:
bin/rake "themes:qunit[url,<theme_url>]"
bin/rake "themes:qunit[name,<theme_name>]"
bin/rake "themes:qunit[id,<theme_id>]"
Dieses Dokument ist versionskontrolliert – schlagen Sie Änderungen auf GitHub vor.