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
sleepab 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_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 });- 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
sincesorgt dafür, dass kein älterer Code zurückkommt.
Umsteigen
- Ersetze die Gmail-Adresse in deinem Registrierungsschritt durch eine neue Adresse von
createAddress. - Ersetze das Abfragen des Posteingangs und den regulären Ausdruck durch
waitForCodeoderwaitForLink. - 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.