Como executar as suítes de testes QUnit do núcleo do Discourse, plugins e temas

O Discourse possui testes de frontend abrangentes para o núcleo, plugins e temas. Depois de configurar um ambiente de desenvolvimento local funcional, esses testes podem ser executados localmente de várias maneiras diferentes.

Executando testes no navegador

Núcleo / Plugins: Acesse /tests no seu ambiente de desenvolvimento

Temas: Acesse /theme-qunit no seu ambiente de desenvolvimento (ou de produção) e escolha o tema

Em geral, ao trabalhar em testes do núcleo, você deve escolher “core” no menu suspenso “Target” (Alvo), e ao trabalhar em plugins, deve escolher o plugin específico.

:information_source: Infelizmente, no momento desta redação, vazamentos de memória em nossos testes fazem que tentar executar toda a suíte em um único navegador atinja o limite de memória do navegador. Para executar a suíte inteira em vários navegadores em paralelo, verifique os exemplos de CLI abaixo.

Executando testes via CLI

Núcleo

No diretório raiz do Discourse, use bin/qunit (certifique-se de ter executado pnpm install desde a última vez que puxou alterações upstream). Ele envolve o Ember Exam para randomização e paralelismo, e por padrão roda contra o servidor Rails em execução e os assets JS existentes. Execute bin/qunit --help para ver a lista completa de opções.

Aqui estão alguns exemplos úteis:

# Execute um arquivo de teste único, ou todos os testes em um diretório:
bin/qunit frontend/discourse/tests/integration/components/bookmark-test.gjs
bin/qunit frontend/discourse/tests/integration/components

# Execute toda a suíte do núcleo em 5 instâncias do Chrome headless em paralelo:
bin/qunit --parallel 5

# Execute todos os testes cujo "módulo: nome do teste" contenha uma substring (não diferencia maiúsculas/minúsculas):
bin/qunit --filter "Integration | Component | bookmark"

# Use a notação de regex (entre barras) para corresponder a uma expressão regular, por exemplo, para alternância:
bin/qunit --filter "/bookmark|reaction/i"

# Inicie um servidor isolado e execute em um navegador visível para facilitar a depuração:
bin/qunit --standalone --no-headless

:information_source: --filter é encaminhado para o QUnit: um valor simples corresponde como uma substring que não diferencia maiúsculas/minúsculas, enquanto um valor entre barras como /foo/i corresponde como uma expressão regular. Inclua a flag i para correspondência de regex que não diferencia maiúsculas/minúsculas.

Plugins

No diretório raiz do Discourse:

bin/qunit plugins/chat/test/javascripts/unit/lib/chat-audio-test.js # Execute um arquivo
bin/qunit plugins/chat/test/javascripts/unit # Execute um diretório
bin/rake "plugin:qunit" # Execute todos os testes qunit de plugins
bin/rake "plugin:qunit[discourse-chat-integration]" # Execute os testes qunit de um único plugin

Temas

No diretório raiz do Discourse:

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

Este documento é controlado por versão - sugira mudanças no github.

20 curtidas