{"canonical_url":"https://engineer.company/sv/glossary/axe/","content_markdown":"# axe\n\n## Vad det är\n\nRegelmotorn axe, som ges ut som JavaScript-biblioteket axe-core med öppen källkod, är en uppsättning\nautomatiska regler för tillgänglighet som körs inuti en webbsida, granskar det som webbläsaren har\nrenderat och rapporterar varje element som bryter mot någon av reglerna. Deque Systems, ett företag\nsom arbetar med tillgänglighet, underhåller den under Mozilla Public License 2.0. Andra verktyg\nbygger på den: tillgänglighetskategorin i Chromes Lighthouse viktar sina granskningar efter de\nallvarlighetsgrader som axe sätter, och Playwrights egen guide till tillgänglighetstester kör axe\nvia ett litet tilläggspaket.\n\nMotorn är ett enda skript. En testkörare eller ett webbläsartillägg läser in det i sidan som testas\noch anropar `axe.run`, och motorn går igenom dokumentet, inklusive inbäddade ramar och shadow DOM,\noch tillämpar varje regel vars villkor stämmer. Eftersom den läser sidan efter att webbläsaren har\nlagt ut den kan den kontrollera sådant som källkoden ensam inte visar: om texten syns, vilken färg\nden står mot, om ett element är dolt. Det är också därför vissa regler behöver en riktig webbläsare.\nProjektet anger att dess regel för färgkontrast inte fungerar i JSDOM, det simulerade dokument som\nmånga uppsättningar för enhetstester använder.\n\nVarje regel bär taggar. En av dem anger vilken version och nivå av WCAG som regeln hör till, t.ex.\n`wcag2a`, `wcag2aa`, `wcag21aa` eller `wcag22aa`, eller märker den `best-practice` när inget\nframgångskriterium kräver den. Andra taggar knyter regler till EN 301 549, Section 508 eller W3C:s\nregler för konformitetstestning. Det är med taggarna som ett team bestämmer vad en körning\nkontrollerar.\n\nDet som kommer tillbaka är inte ett enda godkänt eller underkänt utan fyra listor:\n\n- `violations`: element som föll på en regel, vart och ett med en allvarlighetsgrad, minor,\n  moderate, serious eller critical, en kort sammanfattning av hur det åtgärdas och en länk till en\n  längre förklaring.\n- `passes`: element som klarade regeln, vilket är hur ett team kan se att en regel faktiskt kördes.\n- `incomplete`, som dokumentationen också kallar ”needs review”: element som motorn varken kunde\n  godkänna eller underkänna med säkerhet, och som en människa måste titta på.\n- `inapplicable`: regler som inte hade något att testa, t.ex. reglerna för video på en sida utan\n  video.\n\n## Varför det spelar roll\n\nBeslutet som axe tjänar är vilka delar av webbtillgängligheten ett team lämnar över till en maskin,\noch om ett fynd ska stoppa en release. Två egenskaper gör motorn lämpad för det. Den är billig att\nköra, så den kan kontrollera varje bygge i stället för en granskning om året. Och upphovspersonernas\nuttalade mål är noll falska positiva, buggar undantagna: allt som motorn är osäker på hamnar i\ngranskningslistan i stället för i listan över överträdelser. En kontroll som ropar varg blir\navstängd; en som bara rapporterar det den kan bevisa kan stoppa ett bygge utan att någon tar illa\nupp.\n\nBegränsningen är täckningen. Deque uppger att axe-core i genomsnitt hittar 57 % av WCAG-problemen automatiskt och lämnar osäkra resultat till manuell granskning. Siffran gäller hittade problem, inte andelen framgångskriterier som en maskin kan bedöma.\n\nDet som ligger utom räckhåll är mest omdöme. Motorn kan bekräfta att en bild har en alternativtext,\natt en knapp har ett namn och att ett formulärfält har en etikett. Den kan inte avgöra om texten\nbeskriver bilden, om namnet säger vad knappen gör eller om sidan hänger ihop när den läses upp i\nordning. De frågorna kräver en människa med en skärmläsare och ett tangentbord, och den tid som en\nmaskin sparar på de mekaniska kontrollerna är tid som den människan kan lägga på dem.\n\nValet av taggar är en avvägning i sig. Att bara köra de regler som är taggade för WCAG ger ett\nresultat som svarar rent mot ett påstående om konformitet, och mot inget annat. Att lägga till\nreglerna för bästa praxis fångar problem som WCAG inte namnger men som användare ändå stöter på,\nt.ex. innehåll som ligger utanför varje landmärke eller en sida utan rubrik på översta nivån.\nKostnaden är några fynd som ingen granskning av konformitet skulle hänvisa till.\n\n## Så ser det ut i praktiken\n\nTvå sidor på den här webbplatsen visar vad motorn anförtros.\n\nI en plattforms testsvit står den bredvid fyra lager av tester, och\n[en axe-core-grind kräver noll överträdelser av WCAG 2.0 och 2.1 på nivå A och AA](/sv/portfolio/built-a-test-suite-across-go-sql-and-browser/),\nvilket gör tillgänglighet till ett byggfel i stället för ett granskningsfynd månader senare. Poängen\när tidpunkten: en defekt som får bygget att fallera rättas av den som just skrev den, medan\nändringen fortfarande är öppen.\n\nPå den här webbplatsen beskriver [kolofonen](/sv/credits/) hur motorn granskar ett urval\nrepresentativa sidor, en per mall på varje språk, mot WCAG 2.2 A och AA i båda färgschemana, som en\ndel av kvalitetsgrinden och inte som en rapport bredvid den. Att köra i båda färgschemana innebär\natt ett kontrastproblem som bara visar sig i det mörka schemat ändå kan stoppa bygget. Urvalet med\nen sida per mall bygger på att sidor som byggs från samma mall delar struktur, och det var det som i\noktober 2026 lät 38 sidor stå för en webbplats med 2 268. Automatiska regler täcker inte alla bedömningar i WCAG, och därför för webbplatsen sin redovisning per framgångskriterium i stället för som ett samlat godkänt.\n\n## Var det går fel\n\nDe flesta misslyckanden med axe är förtroendefel: en körning som kontrollerade mindre än det\nverkade, eller ett resultat som lästes som mer än det säger.\n\n**En tagglista utelämnar regler.** Taggar är inte kumulativa. `wcag2aa` innehåller bara reglerna för\nkriterier på nivå AA i WCAG 2.0, så en körning som begränsas till den hoppar över varje regel på\nnivå A, och API-dokumentationen säger rakt ut att både `wcag2a` och `wcag2aa` behövs. På samma sätt\ninnehåller `wcag21aa` bara regler för kriterier som 2.1 lade till, och en körning som begränsas till\nWCAG-taggar kör aldrig någon regel märkt `best-practice`. Regelbeskrivningarna listar reglerna för\nWCAG 2.2 som avstängda som standard, så en körning utan taggar utelämnar dem; att namnge deras tagg\nslår på dem. Namnge varje tagg som körningen ska täcka, och håll listan bredvid det påstående den\nstöder:\n\n```js\nconst results = await axe.run(document, {\n    runOnly: {\n        type: \"tag\",\n        values: [\"wcag2a\", \"wcag2aa\", \"wcag21a\", \"wcag21aa\", \"wcag22aa\"],\n    },\n});\n```\n\nEn regel som inte finns i någon av de fyra listorna kördes inte alls, så läs igenom listorna en gång\nvarje gång konfigurationen ändras.\n\n**En felfri körning läses som en tillgänglig sida.** Noll överträdelser betyder att de regler som\nkördes inte kunde bevisa något fel. Det säger ingenting om huruvida alternativtexten stämmer, om\nfokus flyttas i en rimlig ordning eller om någon som använder en skärmläsare kan slutföra uppgiften.\nBehandla körningen som golvet, och planera in de kontroller den inte kan göra.\n\n**Granskningslistan tappas bort.** En grind som bara fäller på överträdelser släpper igenom\nresultaten i `incomplete` utan att någon ser dem. Det är de element som motorn tittade på och\nlämnade obestämda, vilket gör dem till de fall som mest behöver en människa. Skicka dem till någon\nsom läser dem, eller låt bygget fallera på dem också.\n\n**Sidan testas i ett enda tillstånd.** Motorn kontrollerar det som är renderat i det ögonblick den\nkörs. En stängd meny, en dialog som inte har öppnats, ett felmeddelande som bara visas efter en\nfelaktig inskickning och det andra färgschemat ligger alla utanför en körning mot sidan så som den\nser ut när den först laddas. Driv sidan in i varje tillstånd som spelar roll, och kör motorn igen i\nvart och ett.\n\n**Motorn körs där ingenting ritas.** Ett simulerat dokument har ingen layout och ingen beräknad\nfärg, och projektet listar färgkontrast som en regel som inte fungerar där. Enhetstester med axe\nfångar fortfarande strukturella problem; kontrast och allt annat visuellt hör hemma i en riktig\nwebbläsare.\n\n**En regel stängs av för att få ut en release.** Att inaktivera en regel för hela körningen för att\nen komponent löser ut den döljer regelns fynd överallt annars, även på sidor som skrivs senare.\nUndanta i stället det enda elementet, med en kommentar om varför och när undantaget ska tas bort.\n\n## Läs mer\n\n- [axe-core](https://github.com/dequelabs/axe-core) — motorns källkod, dess uttalade principer och\n  listan över webbläsare som stöds.\n- [Rule Descriptions](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md) —\n  varje regel med dess allvarlighetsgrad och taggar, grupperade efter version av WCAG, bästa praxis,\n  AAA, experimentella och utfasade.\n- [axe-core API](https://github.com/dequelabs/axe-core/blob/develop/doc/API.md) — taggarna,\n  alternativet `runOnly`, hur delar av en sida tas med eller utesluts och formen på de fyra\n  resultatlistorna.\n- [Accessibility testing](https://playwright.dev/docs/accessibility-testing) — Playwrights guide\n  till att köra axe inuti webbläsartester, bl.a. hur en sida skannas efter att man har interagerat\n  med den.\n\n\u003chttps://engineer.company/sv/glossary/axe/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Hur regelmotorn axe testar en renderad sida, vad dess fyra resultatlistor betyder och varför en felfri körning är en lägstanivå, inte ett slutligt omdöme.","formats":{"gemtext":"https://engineer.company/sv/glossary/axe/index.gmi","gopher":"https://engineer.company/sv/glossary/axe/gophermap","html":"https://engineer.company/sv/glossary/axe/","json":"https://engineer.company/sv/glossary/axe/index.json","markdown":"https://engineer.company/sv/glossary/axe/index.md","pdf":"https://engineer.company/sv/glossary/axe/index.pdf"},"kind":"page","language":"sv","title":"Vad är axe?","url":"https://engineer.company/sv/glossary/axe/","version":1}