Utiliser un vrai compte Gmail comme boîte de réception de test fonctionne au début. Voici comment cela casse d’habitude.
Ce qui casse
- Les jetons expirent. Une application OAuth dont l’écran de consentement est en mode Testing reçoit des jetons d’actualisation qui expirent au bout de 7 jours. Le pipeline échoue jusqu’à ce que quelqu’un se connecte et copie un nouveau jeton.
- Scopes restreints. Lire les e-mails exige l’un des scopes restreints de Gmail. Sortir l’application du mode Testing peut impliquer la vérification de Google et, pour certains usages, une évaluation de sécurité, ce qui est beaucoup pour un outil de test.
- Une boîte de réception pour toutes les exécutions. Les adresses avec + (
qa+run123@gmail.com) donnent à chaque test sa propre adresse, mais chaque e-mail arrive toujours dans la même boîte. Les exécutions parallèles lisent les codes des autres, et une nouvelle tentative peut récupérer le code de la précédente. - Attentes fixes et analyse fragile. Les scripts interrogent avec
sleep, puis extraient le code avec une expression régulière qui casse le jour où le marketing modifie le modèle d’e-mail. - Une personne dans la boucle. Quand Google demande de confirmer la connexion, un test ne peut pas répondre. Quelqu’un qui a le téléphone doit le faire.
Plutôt une adresse par test
Proxy Mail QA donne à chaque test sa propre adresse et sa boîte de réception, puis attend l’e-mail arrivé après un moment donné :
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 });- Aucun jeton à renouveler. Une clé d’API n’expire pas au bout d’une semaine. Gardez-la dans vos secrets CI.
- Aucune collision. Chaque adresse appartient à un seul test, donc les exécutions parallèles ne voient jamais les e-mails des autres.
- Aucune expression régulière. Le code ou le lien est renvoyé directement, avec son heure d’arrivée.
- Aucune pause fixe. L’attente se termine dès que l’e-mail arrive, et
sincegarantit qu’un ancien code ne peut pas revenir.
Migrer
- Remplacez l’adresse Gmail de votre étape d’inscription par une nouvelle adresse de
createAddress. - Remplacez l’interrogation de la boîte de réception et l’expression régulière par
waitForCodeouwaitForLink. - Supprimez les identifiants Gmail de CI, ainsi que la tâche qui renouvelle le jeton.
Les guides Playwright, Cypress et pytest montrent les mêmes étapes dans chaque framework.