{"canonical_url":"https://engineer.company/sv/glossary/playwright/","content_markdown":"# Playwright\n\n## Vad det är\n\nPlaywright är ett ramverk med öppen källkod från Microsoft för att automatisera webbläsare, med ett\noch samma programmeringsgränssnitt för Chromium, Firefox och WebKit. Playwright Test, publicerat på\nnpm som `@playwright/test`, är testköraren som är byggd ovanpå det, och det är den som de flesta\nmenar när de använder namnet. Samma projekt levererar också det rena biblioteket för skript som inte\när tester, ett kommandoradsverktyg och en MCP-server riktad till AI-agenter, och ett tillägg för\nVisual Studio Code, allt under Apache License 2.0.\n\nUtöver JavaScript och TypeScript går samma styrning av webbläsaren att nå från Python, där projektet\nrekommenderar sitt plugin för pytest, från Java, med valfritt testramverk som JUnit, och från .NET,\nmed basklasser för MSTest, NUnit och xUnit.\n\nKommandot `npx playwright install` laddar ned projektets egna byggen av de tre motorerna,\noch eftersom varje release flyttar fram de versionerna kan kommandot behöva köras igen\nefter en uppgradering. Playwright kan också styra Google Chrome och Microsoft Edge där de\nredan finns på maskinen. Som standard körs testerna headless, utan synligt fönster.\nExemplet i installationsguiden kör tester parallellt över alla tre motorerna genom\nkonfigurerade webbläsarprojekt; utan dessa projekt är Chromium testkörarens\nstandardwebbläsare. Varje test får en ny webbläsarkontext, motsvarigheten till en ny\nwebbläsarprofil, så att kakor och lagring från ett test aldrig följer med till nästa.\n\nEtt test läses som de steg en person skulle ta:\n\n```js\nimport { test, expect } from \"@playwright/test\";\n\ntest(\"signing in opens the inbox\", async ({ page }) =\u003e {\n    await page.goto(\"https://example.com/sign-in\");\n    await page.getByLabel(\"Email\").fill(\"reader@example.com\");\n    await page.getByRole(\"button\", { name: \"Sign in\" }).click();\n    await expect(page.getByRole(\"heading\", { name: \"Inbox\" })).toBeVisible();\n});\n```\n\nTvå mekanismer bär det mesta av tyngden. Före en handling kör Playwright kontroller av att elementet\ngår att agera på, i dokumentationen kallade actionability checks, och väntar tills alla har gått\nigenom. För ett klick måste locatorn peka ut exakt ett element, och det elementet måste vara\nsynligt, stabilt, vilket betyder samma omgivande ruta under minst två animationsbildrutor i följd,\nkunna ta emot klicket i stället för att ligga under ett annat element, och aktiverat. Om\nkontrollerna inte går igenom inom tidsgränsen slutar handlingen i ett `TimeoutError`. Påståenden,\nassertions, som skrivs som `await expect(locator)` beter sig på samma sätt: de hämtar elementet om\noch om igen tills villkoret är uppfyllt eller tidsgränsen för påståendet, fem sekunder som standard,\nlöper ut.\n\n## Varför det spelar roll\n\nBeslutet som Playwright tjänar är vilket beteende som måste kontrolleras i en riktig webbläsare, och\nhur de kontrollerna blir tillräckligt pålitliga för att ett rött bygge ska bli trott. Vissa fel\nuppstår först när sidan är ihopsatt: en dialog som täcker knappen den skulle visa, en layout som\ndöljer ett fält vid en viss bredd, ett skript som fungerar i en motor och kastar ett fel i en annan.\nTester som kör kodbitar isolerat ser dem aldrig.\n\nWebbläsartester blir opålitliga, flaky, när testet och sidan tävlar med varandra. Sidan hämtar data,\nanimerar och renderar om, och ett test som klickar i samma ögonblick som raden körs klickar ibland\nför tidigt. Det vanliga botemedlet var en fast paus, för kort på en långsam maskin och bortkastad\ntid på en snabb. Automatisk väntan och påståenden som försöker igen ersätter pausen med det villkor\nsom testet faktiskt beror på. Guiden om assertions säger det rakt ut: webbsidor visar information\nasynkront, och påståenden som bara kontrollerar en gång leder till flaky tester.\n\nDet andra valet är hur ett test hittar saker. Guiden om locators rekommenderar i första hand\nattribut som användaren möter, och rollocators framför allt, eftersom `getByRole` med ett\ntillgängligt namn är det närmaste ett test kommer hur användare och hjälpmedel uppfattar sidan. Det\nhar en bieffekt som är värd att ha: ett test som klickar på knappen med namnet ”Sign in” går sönder\nom knappen förlorar sitt namn, vilket är samma defekt som den som använder skärmläsare skulle möta.\nGuiden säger också att rollocators varken ersätter granskningar av tillgänglighet eller tester av\növerensstämmelse. Test-id är reservlösningen. Guiden kallar dem det mest motståndskraftiga\nalternativet och samtidigt något som användaren aldrig ser, så en svit som hittar allt via id\nbevisar mindre om vad en besökare upplever. Selektorer i CSS och XPath avråder guiden från, eftersom\nDOM ändras ofta.\n\nKostnaden är tid. Att starta en webbläsare och läsa in en sida gör\nwebbläsartester till den långsammaste sorten ett projekt har. När ett av dem\nmisslyckas på en byggserver hjälper Trace Viewer till att undersöka felet. Det\ndokumenterade konfigurationsexemplet spelar in en trace vid första omförsöket av\nett misslyckat test, med två omförsök på CI och noll lokalt; testkörarens\ninbyggda standardinställningar ger varken traceinspelning eller omförsök. Tracen\nstegar igenom varje handling med sidan före och efter den, nätverksanropen och\nkonsolen.\n\n## Så ser det ut i praktiken\n\nEn plattform här har sin affärslogik i databasen, och arbetet var att\n[bygga en skiktad testsvit över fyra lager](/sv/portfolio/built-a-test-suite-across-go-sql-and-browser/).\nDen uttalade uppgiften var att verifiera varje lagers beteende där beteendet faktiskt finns, ”i\nstället för att allt verifierades utifrån genom en webbläsare”. Go-API:t har 981 testfunktioner.\nDatabasen har 494 beteendetestfiler, så att en lagrad funktion testas i databasen i stället för\ngenom tre lager applikation ovanför. Frontenden har 543 testspecifikationer i Vitest och Playwright,\ndäribland 48 end-to-end-filer och 30 webbläsarspecifikationer, och sidan ger ett och samma tal för\nbåda verktygen. Hela sviten körs som 10 jobb i ett arbetsflöde på 612 rader, och sidan är rak om\npriset: sviten är långsam, den belastar varje ändring, och i den här storleken behöver den eget\nunderhåll.\n\nDen här webbplatsen styr sina egna webbläsarkontroller med ett annat bibliotek, Puppeteer, och\n[kolofonen](/sv/credits/) visar samma avvägning. De kontrollerna täcker det som en validator inte\nkan göra, som uppmätt kontrast, fokusordning, målstorlek, innehåll som sticker utanför visningsområdet och\nsidbrytningar vid utskrift. Spärren kör alla utom kontrollen av sådant innehåll före varje push; den kontrollen kör en\nmänniska vid behov, precis som den visuella regressionsjämförelsen pixel för pixel.\n\n## Var det går fel\n\nDe flesta problem med Playwright kommer från tester som kontrollerar mindre än deras namn påstår.\n\n**En fast paus står i stället för ett villkor.** Ett test väntar två sekunder och läser sedan sidan,\neller läser ett värde en gång och jämför det med ett allmänt påstående. På en upptagen byggserver är\ntvå sekunder ibland för kort. Gör påståendet om det en besökare skulle se, med ett så kallat\nweb-first-påstående som `toHaveText`, och låt det försöka igen.\n\n**Element hittas via sin märkning.** En selektor genom tre nästlade `div`-element eller en stilklass\ngår sönder vid nästa omdesign medan sidan fortfarande fungerar. Hitta elementet efter roll och\ntillgängligt namn, eller efter etikett eller text, och lägg till ett test-id bara när en användare\nannars skulle sakna något att känna igen elementet på.\n\n**En godkänd rollocator tas för en tillgänglighetskontroll.** `getByRole` bevisar att ett element\nhar den roll och det namn som testet bad om. Om kontrast, fokusordning eller resten av sidan säger\ndet ingenting. För det behövs en regelmotor som axe, körd från testet, så som\n[guiden](https://playwright.dev/docs/accessibility-testing) från Playwright själva gör genom\n`@axe-core/playwright`. Skanningen täcker sidan i det tillstånd den har när den anropas, så öppna\nmenyn eller dialogen först.\n\n**Ett klick tvingas igenom.** Alternativet `force` stänger av de kontroller som inte är nödvändiga,\noch för ett klick slutar Playwright kontrollera att målet faktiskt tar emot händelsen. Ett test som\nbehöver det går ofta runt något som en besökare också skulle möta, som en banner över knappen.\nBehandla det ursprungliga felet som ett fynd, och stäng antingen bannern så som en besökare skulle\ngöra eller rätta överlappningen.\n\n**Ett flaky test körs om tills det går igenom.** Med omförsök påslagna markeras ett test som\nfallerar vid första körningen och går igenom vid ett omförsök som flaky i stället för misslyckat.\nEtt test som är flaky vecka efter vecka tävlar antingen med sidan eller fångar ett verkligt fel som\nkommer och går, och den trace som spelades in vid dess första omförsök är stället att börja leta.\n\n**Allt kontrolleras genom webbläsaren.** En regel om priser eller behörigheter som testas genom att\nklicka sig igenom tre skärmar är långsam och går sönder av skäl som saknar samband med regeln. Testa\nregeln där den finns, och behåll webbläsartesterna för det som bara en webbläsare kan visa: resan,\nlayouten och skillnaderna mellan motorerna.\n\n## Läs mer\n\n- [Installation](https://playwright.dev/docs/intro) — att installera Playwright Test, köra\n  exempeltesterna, HTML-rapporten och UI Mode.\n- [Locators](https://playwright.dev/docs/locators) — den rekommenderade ordningen för att hitta\n  element, från roll och etikett till test-id.\n- [Auto-waiting](https://playwright.dev/docs/actionability) — kontrollerna bakom varje handling och\n  vad `force` stänger av.\n- [Assertions](https://playwright.dev/docs/test-assertions) — påståenden som försöker igen och\n  sådana som inte gör det, standardtidsgränsen, mjuka påståenden och polling.\n- [Trace viewer](https://playwright.dev/docs/trace-viewer-intro) — att spela in en trace vid\n  omförsök och stega igenom ett misslyckat test handling för handling.\n- [Browsers](https://playwright.dev/docs/browsers) — att installera motorerna, köra\n  märkesversionerna av Chrome och Edge och de två headless-lägena.\n\n\u003chttps://engineer.company/sv/glossary/playwright/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Vad Playwright Test väntar på före varje klick, varför det hittar element efter roll och namn och vad en svit i riktiga webbläsare kostar att underhålla.","formats":{"gemtext":"https://engineer.company/sv/glossary/playwright/index.gmi","gopher":"https://engineer.company/sv/glossary/playwright/gophermap","html":"https://engineer.company/sv/glossary/playwright/","json":"https://engineer.company/sv/glossary/playwright/index.json","markdown":"https://engineer.company/sv/glossary/playwright/index.md","pdf":"https://engineer.company/sv/glossary/playwright/index.pdf"},"kind":"page","language":"sv","title":"Vad är Playwright?","url":"https://engineer.company/sv/glossary/playwright/","version":1}