Hoe zet ik de API-aanroepen van mijn app om in API-tests?
Neem ze op terwijl je de app gebruikt, controleer de lijst en genereer een test op basis van de aanroepen die je behoudt. De Nexus Recorder in Nexus StudioQA, van Verdict System LLC, legt de aanroepen van een pagina vast als REST- of GraphQL-tests, laat authenticatie- en cookieheaders weg en zet velden die geheimen lijken te bevatten om in omgevingsvariabelen. Alles draait op je eigen computer.
Laatst bijgewerkt:
Door het Nexus StudioQA-team, Verdict System LLC.
Hoe werkt het opnemen?
- Neem in de Nexus Recorder de aanroepen van de pagina op terwijl je een proces doorloopt, zoals inloggen en afrekenen.
- Voordat er een test wordt geschreven, toont Controleren elke aanroep met de methode, het pad, de status, de categorie en de reden waarom deze wel of niet wordt opgenomen.
- Bedrijfslogica-, authenticatie-, lees- en statuswijzigende aanroepen worden standaard in de testsuite opgenomen. Telemetriebeacons, externe hosts, bronbestanden en preflightverzoeken worden standaard uitgesloten, maar je kunt ze allemaal weer aanvinken.
- Processen geven een waarde uit een antwoord door aan een later verzoek, zoals het token dat bij het inloggen wordt teruggegeven.
Wat kan ik uit een opname genereren?
- Test genereren schrijft de API-testsuite.
- OpenAPI genereren schrijft een OpenAPI 3.1-concept met typen en statuscodes, zonder de opgenomen waarden.
- Belastingstest opent dezelfde aanroepen als een belastingsplan.
Wat blijft buiten het testbestand?
| Wat de opname vastlegde | Wat in het testbestand komt |
|---|---|
| Authenticatie- en cookieheaders | Weggelaten |
| Velden met namen die op geheimen duiden | Een omgevingsvariabele, vermeld onder Afschermingen |
| JWT's, providersleutels en kaartnummers in elk veld | Afgeschermd op basis van hun waarde, niet alleen op basis van de veldnaam |
| Telemetrie, externe hosts, bronbestanden en preflightverzoeken | Standaard uitgesloten |
Wanneer de test wordt uitgevoerd, gaat het authenticatietoken alleen naar de oorsprong in API_BASE_URL, nooit naar een andere host die in de opname voorkwam.
Hoe worden de API-tests beoordeeld?
Ze worden net als elke andere test vanuit Patrol uitgevoerd, en elk eindpunt krijgt een eigen bewijsmap. API-tests hebben geen sandbox: bij de eerste klik worden ze echt uitgevoerd. Ze krijgen eigen API-oordelen: API_SECURE als aan elke controle is voldaan en de antwoordstructuur overeenkomt met de laatst opgenomen structuur, API_FLAKY als een nieuwe poging slaagt, en API_DRIFTED als de test slaagt maar de structuur is veranderd, waarbij elk toegevoegd of verwijderd veld en elk veld met een gewijzigd type wordt genoemd. API-schema-afwijkingen toont een afwijking bij een echte uitvoering.
Wat zijn de beperkingen?
- Een opname bevat alleen de aanroepen die de pagina tijdens het opnemen deed. Een eindpunt dat tijdens het proces nooit is aangesproken, staat er niet in.
- Opnemen levert REST- en GraphQL-tests op. SOAP-tests worden handmatig gemaakt, als XML die als tekst wordt verzonden en met tekstregels wordt gecontroleerd.
- API-tests gebruiken het eigen formaat van Studio, dus als je ze met een ander uitvoerprogramma wilt uitvoeren, moet je ze herschrijven. De browsertests die de Recorder schrijft, blijven standaard Playwright of Selenium.
- Controleer de gegenereerde test voordat je erop vertrouwt: de opname weet wat de app deed, niet wat die zou moeten doen.
Waar kan ik het zien?
De Studio-rondleiding toont de Nexus Recorder, en API-schema-afwijkingen legt de API-oordelen uit aan de hand van een uitvoerbaar voorbeeld. De gratis proefversie gebruikt dezelfde engine voor je eigen app.