Traduit automatiquement de l’anglais.

Lire en anglais
Proxy Mail QA

Arrêtez d’utiliser Gmail comme boîte de réception pour vos codes de test

Tout commence simplement : un compte Gmail d’équipe, des adresses avec + pour chaque test, et un script qui lit le code. Des mois plus tard, les tests échouent le lundi matin parce qu’un jeton a expiré, deux exécutions lisent les codes l’une de l’autre, et quelqu’un doit se connecter à la main pour réparer.

Mis à jour le

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_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 });
  • 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 since garantit qu’un ancien code ne peut pas revenir.

Migrer

  1. Remplacez l’adresse Gmail de votre étape d’inscription par une nouvelle adresse de createAddress.
  2. Remplacez l’interrogation de la boîte de réception et l’expression régulière par waitForCode ou waitForLink.
  3. 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.

Essayez-le lors de votre prochain test d’inscription

Offre gratuite, sans carte bancaire. Créez une adresse et regardez arriver le code ou le lien.

Créer un compte gratuitOuvrir l'application

Questions

Pourquoi mon jeton Gmail cesse-t-il de fonctionner au bout d’une semaine ?

Si l’écran de consentement OAuth de votre projet Google Cloud est en mode Testing, Google fait expirer ses jetons d’actualisation au bout de 7 jours (sauf si l’application ne demande que le nom, l’e-mail et le profil, qui ne permettent pas de lire les e-mails). Publier l’application évite cela, mais les portées de lecture de Gmail sont restreintes ; une application publiée peut donc d’abord nécessiter la vérification de Google.

Ne puis-je pas simplement utiliser IMAP avec un mot de passe d’application ?

Les mots de passe d’application exigent la validation en deux étapes sur le compte, et l’administrateur Google Workspace d’une organisation peut les désactiver. Même quand ils fonctionnent, tous les tests partagent une seule boîte de réception et doivent y retrouver leur e-mail parmi ceux des autres.

Le plus-addressing de Gmail donne à chaque test sa propre adresse. Cela ne suffit-il pas ?

Il donne à chaque test sa propre adresse, pas sa propre boîte de réception. Tout arrive toujours dans une seule boîte, donc votre script doit chercher le bon e-mail, et un e-mail lent peut être associé au mauvais test. Certains formulaires d’inscription refusent aussi les adresses avec +.

Et un second compte Gmail réservé aux tests ?

Google peut bloquer les connexions depuis des navigateurs pilotés par un logiciel d’automatisation, et un nouveau compte peut devoir confirmer un numéro de téléphone. Dans les deux cas, une personne doit intervenir, et ce compte unique redevient la boîte de réception partagée.

Vous avez créé votre application avec un outil d’IA ? Choisissez le vôtre

Une question sur cette page ?

Posez votre question dans la langue de votre choix. La documentation peut y répondre tout de suite, ou vous pouvez l'envoyer à l'équipe Proxy Mail QA, qui répond en anglais.

Interroger la documentation