Traducido automáticamente del inglés.

Leer en inglés
Proxy Mail QA

Deja de usar Gmail como bandeja de entrada para tus códigos de prueba

Empieza de forma sencilla: una cuenta de Gmail del equipo, direcciones con + para cada prueba y un script que lee el código. Meses después, las pruebas fallan los lunes por la mañana porque caducó un token, dos ejecuciones leen los códigos de la otra y alguien tiene que iniciar sesión a mano para arreglarlo.

Actualizado el

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 sleep y 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_KEY
const { 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 since garantiza que no se devuelva un código anterior.

Cómo migrar

  1. Cambia la dirección de Gmail de tu paso de registro por una dirección nueva de createAddress.
  2. Reemplaza la consulta de la bandeja de entrada y la expresión regular por waitForCode o waitForLink.
  3. 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.

Úsalo en tu próxima prueba de registro

Plan gratuito, sin tarjeta de crédito. Crea una dirección y mira cómo llega el código o el enlace.

Crear una cuenta gratuitaAbrir la aplicación

Preguntas

¿Por qué mi token de Gmail deja de funcionar después de una semana?

Si la pantalla de consentimiento de OAuth de tu proyecto de Google Cloud está en Testing, Google hace caducar sus tokens de actualización a los 7 días (salvo que la app pida solo nombre, correo y perfil, que no pueden leer el correo). Publicar la app lo evita, pero los permisos de lectura de Gmail están restringidos, así que una app publicada puede necesitar primero la verificación de Google.

¿No puedo usar simplemente IMAP con una contraseña de aplicación?

Las contraseñas de aplicación requieren la verificación en dos pasos en la cuenta, y el administrador de Google Workspace de una organización puede desactivarlas. Incluso cuando funcionan, todas las pruebas comparten una sola bandeja de entrada y cada una tiene que encontrar su correo entre los de los demás.

Las direcciones con + de Gmail dan a cada prueba su propia dirección. ¿No basta con eso?

Dan a cada prueba su propia dirección, no su propia bandeja de entrada. Todo sigue llegando a un solo buzón, así que tu script tiene que buscar el correo correcto, y un correo lento puede asociarse a la prueba equivocada. Además, algunos formularios de registro rechazan las direcciones con +.

¿Y una segunda cuenta de Gmail solo para pruebas?

Google puede bloquear los inicios de sesión desde navegadores controlados por software de automatización, y a una cuenta nueva se le puede pedir que confirme un número de teléfono. En ambos casos, una persona tiene que intervenir, y esa cuenta vuelve a ser la bandeja de entrada compartida.

¿Creaste tu app con una herramienta de IA? Elige la tuya

¿Tienes una pregunta sobre esta página?

Pregunta en cualquier idioma. La documentación puede responderte de inmediato, o puedes enviar tu pregunta al equipo de Proxy Mail QA, que responde en inglés.