¿Sus pruebas de Cypress son lentas? Cómo acelerar Cypress
Última actualización
Si sus pruebas de Cypress son lentas, normalmente puede acelerarlas iniciando sesión mediante programación, eliminando esperas fijas, ejecutando una aplicación compilada y dividiendo las specs entre trabajos paralelos. Esta guía explica cada solución y muestra cómo ejecutar pruebas paralelas de Cypress en GitHub Actions, con y sin Cypress Cloud. Forma parte de la guía de pruebas e2e lentas.
Por qué Cypress es lento
Cypress ejecuta una spec a la vez por proceso, en un único navegador, y cada archivo de spec vuelve a cargar la aplicación para cada prueba. Dos factores se multiplican: un inicio de sesión o una preparación largos en beforeEach, y las llamadas fijas a cy.wait(ms). Antes de cambiar nada, registre qué specs son las más lentas. El resumen de ejecución de Cypress muestra la duración de cada spec; ordénelas por ese dato.
Solución 1: iniciar sesión sin pasar por la interfaz
Use cy.session para iniciar sesión una vez por ejecución de spec y restaurar después las cookies y el almacenamiento, y use cy.request para la propia llamada de inicio de sesión, en lugar de escribir en un formulario:
Cypress.Commands.add("login", (email: string, password: string) => {
cy.session([email], () => {
cy.request("POST", "/api/login", { email, password });
});
});
Cree los datos de prueba de la misma forma: cy.request a un endpoint de la API o cy.task para cargar la base de datos, en lugar de hacer clic en formularios.
Solución 2: eliminar las esperas fijas
cy.wait(5000) cuesta 5 segundos cada vez. Cypress reintenta automáticamente las aserciones, así que compruebe el resultado. Cuando sea necesario esperar una llamada de red, asígnele un alias con cy.intercept y espere por ese alias:
cy.intercept("GET", "/api/orders*").as("orders");
cy.visit("/orders");
cy.wait("@orders");
cy.get("[data-cy=order-row]").should("have.length.at.least", 1);
Simule las llamadas lentas de terceros (mapas, analítica, entornos de pruebas de pagos) con cy.intercept para que las pruebas no dependan de ellas.
Solución 3: ejecutar contra una compilación de producción
Un servidor de desarrollo compila bajo demanda, así que la primera visita a cada ruta es lenta. En CI, compile una vez, sirva la compilación y ejecute Cypress contra ella. Con la acción oficial, los pasos build y start se ejecutan por usted:
- uses: cypress-io/github-action@v6
with:
build: npm run build
start: npm run start
wait-on: "http://localhost:3000"
Solución 4: dividir las specs grandes y probar lo correcto
Las specs largas con 40 pruebas son difíciles de paralelizar. Mantenga las specs centradas y traslade las comprobaciones de lógica a pruebas unitarias o de componentes. Las pruebas de componentes de Cypress ejecutan componentes sin cargar la aplicación completa y son mucho más rápidas para los estados de la interfaz. Consulte pruebas unitarias frente a pruebas e2e.
Pruebas paralelas de Cypress en GitHub Actions
Opción A: Cypress Cloud
Cypress Cloud reparte las specs entre máquinas usando tiempos históricos. Necesita una clave de registro y el mismo ID de compilación en cada máquina; la acción oficial se encarga de ello:
jobs:
cypress:
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
containers: [1, 2, 3, 4]
steps:
- uses: actions/checkout@v4
- uses: cypress-io/github-action@v6
with:
build: npm run build
start: npm run start
record: true
parallel: true
group: e2e
env:
CYPRESS_RECORD_KEY: ${{ secrets.CYPRESS_RECORD_KEY }}
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
Cypress Cloud es un servicio de pago con un nivel gratuito; consulte sus límites actuales en su propia página de precios.
Opción B: dividir las specs usted mismo, sin Cloud
El plugin de código abierto cypress-split reparte los archivos de spec entre una matriz usando variables de entorno. Configúrelo en cypress.config.ts y pase el índice del trabajo y el total:
strategy:
fail-fast: false
matrix:
index: [0, 1, 2, 3]
steps:
- uses: cypress-io/github-action@v6
with:
build: npm run build
start: npm run start
env:
SPLIT: 4
SPLIT_INDEX: ${{ matrix.index }}
Consulte el README del plugin para la configuración exacta según su versión de Cypress. Dividir por número de archivos no equilibra los tiempos, así que coloque las specs más lentas en archivos separados. La guía de sharding de pruebas explica el equilibrado, y el planificador estima el número de shards y el coste.
Instalar y cachear correctamente
Cachee la caché de npm y el binario de Cypress (~/.cache/Cypress). La acción oficial hace ambas cosas por usted. Use npm ci, no npm install. Si su trabajo descarga el binario de Cypress en cada ejecución, el registro lo mostrará; solucione eso primero.
Use más CPU
Cypress ejecuta un navegador más su aplicación en una sola máquina, y un runner de 2 vCPU puede convertirse en el cuello de botella, lo que provoca timeouts que parecen tests inestables. Compare más núcleos en runners más rápidos de GitHub Actions. compiler.dev fue en mediana 1.5× más rápido en 18 stacks medidos (15 más rápidos, 2 iguales, 1 más lento) que el runner de 2 núcleos de GitHub, y el modo de comparación mide sus propios jobs. Relacionado: tests de Playwright lentos, tests e2e inestables y el centro de CI lento.
Preguntas frecuentes
¿Cómo acelero Cypress?
Inicie sesión con cy.session y cy.request, elimine las esperas fijas, pruebe una compilación de producción y ejecute las specs en paralelo en varios trabajos.
¿Puedo ejecutar pruebas paralelas de Cypress sin Cypress Cloud?
Sí. Reparta los archivos de spec en una matriz con un plugin como cypress-split, o escriba su propio script que asigne los archivos de spec a un índice de trabajo. Pierde el equilibrado automático basado en tiempos.
¿Por qué mis pruebas de Cypress son más lentas en CI?
Los runners de CI son más pequeños e inician en frío. Revise el uso de CPU, la descarga del binario y si está ejecutando contra un servidor de desarrollo.
¿Es Cypress más lento que Playwright?
Depende de la suite. Ambos son rápidos si están bien configurados; compárelos con sus propias pruebas y consulte pruebas de Playwright lentas para sus equivalentes.
Relacionado
- ¿Docker build lento en CI? Encuentre la causa y solúvala¿Builds de Docker lentos en CI? Revise el tamaño del contexto, .dockerignore, el orden de capas, fallos de caché y BuildKit. Corrija primero lo más costoso.
- Pruebas E2E inestables: causas y soluciones duraderasPruebas e2e inestables: corrija esperas incorrectas, aísle las pruebas y el estado compartido de la base de datos, y use reintentos sin ocultar errores.
- ¿Jest lento? Acelere los tests de Jest: workers y --shard¿Pruebas Jest lentas? Acelérelas con un transform de TypeScript más rápido, el número de workers adecuado y --shard en CI. Encuentre antes las más lentas.
- ¿Playwright lento en CI? Solucione con workers y sharding¿Pruebas de Playwright lentas en CI? Acelérelas con más workers, storageState reutilizado, navegadores en caché y sharding con --shard. Incluye Python.