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.
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
![]()
--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/icorresponde como uma expressão regular. Inclua a flagipara 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.