Usar una cuenta real de Gmail como bandeja de entrada de prueba funciona al principio. Estas son las formas en que suele fallar.
Dónde falla
- Los tokens caducan. Una app de OAuth cuya pantalla de consentimiento está en modo Testing recibe tokens de actualización que caducan a los 7 días. El pipeline falla hasta que alguien inicia sesión y copia un token nuevo.
- Scopes restringidos. Leer el correo requiere uno de los scopes restringidos de Gmail. Sacar la app del modo Testing puede implicar la verificación de Google y, para algunos usos, una evaluación de seguridad, lo cual es mucho para una herramienta de pruebas.
- Una bandeja de entrada para todas las ejecuciones. Las direcciones con + (
qa+run123@gmail.com) dan a cada prueba su propia dirección, pero todos los correos siguen llegando al mismo buzón. Las ejecuciones en paralelo leen los códigos de las otras, y un reintento puede tomar el código del intento anterior. - Esperas fijas y análisis frágil. Los scripts consultan con
sleepy luego extraen el código con una expresión regular que deja de funcionar el día en que marketing cambia la plantilla del correo. - Una persona en el proceso. Cuando Google pide confirmar el inicio de sesión, una prueba no puede responder. Tiene que hacerlo alguien que tenga el teléfono.
En su lugar, una dirección por prueba
Proxy Mail QA da a cada prueba su propia dirección y bandeja de entrada, y luego espera el correo que llega después de un momento dado:
import { ProxyMailQA } from 'proxymail-qa';
const qa = new ProxyMailQA(); // reads PROXYMAIL_QA_API_KEYconst { address } = await qa.createAddress({ label: 'sign-up test' });
const since = new Date();// …fill in the sign-up form with `address` and submit…const { value: code } = await qa.waitForCode(address, { since });- Sin tokens que renovar. Una clave de API no caduca a la semana. Guárdala en tus secretos de CI.
- Sin colisiones. Cada dirección pertenece a una sola prueba, así que las ejecuciones en paralelo nunca ven el correo de las otras.
- Sin expresiones regulares. El código o el enlace se devuelve solo, con la hora en que llegó.
- Sin esperas fijas. La espera termina en cuanto llega el correo, y
sincegarantiza que no se devuelva un código anterior.
Cómo migrar
- Cambia la dirección de Gmail de tu paso de registro por una dirección nueva de
createAddress. - Reemplaza la consulta de la bandeja de entrada y la expresión regular por
waitForCodeowaitForLink. - Elimina las credenciales de Gmail de CI y el job que renueva el token.
Las guías de Playwright, Cypress y pytest muestran los mismos pasos en cada framework.