{"canonical_url":"https://engineer.company/nb/glossary/axe/","content_markdown":"# axe\n\n## Hva det er\n\naxe, publisert som JavaScript-biblioteket axe-core med åpen kildekode, er et sett automatiserte\nregler for universell utforming som kjører inne i en nettside, undersøker det nettleseren har\ngjengitt, og melder fra om hvert element som bryter én av reglene. Deque Systems, et selskap som\narbeider med universell utforming, vedlikeholder det under Mozilla Public License 2.0. Andre verktøy\nbygger på det: kategorien for tilgjengelighet i Lighthouse fra Chrome vekter revisjonene sine etter\nalvorlighetsgradene til axe, og Playwrights egen veiledning i testing av tilgjengelighet kjører axe\ngjennom en liten tilleggspakke.\n\nMotoren er ett enkelt skript. En testkjører eller en nettleserutvidelse laster det inn i siden som\ntestes, og kaller `axe.run`, og motoren går gjennom dokumentet, også nøstede rammer og shadow DOM,\nog bruker hver regel der betingelsene stemmer. Fordi den leser siden etter at nettleseren har lagt\nden ut, kan den sjekke ting kildekoden alene ikke viser: om teksten er synlig, hvilken farge den\nstår på, om et element er skjult. Det er også grunnen til at noen regler trenger en ekte nettleser.\nProsjektet sier at regelen for fargekontrast ikke virker i JSDOM, det simulerte dokumentet mange\noppsett for enhetstester bruker.\n\nHver regel har merkelapper (tags). Én av dem sier hvilken WCAG-versjon og hvilket nivå regelen hører\ntil, f.eks. `wcag2a`, `wcag2aa`, `wcag21aa` eller `wcag22aa`, eller merker den `best-practice` når\ningen suksesskriterier krever den. Andre merkelapper knytter regler til EN 301 549, Section 508\neller W3Cs testregler for samsvar. Merkelappene er måten et team bestemmer hva en kjøring sjekker\npå.\n\nDet som kommer tilbake, er ikke ett enkelt bestått eller ikke bestått, men fire lister:\n\n- `violations`: elementer som brøt en regel, hver med en alvorlighetsgrad satt til minor, moderate,\n  serious eller critical, et kort sammendrag av hvordan det rettes, og en lenke til en lengre\n  forklaring.\n- `passes`: elementer som besto, og det er slik et team kan se at en regel faktisk ble kjørt.\n- `incomplete`, som dokumentasjonen også kaller «needs review»: elementer motoren verken kunne\n  godkjenne eller underkjenne med visshet, og som en person må se på.\n- `inapplicable`: regler som ikke hadde noe å teste, som reglene for video på en side uten video.\n\n## Hvorfor det er viktig\n\nBeslutningen axe hjelper med, er hvilke deler av universell utforming et team overlater til en\nmaskin, og om et brudd skal stoppe en utgivelse. To egenskaper gjør den egnet til den jobben. Den er\nbillig å kjøre, så den kan sjekke hvert bygg i stedet for én revisjon i året. Og målet utviklerne\nhar uttalt, er null falske positive, bortsett fra programvarefeil: alt motoren er usikker på, havner\npå listen til gjennomgang i stedet for på listen over brudd. En sjekk som roper ulv, blir slått av;\nen som bare melder det den kan bevise, kan stoppe et bygg uten at noen blir irritert.\n\nGrensen er dekningen. Deque sier at axe-core i gjennomsnitt finner 57 % av WCAG-problemene automatisk og sender usikre resultater til manuell vurdering. Tallet gjelder problemer som blir funnet, ikke andelen suksesskriterier en maskin kan vurdere.\n\nDet som ligger utenfor rekkevidde, er for det meste skjønn. axe kan bekrefte at et bilde har\nalternativ tekst, at en skjermknapp har et navn og at et skjemafelt har en etikett. Den kan ikke si\nom teksten beskriver bildet, om navnet sier hva knappen gjør, eller om siden gir mening når den\nleses høyt i rekkefølge. De spørsmålene trenger en person med en skjermleser og et tastatur, og\ntiden en maskin sparer på de mekaniske sjekkene, er tid den personen kan bruke på dem.\n\nValget av merkelapper er en avveining i seg selv. Å kjøre bare reglene som er merket for WCAG, gir\net resultat som passer rett inn i en samsvarserklæring, og ikke i noe annet. Å legge til reglene for\nbeste praksis fanger opp problemer WCAG ikke nevner, men som brukerne likevel møter, som innhold som\nligger utenfor hvert landemerke, eller en side uten overskrift på øverste nivå. Prisen er noen få\nbrudd som ingen samsvarsrevisjon ville vist til.\n\n## Slik ser det ut i praksis\n\nTo sider på dette nettstedet viser hva motoren blir betrodd.\n\nI testsuiten til én plattform står den ved siden av fire lag med tester, og\n[en kvalitetsport med axe-core krever null brudd på WCAG 2.0 og 2.1 på nivå A og AA](/nb/portfolio/built-a-test-suite-across-go-sql-and-browser/),\nnoe som gjør universell utforming til et bygg som feiler, i stedet for et funn i en revisjon flere\nmåneder senere. Poenget er tidspunktet: en feil som stopper bygget, blir rettet av personen som\nnettopp skrev den, mens endringen fortsatt er åpen.\n\nPå dette nettstedet beskriver [kolofonen](/nb/credits/) hvordan motoren reviderer et utvalg\nrepresentative sider, én per mal på hvert språk, mot WCAG 2.2 A og AA i begge fargeskjemaene, som en\ndel av kontrollen og ikke som en rapport ved siden av den. At den kjører i begge fargeskjemaene,\nbetyr at et kontrastbrudd som bare viser seg i det mørke skjemaet, fortsatt kan stoppe bygget. Å\nteste én side per mal bygger på at sider laget fra samme mal deler struktur, og det var det som i\noktober 2026 lot 38 sider stå for et nettsted på 2 268. Automatiske regler dekker ikke alle vurderingene WCAG krever, og derfor fører nettstedet oversikten sin per suksesskriterium i stedet for som en samlet karakter.\n\n## Hvor det går galt\n\nDe fleste feil med axe er feil i tillit: en kjøring som sjekket mindre enn det så ut som, eller et\nresultat som blir lest som mer enn det sier.\n\n**En liste med merkelapper utelater regler.** Merkelappene er ikke kumulative. `wcag2aa` inneholder\nbare reglene for kriterier på nivå AA i WCAG 2.0, så en kjøring som er begrenset til den, hopper\nover hver regel på nivå A, og API-dokumentasjonen sier rett ut at både `wcag2a` og `wcag2aa` trengs.\nPå samme måte inneholder `wcag21aa` bare regler for kriterier som kom med 2.1, og en kjøring som er\nbegrenset til WCAG-merkelapper, kjører aldri en `best-practice`-regel. Regelbeskrivelsene oppgir\nreglene for WCAG 2.2 som slått av som standard, så en kjøring uten merkelapper utelater dem; når du\nnevner merkelappen deres, slås de på. Nevn hver merkelapp kjøringen skal dekke, og hold listen ved\nsiden av påstanden den støtter:\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 ikke står i noen av de fire listene, ble ikke kjørt i det hele tatt, så les gjennom\nlistene én gang hver gang konfigurasjonen endres.\n\n**En kjøring uten brudd blir lest som en tilgjengelig side.** Null brudd betyr at reglene som ble\nkjørt, ikke kunne bevise noen feil. Det sier ingenting om hvorvidt den alternative teksten er\nriktig, om fokus flytter seg i en fornuftig rekkefølge, eller om noen som bruker en skjermleser, kan\nfullføre oppgaven. Behandle kjøringen som et minstemål, og sett av tid til sjekkene den ikke kan\ngjøre.\n\n**Listen til gjennomgang blir droppet.** En kvalitetsport som bare feiler på brudd, slipper\n`incomplete`-resultatene gjennom uten at noen ser dem. Det er elementene motoren så på og lot stå\nuavgjort, og det gjør dem til tilfellene som mest trenger en person. Send dem til noen som kommer\ntil å lese dem, eller la bygget feile på dem også.\n\n**Siden testes i én tilstand.** Motoren sjekker det som er gjengitt i øyeblikket den kjører. En\nlukket meny, en dialog som ikke er åpnet, en feilmelding som bare dukker opp etter en ugyldig\ninnsending, og det andre fargeskjemaet ligger alle utenfor en kjøring mot siden slik den først\nlastes inn. Før siden inn i hver tilstand som betyr noe, og kjør motoren på nytt i hver av dem.\n\n**Motoren kjører der ingenting tegnes.** Et simulert dokument har verken layout eller beregnede\nfarger, og prosjektet oppgir fargekontrast som en regel som ikke virker der. Enhetstester med axe\nfanger fortsatt opp strukturelle problemer; kontrast og alt annet som er visuelt, hører hjemme i en\nekte nettleser.\n\n**En regel slås av for å få ut en utgivelse.** Å slå av en regel for hele kjøringen fordi én\nkomponent snubler i den, skjuler bruddene på den regelen alle andre steder, også på sider som\nskrives senere. Utelat heller det ene elementet, med en merknad om hvorfor og når unntaket skal\nfjernes.\n\n## Les mer\n\n- [axe-core](https://github.com/dequelabs/axe-core)\n  — kildekoden til motoren, prinsippene prosjektet har uttalt, og nettleserne som støttes.\n- [Rule Descriptions](https://github.com/dequelabs/axe-core/blob/develop/doc/rule-descriptions.md)\n  — hver regel med alvorlighetsgrad og merkelapper, gruppert etter WCAG-versjon, beste praksis, AAA,\n  eksperimentelle og utfasede regler.\n- [axe-core API](https://github.com/dequelabs/axe-core/blob/develop/doc/API.md)\n  — merkelappene, valget `runOnly`, hvordan du tar med eller utelater deler av en side, og formen på\n  de fire resultatlistene.\n- [Accessibility testing](https://playwright.dev/docs/accessibility-testing)\n  — Playwrights veiledning i å kjøre axe i nettlesertester, også å skanne en side etter at du har\n  samhandlet med den.\n\n\u003chttps://engineer.company/nb/glossary/axe/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Slik tester regelmotoren axe en ferdig gjengitt side, hva de fire resultatlistene forteller, og hvorfor en kjøring uten brudd er et minstemål og ikke en dom.","formats":{"gemtext":"https://engineer.company/nb/glossary/axe/index.gmi","gopher":"https://engineer.company/nb/glossary/axe/gophermap","html":"https://engineer.company/nb/glossary/axe/","json":"https://engineer.company/nb/glossary/axe/index.json","markdown":"https://engineer.company/nb/glossary/axe/index.md","pdf":"https://engineer.company/nb/glossary/axe/index.pdf"},"kind":"page","language":"nb","title":"Hva er axe?","url":"https://engineer.company/nb/glossary/axe/","version":1}