Automatisch aus dem Englischen übersetzt.

Auf Englisch lesen
Proxy Mail QA

Hör auf, Gmail als Posteingang für deine Testcodes zu verwenden

Es fängt einfach an: ein Gmail-Konto fürs Team, Plus-Adressen für jeden Test und ein Skript, das den Code liest. Monate später schlagen die Tests montagmorgens fehl, weil ein Token abgelaufen ist, zwei Läufe die Codes des jeweils anderen lesen und jemand sich von Hand anmelden muss, um es zu beheben.

Aktualisiert am

Ein echtes Gmail-Konto als Test-Posteingang funktioniert anfangs. So geht es meistens kaputt.

Wo es kaputtgeht

  • Tokens laufen ab. Eine OAuth-App, deren Zustimmungsbildschirm auf „Testing“ steht, bekommt Refresh-Tokens, die nach 7 Tagen ablaufen. Die Pipeline schlägt fehl, bis sich jemand anmeldet und ein neues Token einfügt.
  • Eingeschränkte Scopes. Zum Lesen von Mails braucht es einen der eingeschränkten Scopes von Gmail. Die App aus „Testing“ herauszuholen, kann eine Prüfung durch Google und für manche Zwecke ein Sicherheitsaudit bedeuten – viel Aufwand für ein Testhilfsmittel.
  • Ein Posteingang für alle Läufe. Plus-Adressen (qa+run123@gmail.com) geben jedem Test eine eigene Adresse, aber jede E-Mail landet im selben Postfach. Parallele Läufe lesen gegenseitig ihre Codes, und ein erneuter Versuch kann den Code des vorherigen Versuchs erwischen.
  • Feste Wartezeiten und fragiles Parsen. Skripte fragen mit sleep ab und ziehen den Code dann mit einem regulären Ausdruck heraus, der an dem Tag bricht, an dem das Marketing die E-Mail-Vorlage ändert.
  • Ein Mensch in der Schleife. Wenn Google eine Bestätigung der Anmeldung verlangt, kann ein Test nicht antworten. Jemand mit dem Telefon muss es tun.

Stattdessen eine Adresse pro Test

Proxy Mail QA gibt jedem Test eine eigene Adresse und einen eigenen Posteingang und wartet dann auf die E-Mail, die nach einem bestimmten Zeitpunkt eintrifft:

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 });
  • Keine Tokens zu erneuern. Ein API-Schlüssel läuft nicht nach einer Woche ab. Bewahre ihn in deinen CI-Secrets auf.
  • Keine Kollisionen. Jede Adresse gehört zu einem Test, daher sehen parallele Läufe nie die Mails der anderen.
  • Keine regulären Ausdrücke. Der Code oder Link kommt von selbst zurück, mit dem Zeitpunkt des Eingangs.
  • Keine festen Pausen. Das Warten endet, sobald die E-Mail eintrifft, und since sorgt dafür, dass kein älterer Code zurückkommt.

Umsteigen

  1. Ersetze die Gmail-Adresse in deinem Registrierungsschritt durch eine neue Adresse von createAddress.
  2. Ersetze das Abfragen des Posteingangs und den regulären Ausdruck durch waitForCode oder waitForLink.
  3. Entferne die Gmail-Zugangsdaten aus CI und den Job, der das Token erneuert.

Die Anleitungen für Playwright, Cypress und pytest zeigen dieselben Schritte im jeweiligen Framework.

Probier es bei deinem nächsten Registrierungstest aus

Kostenloser Tarif, keine Kreditkarte nötig. Erstelle eine Adresse und sieh zu, wie der Code oder Link ankommt.

Kostenloses Konto erstellenApp öffnen

Fragen

Warum funktioniert mein Gmail-Token nach einer Woche nicht mehr?

Wenn der OAuth-Zustimmungsbildschirm deines Google-Cloud-Projekts auf „Testing“ steht, lässt Google seine Refresh-Tokens nach 7 Tagen ablaufen (es sei denn, die App fragt nur nach Name, E-Mail und Profil, womit sie keine E-Mails lesen kann). Das Veröffentlichen der App verhindert das, aber die Lese-Scopes von Gmail sind eingeschränkt, sodass eine veröffentlichte App eventuell zuerst die Verifizierung durch Google braucht.

Kann ich nicht einfach IMAP mit einem App-Passwort verwenden?

App-Passwörter erfordern die Bestätigung in zwei Schritten für das Konto, und der Google-Workspace-Admin einer Organisation kann sie deaktivieren. Selbst wenn sie funktionieren, teilen sich alle Tests einen Posteingang und müssen ihre E-Mail aus denen aller anderen heraussuchen.

Gmail-Plus-Adressen geben jedem Test eine eigene Adresse. Reicht das nicht?

Damit hat jeder Test eine eigene Adresse, aber keinen eigenen Posteingang. Alles landet weiter in einem Postfach, also muss dein Skript nach der richtigen E-Mail suchen, und eine langsame E-Mail kann dem falschen Test zugeordnet werden. Manche Registrierungsformulare lehnen +-Adressen außerdem ab.

Und ein zweites Gmail-Konto nur zum Testen?

Google blockiert womöglich Anmeldungen aus Browsern, die von Automatisierungssoftware gesteuert werden, und ein neues Konto muss eventuell eine Telefonnummer bestätigen. In beiden Fällen muss ein Mensch eingreifen, und dieses eine Konto wird wieder zum geteilten Posteingang.

Deine App mit einem KI-Tool gebaut? Wähle deins

Eine Frage zu dieser Seite?

Frag in jeder Sprache. Die Doku kann dir sofort antworten oder deine Frage an das Team von Proxy Mail QA schicken, das auf Englisch antwortet.

Doku fragen