Addaw, joan hasierara Egin dohaintza

9. ikasgaia (10 guztira) · 16 min irakurtzeko · Berrikuspen-data: 26/10/2026

Proba automatikoak garapen-fluxuan: axe-core, eslint-plugin-jsx-a11y, Lighthouse eta e2e testak

Ikasgai ireki bat irakurtzen ari zara. Matrikulatu doan testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.

Irisgarritasun-arazo bat ekoizpenean zuzentzeak askoz gehiago kostatzen du editorean saihesteak baino. Tresna automatikoek ez dituzte arazo guztiak aurkitzen, baina errepikakorrenak berehala, koherentziaz eta doan aurkitzen dituzte, eta, batez ere, berriro ager daitezen eragozten dute. Ikasgai honek azaltzen du zer tresna egokitzen den garapen-fluxuaren puntu bakoitzean, nola konfiguratu eta, garrantzi berarekin, zer ezin duten egin.

Zer hautematen duten eta zer ez

Kalkulatzen da tresna automatikoek irisgarritasun-arazoen % 30 eta % 40 artean hautematen dituztela gutxi gorabehera; benetako ehunekoa webgune motaren araberakoa da. Oso ondo hautematen dute sintaktikoa eta deterministikoa dena: alt gabeko irudiak, etiketarik gabeko eremuak, hondo lauaren gaineko testuaren kontraste nahikorik eza, ARIA atributu baliogabeak, id bikoiztuak, lang falta izatea, izenik gabeko estekak, mailak saltatzen dituzten izenburuak, ezkutuko elementu fokugarriak. Ezin dute hauteman alt-a zuzena den, fokuaren ordenak zentzua duen, ARIA egoera eguneratzen den, botoi baten izenak bere ekintza deskribatzen duen, modal batek fokua itzultzen duen, karrusel bat pausa daitekeen edo testu bat ulergarria den. Horregatik, proba automatikoak beti osatzen dira aurreko ikastaroko teklatu-protokoloarekin eta pantaila-irakurgailuarekin egindako berrikuspenarekin.

Funtsezko puntua

«Zero errore axe-n» esan nahi du ez dagoela axe-k hautematen dakien errorerik. Irteera-lerroa da, ez helmuga. Erabili segurtasun-sare gisa, lehendik funtzionatzen zuen ezer hautsi ez dadin, eta eman giza denbora makinek ikusten ez dutenari.

axe-core: motor komuna

axe-core, Dequerena, kode irekiko irisgarritasun-arauen liburutegia da, eta axe DevTools luzapenaren, Lighthouseren, Microsoften Accessibility Insightsen eta beste integrazio askoren atzean dago. Haren filosofia positibo faltsurik ez ematea da: zerbait errore gisa markatzen duenean, ia beti errorea da; horren truke, erabaki ezin duena «berrikusi behar da» gisa markatzen du (irudien gaineko kontrastea, adibidez). Hainbat puntutan integratzen da:

  • Nabigatzailea: axe DevTools luzapena, uneko orria garapenean zehar aztertzeko.
  • Osagaien proba unitarioak: jest-axe-k edo vitest-axe-k osagai batek errendatutako HTMLaren gainean exekutatzen dituzte arauak.
  • Muturretik muturrerako probak: @axe-core/playwright-ek eta cypress-axe-k benetako orriak aztertzen dituzte nabigatzailean, egoera bakoitzean (modala irekita, formularioa erroreekin).
  • Garapena Reacten: @axe-core/react-ek arazoak kontsolan erakusten ditu programatzen ari zaren bitartean, baina React 17 arte bakarrik onartzen du; ondorengo bertsioetan, erabili luzapena edo osagaien probak.

Adibidea

Hasierako orria eta, gainera, elkarrizketa-koadroa irekita duen egoera aztertzen dituen muturretik muturrerako proba Playwrightekin:

import { test, expect } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';

test('aurretiazko hitzordua irisgarritasun-errorerik gabe', async ({ page }) => {
  await page.goto('/tramites/cita-previa');
  const inicial = await new AxeBuilder({ page })
    .withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'wcag22aa'])
    .analyze();
  expect(inicial.violations).toEqual([]);

  await page.getByRole('button', { name: 'Aukeratu zentroa' }).click();
  const conDialogo = await new AxeBuilder({ page }).analyze();
  expect(conDialogo.violations).toEqual([]);
});

Erreparatu bi gauzari: arauak WCAGen etiketen arabera iragazten dira, txostenak taldearen hizkuntza hitz egin dezan, eta interfazearen egoera bakoitza aztertzen da, ez hasierako karga bakarrik.

Muturretik muturrerako probek teklatu-protokoloaren zati bat automatizatzeko ere balio dute: Playwrightek Tab sakatzeko eta zer elementuk duen fokua egiaztatzeko aukera ematen du, Escape sakatu eta elkarrizketa-koadroa ixten dela eta fokua botoira itzultzen dela egiaztatzeko, edo fitxa batzuetan gezi-teklak sakatu eta aria-selected egiaztatzeko. Eta funtzioaren araberako locator-ek (getByRole('button', { name: 'Gorde' })) test bakoitza egiaztapen inplizitu bihurtzen dute: kontrolek funtzio eta izen irisgarriak dituztela egiaztatzen dute; ez badituzte, testak ez du elementua aurkitzen.

Lintinga: erroreak idaztean harrapatzea

eslint-plugin-jsx-a11y-k Reacten JSXa aztertzen du editorean eta integrazio jarraituan, probatzeko orri bat existitu aurretik. Hauek hautematen ditu: alt gabeko irudiak, funtziorik eta teklatu-euskarririk gabeko elementu ez-elkarreragileetako onClick-ak, aria-* baliogabeak, kontrol loturarik gabeko label-ak, autoFocus, accessKey, href gabeko estekak, onartzen ez diren funtzioak eta gehiago. plugin:jsx-a11y/recommended konfigurazioarekin aktibatzen da, eta komeni da strict modua erabiltzea proiektu berrietan. Vuerako eslint-plugin-vuejs-accessibility dago, eta Angularrerako, angular-eslint-en irisgarritasun-arauek (txantiloiak) antzeko kasuak hartzen dituzte. HTML estatikorako, html-validate-k irisgarritasun-arauak ditu, eta W3Cren balidatzaileak laguntza-teknologietan eragina duten markaketa-erroreak hautematen ditu.

Lighthouse eta orri-auditoriak

Lighthousek (Chromen integratua eta CIn lighthouse-ci-rekin exekutagarria) axe-ren arauen azpimultzo bat erabiltzen du, eta 0tik 100erako puntuazio bat itzultzen du. Puntuazio hori erabilgarria da joera jarraitzeko eta zuzendaritzak uler dezan, baina engainagarria da betetze-neurri gisa: 100 duen orri bat ez-irisgarria izan daiteke (fokuaren ordena, ARIA egoerak, modalak), eta 85 duen batek arazo txikiak baino ez izan. Erabili adierazle gisa, inoiz ez ziurtagiri gisa. Pa11yk eta pa11y-cik gauza bera egiten dute HTML CodeSniffer edo axe motorrarekin, eta erosoak dira webgune bateko dozenaka URL arakatzeko inplementazio bakoitzean.

Non jarri tresna bakoitza

UneaTresnaZer ematen duen
Kodea idazteaneslint-plugin-jsx-a11y, html-validate, @axe-core/react (React 17 arte)Markaketa- eta ARIA erroreak berehala
Osagaien probakjest-axe, vitest-axeDiseinu-sistemaren osagai bakoitza garbi, bere egoera guztietan
e2e probak@axe-core/playwright, cypress-axe + teklatu-baieztapenakBenetako orriak, fluxu osoak, modalak, formularioetako erroreak
Integrazio jarraituapa11y-ci, lighthouse-ciURLen arakatzea eta puntuazioaren joera
Eskuzko berrikuspenaaxe DevTools, Accessibility Insights, nabigatzailearen ikuskatzaileaEsplorazio gidatua eta makinek ikusten ez dutenaren egiaztapena

Ohiko akatsa

axe CIn instalatzea, heredatutako 300 errore ikustea eta egiaztapena desaktibatzea «denbora egon arte». Hobe: ezarri uneko kopurua gehieneko atalase gisa (ezin da hazi), zuzendu sortaka eta jaitsi atalasea iterazio bakoitzean. Eta konfiguratu proba hasieran eragin kritiko eta larriko erroreekin bakarrik huts egin dezan, eta zabaldu gero.

Egindakoaren definizioa

Horrek guztiak eragina izan dezan, irisgarritasunak istorio bakoitzaren onarpen-irizpideen eta taldearen egindakoaren definizioaren parte izan behar du. Gutxieneko bertsio bat:

  1. Irisgarritasun-linter-ak ez du errorerik erakusten.
  2. axe-rekin egindako osagai-probak egoera guztietan gainditzen dira.
  3. axe-rekin egindako e2e probak ukitutako orri eta fluxuetan gainditzen dira.
  4. Kodea berrikusten duenak funtzionaltasuna teklatuarekin korritu du, protokoloari jarraituz.
  5. Osagai berriak pantaila-irakurgailu batekin probatu dira, eta beren teklatua dokumentatzen dute.

Kate horrekin, makinek hautematen dituzten arazoak ez dira itzultzen, eta pertsonen denbora giza irizpidea behar duenean kontzentratzen da.

Laburpena

  • Tresna automatikoek arazoen herena inguru hautematen dute, sintaktikoak eta deterministikoak; gainerakoek teklatua, pantaila-irakurgailua eta giza irizpidea eskatzen dituzte.
  • axe-core da motor komuna: luzapena, jest-axe/vitest-axe osagaietan, @axe-core/playwright edo cypress-axe e2e probetan.
  • eslint-plugin-jsx-a11y-k (eta Vue eta Angularrerako baliokideek) erroreak idaztean harrapatzen dituzte.
  • Lighthouseren puntuazioa joeraren adierazle bat da, ez betetze-ziurtagiri bat.
  • Ezarri hazi ezin diren atalaseak, aztertu interfazearen egoera bakoitza eta egin irisgarritasuna egindakoaren definizioaren parte.

Ikastaro honetako 3 ikasgai irakurri dituzu: ez itzazu galdu

Sortu zure kontua doan, gorde irakurri duzuna eta jarraitu ikastaroarekin, osorik:

  • Ikasgai honetako testa (3 galdera), ikasitakoa egiaztatzeko
  • Benetako orriekin egindako ariketa praktikoak
  • Zure aurrerapena gordeta: utzi zenuen lekutik jarraituko duzu, edozein gailutatik
  • Ikastaroaren egiaztagiria, orduekin, eta 3. mailako doako ziurtagiria azterketa gainditzen duzunean

Zure Google kontuarekin edo zure posta elektronikoarekin bakarrik sartzen zara. Ez duzu pasahitzik behar.