Wie mache ich aus den API-Aufrufen meiner App API-Tests?
Zeichnen Sie die Aufrufe während der App-Nutzung auf, prüfen Sie die Liste und erzeugen Sie aus den beibehaltenen Aufrufen einen Test. Der Nexus Recorder in Nexus StudioQA von Verdict System LLC zeichnet die Aufrufe einer Seite als REST- oder GraphQL-Tests auf, lässt Authentifizierungs- und Cookie-Header weg und wandelt Felder mit mutmaßlich geheimen Inhalten in Umgebungsvariablen um. Alles läuft auf Ihrem eigenen Rechner.
Zuletzt aktualisiert:
Vom Nexus StudioQA-Team, Verdict System LLC.
Wie funktioniert die Aufzeichnung?
- Zeichnen Sie im Nexus Recorder die Aufrufe der Seite auf, während Sie einen Ablauf durchklicken, etwa eine Anmeldung und einen Kaufabschluss.
- Bevor ein Test geschrieben wird, listet die Prüfung jeden Aufruf mit Methode, Pfad, Status, Kategorie und dem Grund für seine Aufnahme oder seinen Ausschluss auf.
- Geschäfts-, Authentifizierungs-, Lese- und zustandsändernde Aufrufe sind anfangs in der Testsuite enthalten. Telemetrie-Beacons, Drittanbieter-Hosts, Ressourcen und Preflight-Anfragen sind zunächst ausgeschlossen, lassen sich aber jeweils per Häkchen wieder aufnehmen.
- Abläufe übernehmen einen Wert aus einer Antwort in eine spätere Anfrage, etwa das bei einer Anmeldung zurückgegebene Token.
Was kann ich aus einer Aufzeichnung erzeugen?
- Test erzeugen schreibt die API-Testsuite.
- OpenAPI erzeugen schreibt einen OpenAPI-3.1-Entwurf mit Typen und Statuscodes, jedoch ohne die aufgezeichneten Werte.
- Lasttest öffnet dieselben Aufrufe als Lastplan.
Was bleibt aus der Testdatei ausgeschlossen?
| Was die Aufzeichnung erfasst hat | Was in die Testdatei gelangt |
|---|---|
| Authentifizierungs- und Cookie-Header | Ausgelassen |
| Felder mit Namen, die auf geheime Inhalte hindeuten | Eine Umgebungsvariable, unter Schwärzungen aufgeführt |
| JWTs, Anbieterschlüssel und Kartennummern in beliebigen Feldern | Anhand ihres Werts geschwärzt, nicht nur anhand des Feldnamens |
| Telemetrie, Drittanbieter-Hosts, Ressourcen und Preflight-Anfragen | Standardmäßig ausgeschlossen |
Wenn der Test läuft, wird sein Authentifizierungstoken nur an den Ursprung in API_BASE_URL gesendet, niemals an einen anderen Host aus der Aufzeichnung.
Wie werden die API-Tests bewertet?
Sie werden wie alle anderen Tests über Patrol ausgeführt, und jeder Endpunkt legt einen eigenen Nachweisordner an. API-Tests haben keine isolierte Testumgebung: Sie werden schon beim ersten Start tatsächlich ausgeführt. Sie erhalten eigene API-Bewertungen: API_SECURE, wenn alle Zusicherungen erfüllt wurden und die Antwortstruktur der zuletzt aufgezeichneten entspricht, API_FLAKY, wenn ein Wiederholungsversuch erfolgreich war, und API_DRIFTED, wenn der Test erfolgreich war, sich aber die Struktur geändert hat. Dabei wird jedes hinzugefügte, entfernte oder im Typ geänderte Feld benannt. API-Schemaabweichungen zeigt eine Abweichung bei einer tatsächlichen Ausführung.
Wo liegen die Grenzen?
- Eine Aufzeichnung enthält nur die Aufrufe, die die Seite während der Aufnahme ausgeführt hat. Ein Endpunkt, den der Ablauf nie angesprochen hat, ist nicht enthalten.
- Die Aufzeichnung schreibt REST- und GraphQL-Tests. SOAP-Tests werden von Hand erstellt: als XML, das als Text gesendet und mit Textregeln geprüft wird.
- API-Tests verwenden das eigene Format von Studio. Für eine andere Testausführungsumgebung müssen sie daher neu geschrieben werden. Die vom Recorder geschriebenen Browsertests bleiben im Standardformat von Playwright oder Selenium.
- Prüfen Sie den erzeugten Test, bevor Sie ihm vertrauen: Die Aufzeichnung weiß, was die App getan hat, nicht, was sie tun sollte.
Wo kann ich das sehen?
Der Studio-Rundgang zeigt den Nexus Recorder, und API-Schemaabweichungen erklärt die API-Bewertungen anhand eines ausführbaren Beispiels. Die kostenlose Testversion führt dieselbe Engine mit Ihrer eigenen App aus.