Controleer de download, niet alleen de knop.

De knop Exporteren reageert. Er wordt een download gestart. De test wordt groen. Later opent iemand het bestand en vindt de rijen van gisteren, de verkeerde kolommen of een inlogpagina die is opgeslagen met een spreadsheetnaam. De browserinteractie werkte, maar het nuttige resultaat niet.

Deze handleiding bouwt een artefactcontrole op uit Playwright's downloaddocumentatie. In het voorbeeld wordt een klein verzonnen CSV-bestand van een lokale demo gebruikt. Het is geen financieel document, geen export van een leverancier of een claim dat enig product dit formaat biedt. Het doel is om de klik te verbinden met bewijsmateriaal over de resulterende bytes.

Registreer de wachttijd vóór de actie

Een snelle download kan onmiddellijk na de klik beginnen. Begin eerst met wachten, voer dan de actie uit en wacht op dezelfde belofte. Hierdoor blijft de gebeurtenis in de hoofdteststroom, in plaats van dat er een niet-bijgehouden callback wordt uitgevoerd nadat het scenario is geëindigd.

import { readFile } from 'node:fs/promises';

const pendingDownload = page.waitForEvent('download');
await page.getByRole('button', { name: 'Export demo' }).click();
const download = await pendingDownload;
const output = testInfo.outputPath('demo-export.csv');
await download.saveAs(output);
const text = await readFile(output, 'utf8');
expect(text).toBe('name,status\nDemo task,ready\n');

Dit fragment hoort thuis in een Playwright-test die pagina- en testInfo ontvangt, en wordt geïmporteerd uit het testpakket. Het expliciete uitvoerpad voorkomt dat een voorgestelde bestandsnaam als een vertrouwde bestemming wordt behandeld. De documentatie zegt dat saveAs wacht op voltooiing. Een bestandssysteem dat na deze stap wordt gelezen, onderzoekt het opgeslagen artefact, en niet alleen de belofte van de gebruikersinterface.

Kies een inhoudscontract, geen handige bewering

Exacte bytes zijn geschikt voor deze opzettelijk vaste demo. Een echte export kan tijdstempels, gegenereerde identificatiegegevens of rijvolgorde bevatten die legitiem verandert. Bepaal welke velden stabiel moeten zijn en parseer het daadwerkelijke formaat met een geschikte bibliotheek. Maak een test niet wankel door gelijkheid te eisen voor waarden die het product nooit heeft beloofd.

Voor een CSV vereist het contract mogelijk benoemde kolommen, de verwachte gecontroleerde record en een geldig aantal rijen. Echte CSV kan tussen aanhalingstekens, regeleinden en coderingen staan; een naïeve splitsing op komma's is geen algemene parser. Gebruik voor een PDF een passende tekst- of structuurcontrole en visuele controle als de lay-out van belang is. Een succesvolle opslag bewijst niet dat een van beide formaten geldig is.

Houd formaatgeldigheid, zakelijke inhoud en presentatie als afzonderlijke vragen. Een bestandsnaam die eindigt op .csv zegt wat de beller heeft voorgesteld, niet wat het bestand bevat. Een header kan correct zijn, terwijl elke gegevensrij fout is. Een parser kan een document accepteren waarvan de pagina's zijn bijgesneden. Selecteer cheques die passen bij het risico van de export.

Geef de testrecord een veilige plek om te wonen

Playwright merkt op dat downloads die bij een context horen, worden verwijderd wanneer die context wordt gesloten. Behoud een artefact voordat het wordt afgebroken als de test dit later nodig heeft. Gebruik een gecontroleerde testuitvoermap en noem de reden waarom deze wordt bewaard. Vertrouw niet op een tijdelijk browserpad dat de suite overleeft.

De opgeslagen export kan gevoeliger materiaal bevatten dan een screenshot. Test met bedachte of goedgekeurde staging-records en inspecteer mislukte uploads voordat u ze distribueert. Als u de schermafbeelding redigeert, wordt de CSV die ernaast is bijgevoegd niet ongedaan gemaakt. De download-URL kan ook privétoegangsinformatie bevatten; vermijd het kopiëren naar openbare foutopsporingsnotities.

Wanneer een bewering mislukt, bewaar dan alleen het bewijsmateriaal dat het bewaarbeleid van uw team toestaat. Leg de actie, gecontroleerde invoer, parserresultaat en mislukt contract vast. Een generieke tracering van een knopklik is nuttige context, maar kan het artefact dat de gebruiker feitelijk ontvangt niet vervangen.

Test de lege en afgewezen paden opzettelijk

Een goede exportcontrole omvat het verwachte gedrag bij geen records en bij een afgewezen verzoek. Het juiste antwoord kan een leeg bestand met headers zijn, een duidelijke boodschap of geen download. Dat is een productbeslissing die moet worden genomen voordat de bewering wordt geschreven. Forceer niet elke staat om een ​​bestand te produceren alleen maar omdat de happy-path-helper er een verwacht.

Gebruik afzonderlijke tests met gecontroleerde ingangen. Als de applicatie een fout meldt, controleer dan de uitleg en veilige volgende actie. Als er toch een onverwacht bestand binnenkomt, inspecteer het dan in plaats van blindelings de voorgestelde extensie te accepteren. Een HTML-foutdocument is geen succesvolle gegevensexport.

AnyTest beschrijft URL-gestuurde verkenning en door mensen beoordeelde end-to-end tests. Een recensent kan vragen of een voorgestelde exportreis het artefact of alleen de controle controleert. Deze handleiding claimt geen specifieke downloadparser of opslagfunctie in AnyTest. Voor teams met beperkte QA-tijd voorkomt die ene grens dat een geruststellende klik een valse belofte over de geleverde gegevens wordt.