6. Setting up Cypress

Precondiciones

Cypress.io es una aplicación GUI Test Runner que se instala en la computadora de manera muy sencilla en cualquier de los sistemas operativos:

Sistemas operativos soportados por Cypress macOS 10.9 and above (64-bit only) Linux Ubuntu 12.04 and above, Fedora 21 and Debian 8 (64-bit only) Windows 7 and above

Detrás de Cypress hay un proceso de Node.js donde se comunican, sincronizan y realizan tareas constantemente en nombre de cada uno. Por lo tanto, para ejecutar Cypress se necesita los siguientes paquetes:

Prerrequisitos para instalar Cypress Tener instalado Node.js y el paquete NPM: https://nodejs.org/en/download/ Para verificar que ambos paquetes están instalados: node - v npm -v

Si tienes alguna duda de cómo instalar estos dos paquetes, puede seguir este tutorial: https://blog.teamtreehouse.com/install-node-js-npm-windows

Instalación de Cypress

Es tan sencillo como abrir la carpeta del proyecto donde queremos instalar Cypress y ejecutamos el siguiente comando utilizando la herramienta npm

npm install cypress --save-dev

Luego debemos crear el archivo package.json para configurar las dependencias de Cypress a través del siguiente comando:

npm init

De esta forma Cypress se instalará en el directorio ./node_modules

Cypress.io instalado en el workspace

Antes de ejecutar Cypress, es importante modificar el archivo package.json con el fin de agregar un comando en el apartado "scripts" que nos permita abrir Cypress de una manera más sencilla:

"cypress:open": "cypress open"

Adicionalmente agregamos otro comando para ejecutar cypress sin levantar el runner a través del Cypress CLI:

"test": "cypress run spec"

Finalmente el archivo podría quedar así como la siguiente imagen

Archivo package.json con las configuraciones adicionales

Ahora ya podemos ejecutar Cypress framework todas las veces que queramos simplemente escribiendo en la terminal el siguiente comando:

npm run cypress:open

Ejecutando Cypress desde la terminal

También es posible ejecutar más rapidamente Cypress ejecutando el comando npx

npx cypress open

Cada vez que iniciemos Cypress con el comando se abrirá el Test Runner de Cypress

El Test Runner de Cypress inicializado

Instalación de Cypress-Axe Plugin

Por supuesto, para poner en práctica las pruebas automáticas de accessibilidad debemos instalar el paquete cypress-axe con el siguiente comando:

npm i -D cypress-axe@latest

Ahora es sólo esperar que el proceso de instalación este completo, y luego el proyecto ya está listo con las dependencias correctas para iniciar con las pruebas automatizadas de Accessibilidad.

La dependencia cypress-axe instalado correctamente en el archivo package.json

Para usar Cypress-Axe en este proyecto, tengo una configuración más que necesito mostrarte.

Dentro de la carpeta de support debes encontrar el archivo support/index.js

Ahora, debes agregar la declaración import para poder importar correctamente el paquete cypress-axe

import 'cypress-axe';

El paquete es importado dentro del archivo index.js

Este comando básicamente nos permitirá extender el comportamiento predeterminado de Cypress y usar los comandos adicionales que necesitaremos de Cypress-Axe.

Ahora si ya estamos listos para iniciar con las pruebas automatizadas de Accessibilidad. 😄

☝️ Si deseas conocer más detalles de como instalar Cypress.io puedes ir directamente a la documentación oficial: https://docs.cypress.io/guides/getting-started/installing-cypress.html#Opening-Cypress

ℹ️ También puedes visitar la documentación oficial de Cypress-Axe para conocer más detalles de su instalación y aplicación en los proyectos: https://github.com/component-driven/cypress-axe