Come eseguire le suite di test QUnit del core, dei plugin e dei temi di Discourse

Discourse dispone di estesi test di frontend per il core, i plugin e i temi. Una volta che hai un ambiente di sviluppo locale funzionante, questi test possono essere eseguiti localmente in diversi modi.

Esecuzione dei test nel browser

Core / Plugin: visita /tests nel tuo ambiente di sviluppo

Temi: visita /theme-qunit nel tuo ambiente di sviluppo (o di produzione) e seleziona il tema

In generale, quando lavori sui test del core dovresti selezionare “core” dal menu a tendina “Target” (Destinazione), e quando lavori sui plugin dovresti selezionare il plugin specifico.

:information_source: Purtroppo, al momento della stesura di questo documento, le perdite di memoria nei nostri test fanno sì che tentare di eseguire l’intera suite in un singolo browser tenda a raggiungere il limite di memoria del browser. Per eseguire l’intera suite su più browser in parallelo, consulta gli esempi CLI riportati di seguito.

Esecuzione dei test tramite CLI

Core

Dalla directory radice di Discourse, usa bin/qunit (assicurati di aver eseguito pnpm install da quando hai aggiornato con le modifiche upstream). Questo strumento incapsula Ember Exam per la randomizzazione e la parallelizzazione, e per impostazione predefinita viene eseguito contro il server Rails in esecuzione e gli asset JS esistenti. Esegui bin/qunit --help per l’elenco completo delle opzioni.

Ecco alcuni utili esempi:

# Esegui un singolo file di test, oppure tutti i test in una directory:
bin/qunit frontend/discourse/tests/integration/components/bookmark-test.gjs
bin/qunit frontend/discourse/tests/integration/components

# Esegui l'intera suite core su 5 istanze headless di Chrome in parallelo:
bin/qunit --parallel 5

# Esegui tutti i test il cui "modulo: nome del test" contiene una sottostringa (senza distinzione tra maiuscole e minuscole):
bin/qunit --filter "Integration | Component | bookmark"

# Delimita con barre (/) il valore da abbinare con un'espressione regolare, ad esempio per un'alternativa:
bin/qunit --filter "/bookmark|reaction/i"

# Avvia un server isolato e esegui in un browser visibile per un debug più semplice:
bin/qunit --standalone --no-headless

:information_source: --filter viene trasmesso a QUnit: un valore semplice corrisponde come sottostringa senza distinzione tra maiuscole e minuscole, mentre un valore delimitato da barre come /foo/i corrisponde come espressione regolare. Includi il flag i per l’abbinamento regex senza distinzione tra maiuscole e minuscole.

Plugin

Dalla directory radice di Discourse:

bin/qunit plugins/chat/test/javascripts/unit/lib/chat-audio-test.js # Esegui un file
bin/qunit plugins/chat/test/javascripts/unit # Esegui una directory
bin/rake "plugin:qunit" # Esegui tutti i test QUnit dei plugin
bin/rake "plugin:qunit[discourse-chat-integration]" # Esegui i test QUnit di un singolo plugin

Temi

Dalla directory radice di Discourse:

bin/rake "themes:qunit[url,<theme_url>]"
bin/rake "themes:qunit[name,<theme_name>]"
bin/rake "themes:qunit[id,<theme_id>]"

Questo documento è sotto controllo di versione - suggerisci modifiche su github.

20 Mi Piace