
Kontrollera filen som webbläsaren faktiskt sparar. Övningen ger två nedladdningar med samma filnamn: den ena innehåller rätt rad och den andra en felaktig. Ditt test ska kunna skilja dem åt.
1. Skriv exportens facit innan du klickar
En AI-byggd exportknapp kan fungera tekniskt och ändå ge fel data. Bestäm därför vilket innehåll du väntar dig innan du börjar automatisera. I den här lokala övningen ska en CSV-fil innehålla rubriken id,name och posten 104,Rönn, med kommatecken, UTF-8 och Windows-radbrytning efter båda raderna. Ingen verklig kunduppgift används.
Det är ett avsiktligt litet formatkontrakt. En annan fil med namnet poster.csv och raden 999,Fel ska underkännas. En tom fil, en inloggningssida i stället för data eller ett ändrat ö-tecken ska också avvika från de förväntade byten. Läs CSV-exportens krav på urval, kolumner och behörighet innan du skriver facit för en riktig app; övningen här implementerar inga sådana verksamhetsregler.
2. Förbered en isolerad övningsmapp
Du behöver Node.js med npm och en redan installerad Google Chrome. Skapa en ny, tom mapp och installera testpaketet där. Versionen nedan är den som användes i guidens prov. Konfigurationens browserName: 'chromium' tillsammans med channel: 'chrome' väljer installerad Chrome enligt Playwrights dokumentation om webbläsarkanaler.
npm init -y
npm install --save-dev @playwright/test@1.64.1
Spara detta som playwright.config.cjs. Ett eget testMatch gör att övningen inte råkar köra andra testfiler. En worker ger lättläst utdata; filisoleringen i nästa steg gör ändå att testerna inte behöver dela exportfil.
const { defineConfig } = require('@playwright/test');
module.exports = defineConfig({
testDir: '.', testMatch: 'download.spec.cjs',
outputDir: './test-results', workers: 1, retries: 0,
use: { browserName: 'chromium', channel: 'chrome', acceptDownloads: true },
reporter: [['list']],
});
3. Kör hela kedjan från länk till bytes
Spara följande som download.spec.cjs. Servern startas bara under provet, lyssnar på 127.0.0.1 och får en ledig port av operativsystemet. Startsidan har två länkar. Båda svarar med en filbilaga och samma föreslagna filnamn; frågeparametern väljer bara vilken datarad övningen levererar. Servern och facitet är redaktionellt konstruerade.
const { test, expect } = require('@playwright/test');
const { readFile } = require('node:fs/promises');
const { createServer } = require('node:http');
const EXPECTED = 'id,name\r\n104,Rönn\r\n';
let server;
let origin;
test.beforeAll(async () => {
server = createServer((req, res) => {
const url = new URL(req.url, 'http://localhost');
if (url.pathname === '/') {
res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
res.end('<!doctype html><html lang="sv"><meta charset="utf-8">' +
'<title>Exportprov</title><h1>Exportprov</h1>' +
'<a href="/export.csv">Hämta korrekt fil</a>' +
'<a href="/export.csv?broken=1">Hämta felaktig fil</a></html>');
} else if (url.pathname === '/export.csv') {
res.writeHead(200, {
'Content-Type': 'text/csv; charset=utf-8',
'Content-Disposition': 'attachment; filename="poster.csv"',
});
res.end(url.searchParams.has('broken') ? 'id,name\r\n999,Fel\r\n' : 'id,name\r\n104,Rönn\r\n');
} else { res.writeHead(404); res.end(); }
});
await new Promise(resolve => server.listen(0, '127.0.0.1', resolve));
origin = `http://127.0.0.1:${server.address().port}`;
});
test.afterAll(async () => {
await new Promise((resolve, reject) => server.close(e => e ? reject(e) : resolve()));
});
async function exportBytes(page, testInfo, linkName) {
await page.goto(origin);
const pending = page.waitForEvent('download');
await page.getByRole('link', { name: linkName, exact: true }).click();
const download = await pending;
expect(await download.failure()).toBeNull();
expect(download.suggestedFilename()).toBe('poster.csv');
const destination = testInfo.outputPath('export.csv');
await download.saveAs(destination);
return readFile(destination);
}
test('korrekt export har rätt bytes', async ({ page }, testInfo) => {
const actual = await exportBytes(page, testInfo, 'Hämta korrekt fil');
expect(actual).toEqual(Buffer.from(EXPECTED, 'utf8'));
});
test('fel rad underkänns trots rätt filnamn', async ({ page }, testInfo) => {
const actual = await exportBytes(page, testInfo, 'Hämta felaktig fil');
expect(() => expect(actual).toEqual(Buffer.from(EXPECTED, 'utf8'))).toThrow();
});
Kör de två proven från samma mapp:
npx playwright test --config=playwright.config.cjs
Facit är två godkända testfall. Det första visar att den korrekta nedladdningen har det bestämda innehållet. Det andra visar att samma bytejämförelse upptäcker den felaktiga raden. Det bevisar inte att en annan app exporterar rätt poster; inga databasfrågor eller användarkonton finns i övningen.
4. Registrera väntan före den utlösande handlingen
Ordningen i hjälpfunktionen är väsentlig: först skapas pending, sedan klickar testet och därefter inväntas det sparade löftet. Det följer Playwrights nedladdningsexempel. Om du först inväntar händelsen utan att ha klickat kan testet vänta på något det ännu inte har startat. Om du i stället börjar lyssna efter klicket kan du missa en snabb nedladdning.
getByRole med länkens exakta namn pekar ut den avsedda handlingen i fixture-sidan. När du flyttar provet till din app väljer du exempelvis en knapp med appens verkliga tillgängliga namn. Guiden om Playwright-locatorer visar hur du gör det valet utan att binda testet till en tillfällig CSS-klass.
5. Skilj en startad nedladdning från rätt export
Enligt Download-referensen kommer händelsen när nedladdningen börjar. Funktionen failure() väntar vid behov och ger null eller en feltext. Ett null säger därför att Playwright inte rapporterar något nedladdningsfel. Det säger inget om huruvida raden i CSV-filen är den du beställde.
Det föreslagna namnet kontrolleras på en egen rad. I övningen kommer poster.csv från Content-Disposition. Dokumentationen anger att webbläsaren normalt använder den headern eller HTML-attributet download och att webbläsare kan beräkna namnet olika. Ett godkänt namnprov i Chrome är alltså inte ett utfört namnprov i alla webbläsare.
Själva innehållsprovet kommer sist, efter att filen har sparats och lästs. Det är därför även ett nedladdat felmeddelande eller en tom fil blir fel när du jämför mot facitet. En lyckad överföring och ett godkänt filinnehåll är skilda villkor; behåll båda när du anpassar hjälpfunktionen.
6. Spara filen där testet bestämmer
testInfo.outputPath('export.csv') ger en sökväg i det aktuella testets utdatakatalog. TestInfo-referensen beskriver isoleringen mellan tester som kör parallellt. Du kan därför använda samma fasta namn i båda testerna utan att de avser samma kopia.
saveAs kopierar nedladdningen till den valda platsen och väntar på att den blir färdig vid behov. Först därefter körs readFile. Spara medan browser-context fortfarande är öppet: Playwrights egna temporära nedladdningar raderas när context stängs. Här kontrollerar du filens föreslagna namn, men bygger inte den lokala sökvägen av namnet från servern.
7. Gör negativprovet begripligt
Det andra testet innehåller samma jämförelse som det första, omsluten av ett krav på att jämförelsen kastar ett fel. Därför ska negativprovet vara grönt när den felaktiga filen avvisas. Det är ingen godkänd export; det är en godkänd kontroll av att testet reagerar.
Vill du se assertionfelet direkt kan du i en arbetskopia ersätta sista raden i det andra testet med expect(actual).toEqual(Buffer.from(EXPECTED, 'utf8'));. Då ska körningen bli röd på filinnehållet. Återställ sedan omslutningen. Om båda nedladdningarna redan stoppas av ett namnfel har du ännu inte visat att innehållskontrollen fungerar; lös det första felet och kör igen.
8. Ta med rätt begränsning till din app
Bytejämförelsen passar det fasta facitet här: ingen BOM, exakt radordning och CRLF efter varje rad. En export med godtagbara men varierande radbrytningar eller ordning behöver ett annat uttryckligt kontrakt. Bygg inte en egen CSV-parser genom att bara dela på kommatecken om ditt verkliga format tillåter citerade värden med kommatecken eller radbrytningar.
När du byter fixture-adressen mot en riktig app ska facitet komma från testets kända data och rätt användare. Prov av filter, dolda kolumner och nekad åtkomst till andra användares uppgifter behöver egna fall. Använd API-mockning för andra bestämda gränssnittsutfall och behåll minst ett prov mot den verkliga exportvägen. En mockad export visar bara vad du själv lät den svara med.
Vad som faktiskt provades
Den 9 november 2026 kördes dessa två testfall på Windows med Node.js 24.13.0, Playwright Test 1.64.1 och installerad Google Chrome. Båda passerade. Proven omfattade lokala browsernedladdningar, filnamn, sparad kopia, korrekta UTF-8-bytes och upptäckt av en avsiktligt felaktig datarad. Resultatet gäller denna fixture och innehåller ingen bedömning av en publicerad app, databas eller behörighetsmodell.
FAQ
Betyder download-händelsen att hela filen är sparad?
Nej, händelsen kommer när nedladdningen börjar. Vänta på saveAs innan du läser din sparade kopia.
Varför ska jag inte använda suggestedFilename som sökväg?
I övningen kontrollerar du det föreslagna namnet separat och sparar under ett fast lokalt namn. Då bestämmer testet var kopian hamnar.
Varför är negativprovet grönt när filen är fel?
Det testet kräver att bytejämförelsen underkänner den felaktiga filen. Om jämförelsen släpper igenom filen ska negativprovet bli rött.
Ersätter detta prov av exportens behörigheter?
Nej, den lokala övningen har varken databas eller användarkonton. Urval, kolumner och behörigheter behöver egna prov i din riktiga app.
Källor och metod
- Playwright: Downloads — väntans ordning och temporära filer.
- Playwright: Download — händelse, failure, föreslaget namn och saveAs.
- Playwright: TestInfo.outputPath — testets isolerade filväg.
- Playwright: Browsers — installerad Chrome som webbläsarkanal.