Cómo ejecutar las suites de pruebas QUnit de Discourse core, plugins y temas

Discourse cuenta con extensas pruebas de frontend para el núcleo, los plugins y los temas. Una vez que tengas un entorno de desarrollo local funcional, puedes ejecutar esas pruebas localmente de varias maneras.

Ejecutar pruebas en el navegador

Núcleo / Plugins: visita /tests en tu entorno de desarrollo

Temas: visita /theme-qunit en tu entorno de desarrollo (o producción), y luego elige el tema

En general, al trabajar en pruebas del núcleo, debes elegir “core” en el menú desplegable “Target”, y cuando trabajes en plugins, debes elegir el plugin específico.

:information_source: Lamentablemente, en el momento de redactar este documento, las fugas de memoria en nuestras pruebas hacen que intentar ejecutar toda la suite en un solo navegador supere el límite de memoria del navegador. Para ejecutar toda la suite en múltiples navegadores en paralelo, consulta los ejemplos de la CLI a continuación.

Ejecutar pruebas desde la CLI

Núcleo

Desde el directorio raíz de Discourse, usa bin/qunit (asegúrate de haber ejecutado pnpm install desde la última vez que incorporaste cambios desde el repositorio upstream). Envuelve Ember Exam para la aleatorización y la paralelización, y por defecto se ejecuta contra el servidor Rails en ejecución y los recursos JS existentes. Ejecuta bin/qunit --help para ver la lista completa de opciones.

Aquí tienes algunos ejemplos útiles:

# Ejecutar un único archivo de prueba, o todas las pruebas de un directorio:
bin/qunit frontend/discourse/tests/integration/components/bookmark-test.gjs
bin/qunit frontend/discourse/tests/integration/components

# Ejecutar toda la suite del núcleo en 5 instancias sin interfaz gráfica (headless) de Chrome en paralelo:
bin/qunit --parallel 5

# Ejecutar todas las pruebas cuyo "módulo: nombre de la prueba" contenga una subcadena (sin distinción de mayúsculas y minúsculas):
bin/qunit --filter "Integration | Component | bookmark"

# Enmarcar el valor entre barras para coincidir con una expresión regular, p. ej. para alternancia:
bin/qunit --filter "/bookmark|reaction/i"

# Iniciar un servidor aislado y ejecutarlo en un navegador visible para facilitar la depuración:
bin/qunit --standalone --no-headless

:information_source: --filter se pasa a QUnit: un valor simple coincide como subcadena sin distinción de mayúsculas y minúsculas, mientras que un valor enmarcado entre barras como /foo/i coincide como una expresión regular. Incluye la bandera i para una coincidencia de expresión regular sin distinción de mayúsculas y minúsculas.

Plugins

Desde el directorio raíz de Discourse:

bin/qunit plugins/chat/test/javascripts/unit/lib/chat-audio-test.js # Ejecutar un archivo
bin/qunit plugins/chat/test/javascripts/unit # Ejecutar un directorio
bin/rake "plugin:qunit" # Ejecutar todas las pruebas qunit de los plugins
bin/rake "plugin:qunit[discourse-chat-integration]" # Ejecutar las pruebas qunit de un solo plugin

Temas

Desde el directorio raíz de Discourse:

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

Este documento está bajo control de versiones - sugiere cambios en github.

20 Me gusta