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
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:
Adicionalmente agregamos otro comando para ejecutar cypress sin levantar el runner a través del Cypress CLI:
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:
Ejecutando Cypress desde la terminal
También es posible ejecutar más rapidamente Cypress ejecutando el comando npx
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:
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
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. 😄
ℹ️ 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
