🧪Testing Automation - Cypress 13👨🏻‍🚀 + TypeScript

Cypress es el MEJOR FRAMEWORK DE AUTOMATION E2E actualmente! No hay rival! Además de que es el framework más amigable para aprender! Aunque no es el único E2E en el mercado, y tampoco es el más usado como sí lo es Selenium. Pero es el MÁS POPULAR!

Cypress es un Framework de Automatización de Next Generation construido para web modernas. Esto es im simple proyecto el cual puedes usarlo para comenzar tu viaje por la Galaxia de la Automatización!

NUEVA ESTRUCTURA DE PROYECTO

Ahora el Directorio de UPEX Galaxy, será mucho más simple.

Para la carpeta Tests:
- Cada Suite de US, deberá ser guardado en una carpeta del Componente correspondiente del SUT (ej: ShoppingCart),
- y la nomenclatura de archivos cambia a ser más directa:
```
{GX-ID}-{NombreCortoDeLaStory}

como ejemplo: "GX-5-AgregarItemAlCart.cy.ts".

ejemplo de estructura:
/Tests
	├───BookStore
	│       GX-6309-CrearObtenerLibros.cy.ts
```
En cuanto a la carpeta cucumber-tests:
- Tendrán una mejor distribución de archivos; por carpetas separadas: Todos los archivos .feature dentro de la carpeta "Gherkin" y los archivos .ts dentro de "stepDefinitions" como tiene que ser.
```
* ejemplo de Estructura Cucumber:

/cucumber-test
	├───Gherkin
	│       GX-2_StoryTestSuite.feature
	│
	└───stepDefinitions
			GX-2_StoryTestSuite.ts
```
- La Nomenclatura de éste tipo de prueba se mantiene igual al normal (la misma nomenclatura mencionada arriba).

RESUMEN:

CÓMO EMPEZAR:

Clona el Proyecto:

git clone https://github.com/upex-galaxy/L1-cypex-demo.git

Instala todas las dependencias:
```
npm ci
```
- (el commando ci es para instalar todas las Dependencias Locked del Proyecto)

Para abrir la App de Cypress, corre el comando:
```
npm test
```
- también puede usar npx cypress open (ya que en Package.json tenemos la variable "test" como el "cypress open") para abrir Cypress.

Para correr pruebas y generar Reportes XML y HTML, ejecuta:
```
npm run file */**/<filename>
```
- donde la variable "file" es: cypress run --browser chrome --reporter cypress-multi-reporters --reporter-options configFile=jsconfig.json --record --key {key} --spec, cuyo atajo es para que podamos correr las pruebas de un directorio que especifiquemos, usando el navegador de Chrome, generando 1 Reporte XML para importar a Jira y otro para generar un hermoso html, y adicionalmente actualizar el Cypress Dashboard del Proyecto.

Para generar el archivo JSON Cucumber y Reporte HTML,
- Primero Descarga el Formatter según tu OS:
- Luego mueve el archivo descargado a la carpeta cucumber-formatter de este proyecto en tu repositorio local
- y Sigue estas instrucciones de instalación: github.com/cucumber/json-formatter
- Modifica el archivo: .cypress-cucumber-preprocessorrc.json, para cambiar el nombre del formatter:
  - Renombra: cucumber-json-formatter.exe por cucumber-json-formatter si usas Linux o MacOs.
- Luego podrás generar archivo JSON de Cucumber para Importar las Pruebas a Jira.
- Para poder generar archivos HTML de Cucumber luego de correr las pruebas, Ejecuta:
```
npm run report:cucumber
```
  - donde la variable "report:cucumber" es igual a: node ./cucumber-html-report.ts cuyo atajo es para generar el Reporte Cucumber index.html en la carpeta reports/cucumber-html-report para evaluar TODOS el Resultado de Prueba Cucumber.

Para correr una REGRESIÓN y generar un solo Reporte HTML global, ejecuta:
```
npm run regression:report
```
Luego ejecuta estos comandos, uno por uno:
```
npm run report:json
npm run report:html
```
- Gracias a esto se va a generar un único Reporte mochawesome HTML para evaluar TODOS los Resultados de Prueba de la Regresión.

AHORA CON CYPRESS DASHBOARD, puedes ver todas las ejecuciones y resultados de prueba del proyecto! Visita: CYPRESS DASHBOARD

PLAN DE PRUEBA: ESTRATEGIA Y DISEÑO

🚩NORMATIVAS A SEGUIR:

Perfecta Nomenclatura del nombre de Archivo de prueba:
{GX-ID}-{StoryShortName}.{extensionFile} ej: GX-50-AgregarItemsAlCart.cy.ts
Archivo de Prueba dentro del directorio del Componente correspondiente, ejemplo:
cypress/e2e/Tests/ComponentName/GX-1-StoryTestSuite.cy.ts.
Buen diseño del Test Suite elaborado (Esto implica que se vean bien el código en general, que al menos funcione).
Tener el Markdown de la US en la carpeta Test-Plan en su correspondiente carpeta Sprint, ejemplo:
cypress/test-plan/in-sprint/sprint-9/userStory.md
Esto implica que cada vez que se trabaje en un Sprint nuevo, se debería crear la carpeta correspondiente "sprint-" + número del sprint, como se muestra en el ejemplo arriba.
NO usar fixture como PageObjectModel sino como Data (es decir, no agarrar elementos Web por fixtures, sino usar el Fixture para iterar Data o reutilizar variables).
- Previamente en GX, se usaba el patrón Fixture como POM, porque era fácil de aprender, pero hoy en día las entrevistas técnicas piden PageObject Model de la manera tradicional, sin usar Commands.
Los "Cypress Commands" no es un uso obligatorio; pero si se quiere usar, debería aplicarse para hacer funciones de algoritmos para múltiples suites o para generar precondiciones repetitivas (Background).
En caso de usar Fixtures: Chequear que el archivo ".json" esté dentro de la carpeta correspondiente al componente, ejemplo:
cypress/fixtures/account/example.json.
En caso de usar PageObjectModel: Chequear que el "Page.ts" esté dentro de la carpeta "pages" en la de "support", ejemplo:
cypress/support/pages/example.Page.ts.
En caso de usar Commands: Asegurarse de aplicarlo para crear pasos de Precondiciones o Scripts de Algoritmos complejos (NO USAR como Pasos de Acción, eso sería tarea para el POM).
En caso de usar el CI Pipeline: Usar únicamente el archivo predeterminado del proyecto sanity.yml, y asegurarse de modificarlo correctamente (Solo cambiar el Path del Test Suite y el parámetro de Importación TX para Jira) y no borrar o cambiar nada más, que funcione y pase los Checks. El archivo regression.yml se ejecutará automaticamente cuando los cambios hayan mergeado a QA.
En caso de usar Cucumber: Chequear que el archivo Gherkin (.feature) y los StepDefinitions (.ts) estén correctamente diseñados y que la Ejecución en CI funcione y pase los Checks.

🚩NIVELES DE TESTER QA en UPEX Galaxy:

El programa UPEX Galaxy está diseñado para guiar a los Testers a través de 2 Etapas (Career Paths). Cada Etapa conlleva ciertos NIVELES que el Tester debe alcanzar para llegar a su mayor SENIORITY:

QA Engineer (Pruebas Manuales)

Capacidad de realizar análisis, planificación, ejecución y gestión de:

Pruebas Manuales de UI
Bases de Datos
API Testing

🧪L1

Capaz de realizar tareas (US) sencillas de frontend sin mucha complejidad.

Prácticas:

Entiende y puede seguir guías y protocolos de prueba previamente definidos.
Identifica errores obvios en la interfaz y reporta con claridad.
Familiarizado con herramientas básicas de testing y reporting.
Capaz de realizar pruebas de regresión siguiendo casos de prueba definidos.

🧪L2

Capaz de realizar tareas (US) avanzadas de frontend y también tareas de Backend (Pruebas de Bases de Datos y Pruebas de API).

Prácticas:

Realiza pruebas exploratorias identificando puntos críticos en las aplicaciones.
Puede diseñar casos de prueba simples basados en requisitos.
Familiarizado con SQL básico para realizar pruebas en Bases de Datos.
Inicia pruebas básicas en APIs usando herramientas como Postman o similares.
Entiende la importancia de ciclos de vida de defectos y los gestiona correctamente.

🧪L3

Capaz de realizar tareas (US) de performance y/o diseñar nuevas Historias de Usuario.

Prácticas:

Diseña y ajusta casos de prueba complejos basados en cambios de requisitos.
Identifica y reporta problemas de rendimiento usando herramientas básicas.
Realiza pruebas exploratorias avanzadas e identifica áreas no cubiertas.
Gestiona los Planes de Prueba (Cobertura, Regresión, Sanity, Smoke) de manera efectiva.
Ofrece guía y mentoría a testers de niveles inferiores (Capacidad de ser Tutor).
Tiene una comprensión básica sobre automatización de pruebas.

QA Automation Engineer (Pruebas Automatizadas)

Capacidad de realizar análisis, planificación, ejecución y gestión de:

Pruebas Automatizadas de E2E
Integration Testing (Aplicando para cualquiera de los Frameworks de automatización de Browsers/Apps)

🧪L3

Capaz de realizar tareas (TechDept) para Automatizar pruebas UI de historias implementadas.

Prácticas:

Capaz de manejar el flujo completo de trabajo ordinario.
Capaz de realizar pruebas Frontend con data sin iteración (hardcodeada).
Capaz de realizar Page-Object-Model básico.
Capaz de realizar controles de versionado de código (conocimiento básico en GIT).

🧪L4

Capaz de realizar tareas (TD) para Automatizar pruebas complejas y de integración de historias implementadas.

Prácticas:

Capacidad de resolución de problemas y conflictos de pruebas (Debugging).
Capaz de realizar pruebas E2E con data en iteración (Parametrizadas).
Capaz de escribir código con Excelentes prácticas y principios (POM, “DRY”, etc.).
Capaz de escribir scripts de prueba con Estructura de Datos, condicionales, bucles, etc.
Capaz de entender y ejecutar Pipelines de Regresión en Continuous Integration (CI).
Capaz de escribir scripts de prueba para intercepción y assertions de API Testing.

🧪L5

Capaz de realizar cualquier tarea (TD) de Automatización y gestionar los Planes de Prueba.

Prácticas:

Capacidad de resolución de conflictos de GIT con facilidad.
Capacidad de resolución de problemas de ambientes y errores de config del Repo.
Capaz de realizar Planes de Prueba generales y para Automatización de pruebas.
Capaz de planificar, armar y hacer funcionar los Repositorios de Automatización de Prueba.
Capaz de configurar integraciones de aplicaciones de Reporte de Prueba con el Repo.
Capaz de realizar pruebas automatizadas de Performance (con ciertas herramientas).

🧙🏻‍♂️APRENDE Y GANA EXPERIENCIA COMO QA AUTOMATION EN UPEX GALAXY🚀

Suscríbete a un Sprint y trabaja como un QA Automation Engineer!

🚩ENTRA EN UPEXDOCU Y BUSCA LAS GUÍAS DE CYPRESS AL GRANO!

CURSO YOUTUBE DE CYPRESS AL GRANO:

🛸SUPER RUTA: "AUTOMATION AL GRANO" (UPEX GALAXY)

upex-galaxy/cypress-ts

🧪Testing Automation - Cypress 13👨🏻‍🚀 + TypeScript

NUEVA ESTRUCTURA DE PROYECTO

RESUMEN:

CÓMO EMPEZAR:

PLAN DE PRUEBA: ESTRATEGIA Y DISEÑO

🚩NORMATIVAS A SEGUIR:

🚩NIVELES DE TESTER QA en UPEX Galaxy:

QA Engineer (Pruebas Manuales)

🧪L1

Prácticas:

🧪L2

Prácticas:

🧪L3

Prácticas:

QA Automation Engineer (Pruebas Automatizadas)

🧪L3

Prácticas:

🧪L4

Prácticas:

🧪L5

Prácticas:

🧙🏻‍♂️APRENDE Y GANA EXPERIENCIA COMO QA AUTOMATION EN UPEX GALAXY🚀

🚩ENTRA EN UPEXDOCU Y BUSCA LAS GUÍAS DE CYPRESS AL GRANO!

CURSO YOUTUBE DE CYPRESS AL GRANO: