Så fungerar @holmdigital/engine
Publicerat av Holm Digital · April 2026 · 4 min läsning
De flesta tillgänglighetsverktyg stannar vid WCAG. De pekar på ett fel, ger dig en referens till rätt kriterium och lämnar resten till dig. Engine gör mer än så.
Från WCAG-fel till lagparagraf
Engine skannar en webbplats mot WCAG 2.1 och 2.2. Det är grunden. Men varje fel kopplas också till den nationella lagstiftning som gäller. Om webbplatsen ligger på en .se-domän kopplas felet till DOS-lagen. En .de-domän kopplas till BITV 2.0. En .au-domän till Disability Discrimination Act 1992.
Det sker automatiskt. Domändetekteringen avgör jurisdiktion, och rätt regeltext och tillsynsmyndighet kopplas till felet utan att du behöver konfigurera något.
Sektormedvetenhet
Engine skiljer på offentlig och privat sektor. Det spelar roll eftersom regelverken skiljer sig. Offentlig sektor i EU faller under Web Accessibility Directive (WAD). Privat sektor faller under European Accessibility Act (EAA). I Australien gäller DDA för båda, men med olika tillsynsvägar.
Beroende på vilken sektor du anger dirigerar engine till rätt tillsynsorgan och rätt kravnivå.
CI/CD-integration
Tillgänglighetstestning som körs en gång innan lansering är inte tillräckligt. Engine är byggt för att köras i varje pipeline. Integrationen fungerar med GitHub Actions, GitLab CI och Azure DevOps.
En skanning startas med en rad:
npx hd-a11y-scan https://dinwebbplats.se --lang sv --country SE --sector public --ci --junit report.xml --pdf report.pdf
Bygget bryts automatiskt vid kritiska fel. Du styr tröskeln själv, från critical till low. Rapporten genereras i tre format: JUnit XML för CI-dashboards, PDF för juridisk dokumentation och HTML som formellt tillgänglighetsutlåtande.
Rapportering
Engine genererar tillgänglighetsutlåtanden som följer kraven i respektive lands lagstiftning. Utlåtandet innehåller vilka sidor som skannats, vilka WCAG-kriterier som testats, vilka fel som hittats och vilken lag som berörs. Det går att använda direkt som underlag vid tillsyn.
Tekniken under huven
Engine stödjer Virtual DOM och Shadow DOM. Det gör att den fungerar med moderna ramverk som React, Vue och Angular, även när komponenterna är inkapslade. Testsviten innehåller 292 tester. Noll hårdkodade strängar. Alla texter hanteras via @holmdigital/standards, vilket gör att nya jurisdiktioner kan läggas till utan att engine behöver ändras.
Kom igång
Engine finns på NPM som @holmdigital/engine. Koden är öppen under MIT-licens.