NEBULA ERP · Suite E2E
Punto de partida para ejecutar, depurar y agregar pruebas en nebula-shell-e2e. Desde aquí puedes guiarte para correr las pruebas existentes o crear nuevas siguiendo la misma estructura.
Todas las pruebas viven bajo:
apps/nebula-shell-e2e/
├── playwright.config.ts ← Configuración global
└── src/
├── support/
│ └── sesión-e2e.ts ← Helpers de sesión (login, setup)
├── invoicing-concepts-credit-notes-mock.spec.ts
├── invoicing-concepts-related-mock.spec.ts
├── invoicing-concepts-impairment-mock.spec.ts
├── invoicing-concepts-revenue-mock.spec.ts
├── invoicing-concepts-revenue-api-dev.spec.ts
├── invoicing-parameters-mock.spec.ts
├── invoicing-parameters-api-dev.spec.ts
├── invoicing-parameters-tab-fecha-mock.spec.ts
└── invoicing-parameters-tab-general-mock.spec.ts
Sufijo
Significado
-mock.spec.ts
Prueba que usa datos mockeados (no depende del backend real)
-api-dev.spec.ts
Prueba que consume el API real de desarrollo
-tab-<nombre>-mock.spec.ts
Prueba enfocada en una pestaña específica con mocks
support/*.ts
Helpers reutilizables (no se ejecutan como tests)
npx playwright test -c apps/nebula-shell-e2e/playwright.config.ts <archivo> --project=chromium --reporter=line
Parte
Qué hace
npx playwright test
Ejecuta el runner de Playwright
-c apps/nebula-shell-e2e/playwright.config.ts
Apunta a la config del proyecto (no usa la raíz)
<archivo>
Ruta del .spec.ts a ejecutar
--project=chromium
Fuerza el navegador Chromium
--reporter=line
Salida compacta (ideal para terminal/CI)
npx playwright test -c apps/nebula-shell-e2e/playwright.config.ts apps/nebula-shell-e2e/src/invoicing-concepts-credit-notes-mock.spec.ts --project=chromium --reporter=line
# Todas las de invoicing-concepts
npx playwright test -c apps/nebula-shell-e2e/playwright.config.ts invoicing-concepts --project=chromium --reporter=line
# Todas las de invoicing-parameters
npx playwright test -c apps/nebula-shell-e2e/playwright.config.ts invoicing-parameters --project=chromium --reporter=line
npx playwright test -c apps/nebula-shell-e2e/playwright.config.ts ".*-mock\.spec\.ts" --project=chromium --reporter=line
npx playwright test -c apps/nebula-shell-e2e/playwright.config.ts ".*-api-dev\.spec\.ts" --project=chromium --reporter=line
npx playwright test -c apps/nebula-shell-e2e/playwright.config.ts \
apps/nebula-shell-e2e/src/invoicing-concepts-credit-notes-mock.spec.ts \
apps/nebula-shell-e2e/src/invoicing-concepts-related-mock.spec.ts \
apps/nebula-shell-e2e/src/invoicing-concepts-impairment-mock.spec.ts \
--project=chromium --reporter=line
# Solo tests que contengan "credit" en el título
npx playwright test -c apps/nebula-shell-e2e/playwright.config.ts -g "credit" --project=chromium --reporter=line
Comando
Cuándo usarlo
--ui
Modo interactivo con interfaz gráfica. Recomendado para desarrollar nuevos tests.
--headed
Ver el navegador mientras corre (útil para entender qué pasa).
--debug
Abre el inspector de Playwright paso a paso.
--workers=1
Fuerza ejecución secuencial (evita condiciones de carrera).
--timeout=90000
Aumenta el timeout por test (útil si el ERP tarda en cargar).
Ejemplo combinado:
npx playwright test -c apps/nebula-shell-e2e/playwright.config.ts apps/nebula-shell-e2e/src/invoicing-concepts-revenue-mock.spec.ts --project=chromium --headed --workers=1 --timeout=90000
--reporter=line # Compacto (recomendado para terminal y CI)
--reporter=list # Detallado, con cada test
--reporter=html # Genera reporte HTML navegable
--reporter=json # Salida JSON (para integraciones)
Al terminar con html:
npx playwright show-report
Flag
Efecto
--max-failures=1
Detiene la ejecución al primer fallo
--retries=2
Reintenta tests fallidos N veces
--workers=4
Paralelismo (más rápido, más recursos)
--quiet
Silencia salida innecesaria
--update-snapshots
Actualiza snapshots visuales
package.jsonPara no repetir el -c apps/nebula-shell-e2e/playwright.config.ts cada vez:
{
"scripts": {
"e2e": "playwright test -c apps/nebula-shell-e2e/playwright.config.ts --project=chromium --reporter=line",
"e2e:ui": "playwright test -c apps/nebula-shell-e2e/playwright.config.ts --project=chromium --ui",
"e2e:headed": "playwright test -c apps/nebula-shell-e2e/playwright.config.ts --project=chromium --headed --workers=1",
"e2e:mock": "playwright test -c apps/nebula-shell-e2e/playwright.config.ts -g mock --project=chromium --reporter=line",
"e2e:api-dev": "playwright test -c apps/nebula-shell-e2e/playwright.config.ts -g api-dev --project=chromium --reporter=line"
}
}
Uso simplificado:
npm run e2e -- invoicing-concepts-credit-notes-mock.spec.ts
npm run e2e:ui -- invoicing-concepts-related-mock.spec.ts
npm run e2e:mock
npm run e2e:api-dev
Identifica el módulo al que pertenece (ej: invoicing-concepts, invoicing-parameters).
Copia un spec existente similar como plantilla:
*-mock.spec.ts*-api-dev.spec.tsNombra el archivo siguiendo la convención:
<módulo>-<caso>-(mock|api-dev).spec.ts
Reutiliza helpers de src/support/sesion-e2e.ts (login, navegación, setup común).
Ejecuta en modo UI primero para iterar rápido:
npm run e2e:ui -- <tu-nuevo-archivo>.spec.ts
Cuando pase, corre en modo normal con --reporter=line para validar en CI.
-mock o -api-dev).--project=chromium.--workers=1 (sin condiciones de carrera).support/ cuando aplique.Si eres nuevo en el proyecto: empieza corriendo un *-mock.spec.ts con el comando base, luego prueba --ui para verlo en acción. Cuando entiendas el flujo, copia ese archivo como plantilla para tu nuevo test. Desde esta guía puedes guiarte para ejecutar, depurar y extender la suite E2E de NEBULA ERP.
apps/nebula-shell-e2e/src/invoicing-concepts-credit-notes-mock.spec.ts
apps/nebula-shell-e2e/src/invoicing-concepts-related-mock.spec.ts
apps/nebula-shell-e2e/src/invoicing-concepts-impairment-mock.spec.ts
apps/nebula-shell-e2e/src/invoicing-concepts-revenue-mock.spec.ts
apps/nebula-shell-e2e/src/invoicing-concepts-revenue-api-dev.spec.ts
apps/nebula-shell-e2e/src/invoicing-parameters-mock.spec.ts
apps/nebula-shell-e2e/src/invoicing-parameters-api-dev.spec.ts
apps/nebula-shell-e2e/src/invoicing-parameters-tab-fecha-mock.spec.ts
apps/nebula-shell-e2e/src/invoicing-parameters-tab-general-mock.spec.ts
Guía creada para el equipo de NEBULA ERP · Última actualización: suite E2E nebula-shell-e2e