Zum Inhalt springen

Das Paket proxymail-qa hat ab Version 0.13.0 einen Befehl. Nutze ihn im Terminal, während du von Hand testest, in npm-Skripten, in einer JetBrains- oder VS Code-Run-Konfiguration oder in einem CI-Schritt. Er läuft mit Node 18 oder neuer und braucht außer npx keine Installation.

  1. Erstelle einen API-Schlüssel und setze ihn als PROXYMAIL_QA_API_KEY. Der Befehl liest den Schlüssel nur aus der Umgebung, nie aus einer Option. So bleibt er aus deiner Shell-History heraus.

    export PROXYMAIL_QA_API_KEY=qa_...
  2. Im Terminal zeigt er die Adresse, das Passwort sowie Name, Benutzername, Geburtsdatum und Land der Persona, bereit zum Eintippen ins Registrierungsformular. Das Passwort wird bei der Adresse gespeichert und nur dieses eine Mal angezeigt.

    npx proxymail-qa new --password --country JP
  3. Registriere dich mit der Adresse, dann:

    Ein Warten dauert 30 Sekunden, außer du gibst --timeout an. Kommt nichts an, sagt er, warum, soweit Proxy Mail QA das erkennen kann, und beendet sich mit 1.

    npx proxymail-qa wait-code k7f2@mailclub.dev
    npx proxymail-qa wait-link k7f2@mailclub.dev --type reset
Befehl Was es tut
new Erstellt eine Testadresse mit Persona. --password, --country, --age oder --dob, --one-name, --label, --site, --environment, --days, --no-persona
wait-code <address> Wartet auf einen Anmeldecode. --type coupon für einen Gutschein, --since, --service, --unused, --timeout
wait-link <address> Wartet auf einen Link. --type verify, reset, magic_signin oder invite (mehrere mit Kommas), --app für den Link, der eine mobile App öffnet
persona <address> Zeigt die Persona der Adresse
form-values <file> Was in jedes Feld eines Formulars gehört: siehe unten

npx proxymail-qa help <command> listet die Optionen eines Befehls. Füge --json an einen beliebigen Befehl an, um die ganze Antwort als JSON zu bekommen.

Geht die Ausgabe an eine Pipe oder eine Variable, gibt ein Befehl nur den Wert aus: die Adresse, den Code oder den Link. new --password gibt die Adresse aus, dann das Passwort in einer zweiten Zeile.

ADDRESS=$(npx proxymail-qa new --site staging.example.com --environment staging)
# …sign up with $ADDRESS…
CODE=$(npx proxymail-qa wait-code "$ADDRESS" --timeout 60)

Das Passwort wird ausgegeben, damit ein Skript es nutzen kann: Speichere es in einer Variable und gib es nicht in ein CI-Log aus. In einem Run (PROXYMAIL_QA_RUN, das die GitHub Action setzt) wird jeder Aufruf zum Bericht des Runs hinzugefügt.

Als npm-Skripte, damit das Team dieselben Befehle ausführt:

package.json
{
"scripts": {
"inbox": "proxymail-qa new --password --site localhost:3000 --environment local",
"code": "proxymail-qa wait-code"
}
}

npm run inbox, dann npm run code -- k7f2@mailclub.dev. In JetBrains-IDEs fügst du für jedes Skript eine Run-Konfiguration vom Typ npm hinzu, oder eine Shell-Script-Konfiguration, die npx proxymail-qa new ausführt.

form-values nimmt eine JSON-Datei, die die Felder eines Formulars auflistet, und antwortet mit dem, was in jedes Feld gehört, für eine neue Adresse oder eine, die du mit --address angibst. Er füllt die benutzerdefinierten Felder des Projekts und die Namen, Daten und Passwörter, die ein Formular verlangt, so wie es formValues im Node.js-Client tut.

signup-form.json
{
"fields": [
{ "id": "email", "type": "email", "label": "Email" },
{ "id": "name", "label": "Full name" },
{ "id": "team", "type": "select", "label": "Team size", "options": [{ "value": "1-10" }, { "value": "11-50" }] }
],
"page": "/signup"
}
npx proxymail-qa form-values signup-form.json --site staging.example.com --country PK

Er gibt JSON aus: die Adresse, die Persona, das Passwort, falls eines erstellt wurde, und einen Wert pro Feld. Optionen auf der Kommandozeile haben Vorrang vor denselben in der Datei. Nutze - statt eines Dateinamens, um die Felder von der Standardeingabe zu lesen.

Code Bedeutung
0 Erledigt
1 Die API hat abgelehnt, oder nichts kam rechtzeitig an. Der Grund steht auf der Standardfehlerausgabe
2 Der Befehl war falsch, oder PROXYMAIL_QA_API_KEY ist nicht gesetzt

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