Så fungerar @holmdigital/engine
Publicerat av Holm Digital · April 2026 · 4 min läsning
Engine pekar på ett fel, ger dig en referens till rätt kriterium och kopplar felet till en lagreferens.
Från WCAG-fel till lagreferens
Engine skannar en webbplats mot WCAG 2.1 AA och de första kriterierna i WCAG 2.2, riktlinjerna för tillgängligt webbinnehåll. Det är grunden. Varje fel får en lagreferens ur standards, och landets lag står i redogörelsen. För offentlig sektor kopplas en .se-domän 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 när du inte anger land. Regeltext och tillsynsmyndighet kopplas till dokumentet.
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). European Accessibility Act (EAA) gäller vissa produkter och tjänster inom privat sektor. I Australien gäller DDA för båda.
Beroende på vilken sektor du anger dirigerar engine till tillsynsorgan.
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 --statement report.html --junit report.xml --pdf report.pdf
Bygget bryts automatiskt vid kritiska fel. Rapporten genereras i tre format: JUnit XML för CI-dashboards, PDF för dokumentation och HTML som tillgänglighetsredogörelse.
Rapportering
Engine genererar tillgänglighetsredogörelser med uppgifter om vilka sidor som skannats, vilka WCAG-kriterier som testats, vilka fel som hittats och en lagreferens ur standards.
Tekniken under huven
Engine stödjer Virtual DOM och Shadow DOM. Den tekniska valideringen bygger på axe-core, ett open source-ramverk för automatiserad tillgänglighetstestning. Engine lägger det regulatoriska skiktet ovanpå. Det gör att den fungerar med moderna ramverk, även när komponenterna är inkapslade. Lagdatan ligger i standards. Engine har egna mallar per språk och några fasta reservtexter för när datan saknar en uppgift.
Kom igång
Engine finns på NPM som @holmdigital/engine. Koden är öppen under MIT-licens.