Tests E2E lentos: por qué retrasan y cómo solucionarlo
Última actualización
Los tests e2e lentos son la razón más común por la que un pull request tarda 30 minutos en quedar en verde. Si sus tests e2e son lentos, también lo serán sus tests de integración lentos y, probablemente, sus tests lentos en general: las causas se solapan. Esta guía es el punto de partida del tema. Le muestra cómo encontrar dónde se va el tiempo y luego le indica la solución para cada framework.
¿Por qué son lentos los tests e2e?
Los tests de extremo a extremo controlan un navegador real contra una aplicación real, así que cada test asume trabajo que un test unitario nunca hace. El tiempo suele ir a:
- Arrancar cosas: el servidor de la aplicación, la base de datos, el navegador y el inicio de sesión. Si se hace por test en lugar de una sola vez, esto domina el tiempo total.
- Esperas fijas:
sleep(5000)owaitForTimeoutdonde bastaría con esperar a un evento. Cada una se paga en cada ejecución, incluso cuando la página estaba lista en 200 ms. - Ejecución en serie: un solo worker en un runner de 2 vCPU, así que los tests esperan en cola unos detrás de otros.
- Reintentos: los tests inestables se vuelven a ejecutar, y cada reintento duplica el coste de ese test. Consulte tests e2e inestables.
- Demasiados tests e2e: comprobaciones que un test unitario o de integración podría hacer, ejecutadas a través de la interfaz. Consulte tests unitarios frente a tests e2e.
- CI en frío: descargas de navegadores, instalaciones de dependencias y descargas de imágenes en cada ejecución.
Paso 1: medir por test, no por ejecución
Todos los frameworks pueden mostrar la duración de cada test. Ordénelos de mayor a menor y revise los 20 primeros: normalmente, el 20 por ciento de los tests acapara el 60 por ciento del tiempo.
npx playwright test --reporter=list,json # durations in the JSON output
npx jest --verbose # per-test times
npx vitest run --reporter=verbose
pytest --durations=20
Registre también el tiempo que no corresponde a tests: checkout, instalación, instalación de navegadores y arranque del servidor. Si supera el 20 por ciento del job, corrija primero la preparación con caché antes de tocar los tests.
Paso 2: eliminar esperas fijas y el coste de preparación compartido
Sustituya los sleeps por esperas basadas en condiciones (localizadores con espera automática, expect(...).toBeVisible(), red inactiva en una petición concreta). Inicie sesión una sola vez y reutilice la sesión en lugar de hacerlo por la interfaz en cada test. Cargue los datos mediante una API o la base de datos, no haciendo clic. Detalles para cada herramienta:
- Tests lentos de Playwright:
storageState, workers,--shard - Tests lentos de Cypress:
cy.session, ejecuciones en paralelo - Tests lentos de Pytest: markers, xdist, división
Paso 3: ejecutar en paralelo
Hay dos tipos de paralelismo, que se usan juntos:
- Workers dentro de un job. Limitados por los núcleos del runner. Una máquina de 2 vCPU le da como máximo dos o tres workers de navegador.
- Shards entre jobs. Cada shard tiene su propio runner, así que el tiempo total baja aproximadamente en proporción al número de shards. La guía de test sharding incluye ejemplos con matrix, y el planificador de test sharding estima el número de shards frente a su tiempo objetivo y su coste.
strategy:
fail-fast: false
matrix:
shard: [1, 2, 3, 4]
steps:
- run: npx playwright test --shard=${{ matrix.shard }}/4
Los tests en paralelo necesitan aislamiento: datos separados por worker, sin estado mutable compartido, cuentas o tenants únicos. Si el paralelismo hace que fallen los tests, estos tenían dependencias ocultas, y conviene saberlo.
Paso 4: tests unitarios y de integración lentos
No todas las suites lentas dependen del navegador. Para tests de integración y unitarios lentos en JavaScript y Python:
- Jest lento: transformaciones, workers,
--shard - Vitest lento: aislamiento, pools, tiempo de importación
- Tests lentos de Pytest:
-n auto,--durations, markers
Los tests de integración suelen ser lentos porque cada test crea un esquema de base de datos. Cree el esquema una vez por worker, envuelva cada test en una transacción y haga rollback, y trunque entre archivos solo cuando sea imprescindible.
Paso 5: dar más CPU al trabajo
Las pruebas de navegador consumen mucha CPU. Si los workers hacen cola en una máquina de 2 núcleos, un runner más grande puede ser la solución más económica, ya que el precio por minuto sube aproximadamente con el número de núcleos mientras que el tiempo se reduce. La guía runners más rápidos de GitHub Actions compara las opciones. compiler.dev es una de ellas: 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, Linux de 8 vCPU cuesta $0.008 por minuto, y su modo de comparación mide sus propios jobs antes de que usted se comprometa. Compruebe el resultado con su suite, porque las suites de pruebas limitadas por servicios externos no se acelerarán.
Paso 6: decidir qué debe bloquear el PR
No todos los tests e2e tienen que ejecutarse en cada push. Ejecute un pequeño conjunto de humo en los PR (de 5 a 10 minutos), la suite completa al hacer merge en main o según una programación, y use una merge queue como puerta final. Consulte el centro de CI lento para el resto del pipeline.
Lista de verificación rápida
- Duraciones por test registradas; revisados los 20 primeros
- Sin sleeps fijos; inicio de sesión hecho una vez y reutilizado
- Datos cargados mediante API o base de datos
- Navegadores y dependencias en caché; solo se instalan los navegadores necesarios
- Workers acordes a los núcleos; shards elegidos con el planificador
- Reintentos limitados a 1 o 2, con una lista de tests inestables revisada cada semana
- Conjunto de humo en los PR, suite completa después del merge
Preguntas frecuentes
¿Por qué mis pruebas e2e son lentas en CI pero rápidas en local?
Los runners de CI suelen tener menos núcleos, cachés frías y ningún navegador ni servidor ya iniciado. Su portátil puede tener entre 8 y 16 núcleos rápidos. Ejecute con el mismo número de workers y mida por separado el tiempo de preparación.
¿Cuántas pruebas e2e debería tener?
Pocas, que cubran los recorridos críticos del usuario. Pruebe las reglas de negocio a nivel de unidad e integración, donde las pruebas son rápidas y precisas. La pirámide se explica en la guía de unitarias frente a e2e.
¿Debo reintentar las pruebas lentas?
Los reintentos ocultan la inestabilidad y añaden tiempo. Permita uno o dos reintentos en CI, registre cada reintento como una prueba inestable y corrija las pruebas que los necesitan.
¿El sharding abarata las pruebas lentas?
No, las hace más rápidas en tiempo real. Los minutos facturados aumentan ligeramente porque cada shard repite la preparación. Guarde en caché la preparación para que el coste adicional siga siendo pequeño.
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.
- ¿Sus pruebas de Cypress son lentas? Cómo acelerar Cypress¿Pruebas de Cypress lentas en CI? Cómo acelerar Cypress con cy.session, intercepts y sin esperas fijas, además de pruebas paralelas en GitHub Actions.
- 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.