6. ikasgaia (10 guztira) · 11 min irakurtzeko · Berrikuspen-data: 26/10/2026
QA eta automatizazioa: axe-core, Playwright, pa11y-ci eta egindakoaren definizioa
Ikasgai ireki bat irakurtzen ari zara. Matrikulatu testak eta ariketak egiteko, zure aurrerapena gordetzeko eta ziurtagiria lortzeko.
Matrikulatu · 7. maila (179 €)Automatizazioak ez du produktu bat irisgarri bihurtzen, baina irisgarri izateari uztea saihesten du. Integrazio jarraituko fluxuan ondo kokatutako proba automatikoen multzo batek atzerakada ohikoenak segundotan antzematen ditu, QA askatzen du giza irizpidea eskatzen duten egiaztapenetarako, eta erakundeari segurtasun-sare neurgarri bat ematen dio. Ikasgai honetan ikusiko duzu zer tresna erabili, non kokatu, nola konfiguratu eta, batez ere, zer ezin duten egin.
Zer estaltzen duen automatizazioak eta zer ez
Arauetan oinarritutako tresna automatikoek (axe-core da motorrik zabalduena; Lighthousek eta luzapen askok ere erabiltzen dute) modu fidagarrian antzematen dituzte honelako arazoak: alt atributurik gabeko irudiak, etiketarik gabeko eremuak, testu lauko kontraste nahikoa ez dutenak, ARIA atributu baliogabeak edo gaizki konbinatuak, orriaren hizkuntzarik eza, izenburu hutsak, testurik gabeko estekak, identifikatzaile bikoiztuak. Hainbat azterketaren arabera, eskuzko auditoria batean agertzen diren arazoen % 30 eta % 40 artean estaltzen dituzte gutxi gorabehera (fabrikatzaile batzuek, gorabehera-kopuruaren arabera neurtuta eta ez irizpideen arabera, zifra handiagoak ematen dituzte); eta, kasu askotan, pertsona batek berretsi behar duen arazo baten aukera soilik adierazten dute.
Ezin dute ebaluatu testu alternatibo bat egokia den, fokuaren ordenak zentzurik duen, errore-mezu batek zuzentzen laguntzen duen, osagai pertsonalizatu bat espero bezala erabiltzen den teklatuarekin, azpitituluak zuzenak diren edo prozesu oso bat pantaila-irakurgailuarekin amaitu daitekeen. Egiaztapen horiek eskuzko probetarako geratzen dira, eta horiek ere prozesuan berdin zehaztuta egon behar dute.
Funtsezko puntua
Automatizatu atzerakadak saihesteko eta denbora askatzeko; probatu eskuz esperientzia egiaztatzeko. Axerekin «berdez» dagoen pipeline batek esan nahi du ez dituzula akats nabarmenenak sartu, ez produktua irisgarria denik.
Non kokatu probak: piramidea
| Maila | Ohiko tresna | Zer probatzen du | Noiz exekutatzen da |
|---|---|---|---|
| Edizioa | Linterrak (eslint-plugin-jsx-a11y, txantiloien arauak) | Markaketa-akatsak iturburu-kodean | Idaztean eta pre-commit-ean |
| Osagaia | axe-core proba unitarioetan edo Storybooken | Osagai bakoitza bere egoeretan | Commit bakoitzean |
| Integrazioa / e2e | Playwright edo Cypress axe-corerekin | Benetako pantailak eta fluxuak, datuekin | Pull request bakoitzean |
| Hedatutako gunea | pa11y-ci, Lighthouse CI, arakatzaileak | Proba- edo produkzio-inguruneko URL asko | Gauez edo hedapen bakoitzaren ondoren |
| Eskuzkoa | Teklatua, NVDA, VoiceOver, zooma | Fluxu osoak eta giza irizpidea | Istorio bakoitza itxi aurretik eta bertsio bakoitzean |
axe-core Playwrightekin
Playwright muturretik muturrerako proba-esparru bat da, benetako nabigatzaileak kontrolatzen dituena. @axe-core/playwright pakete ofizialak fluxu bateko edozein puntutan aztertzeko aukera ematen du orria, elkarreragin ondoren soilik agertzen diren egoerak barne (elkarrizketa-koadro ireki bat, erakutsitako baliozkotze-errore bat).
import { test, expect } from '@playwright/test';
import AxeBuilder from '@axe-core/playwright';
test('aurretiazko hitzorduaren formularioak ez du urraketarik', async ({ page }) => {
await page.goto('/cita-previa');
await page.getByRole('button', { name: 'Jarraitu' }).click(); // baliozkotze-erroreak eragiten ditu
const resultados = await new AxeBuilder({ page })
.withTags(['wcag2a', 'wcag2aa', 'wcag21a', 'wcag21aa', 'wcag22aa'])
.exclude('#widget-de-terceros')
.analyze();
expect(resultados.violations).toEqual([]);
});Konfigurazioko erabaki garrantzitsu batzuk:
- Etiketak (tags): mugatu eskatzen dituzun mailetara (2.0, 2.1 eta 2.2 bertsioetako A eta AA), pipelineak huts egin ez dezan betetze-irizpide ez diren jardunbide egokien arauengatik, edo sartu horiek abisu gisa, ez errore gisa.
- Salbuespenak: baztertu zuzendu ezin dituzun hirugarrenen osagaiak, baina erregistratu arrisku ezagun gisa eta berrikusi eskuzko probetan; ez ahaztu.
- Egoerak: aztertu elkarreragin ondoren. ARIA arazo gehienak menu irekietan, elkarrizketa-koadroetan eta errore-mezuetan agertzen dira, ez hasierako kargan.
- Txostena: gorde emaitzen JSONa pipelineko artefaktu gisa, joerak aztertu ahal izateko.
Cypressekin, cypress-axe paketeak ikuspegi bera eskaintzen du, cy.injectAxe() eta cy.checkA11y() erabiliz.
pa11y-ci URL askotarako
pa11y-ci-k URL zerrenda bat (edo sitemap bat) igarotzen du eta huts egiten du erroreak aurkitzen baditu; horregatik da ezin hobea proba- edo produkzio-ingurunea gauez arakatzeko. .pa11yci fitxategi tipiko bat:
{
"defaults": {
"standard": "WCAG2AA",
"runners": ["axe", "htmlcs"],
"timeout": 30000,
"hideElements": "#cookie-banner",
"chromeLaunchConfig": { "args": ["--no-sandbox"] }
},
"urls": [
"https://pruebas.ejemplo.es/",
"https://pruebas.ejemplo.es/tramites",
{ "url": "https://pruebas.ejemplo.es/mi-cuenta", "actions": [
"set field #usuario to demo",
"set field #clave to demo",
"click element #entrar",
"wait for url to be https://pruebas.ejemplo.es/mi-cuenta/inicio"
]}
]
}Bi motor erabiltzeak (axe eta HTML_CodeSniffer) estaldura zabaltzen du, baina baita positibo faltsuak ere; berrikusi emaitzak blokeatzaile bihurtu aurretik. Hasteko atalase zentzuzko bat «aurreko exekuzioan baino errore gehiagorik ez» da, eta, egonkortu ondoren, «zero errore».
Egindakoaren definizioa eta onarpen-irizpideak QAn
Automatizazioak taldearen kontratuaren parte bada soilik funtzionatzen du. Bi dokumentuk finkatzen dute:
- Egindakoaren definizioa: irisgarritasun-pipelinea berdez pasatzen da; osagaia edo pantaila teklatuarekin probatu da; pantaila-irakurgailu batekin probatu da istorioak elkarreragina badu; edozein salbuespen proban bertan justifikatuta eta zor gisa erregistratuta dago.
- Eskuzko onarpen-irizpideak: QAk istorio-motaren araberako zerrenda bat du (formularioa, datu-taula, elkarrizketa-koadroa, nabigazioa, multimedia-edukia), automatizazioak estaltzen ez dituen eskuzko egiaztapenekin. Adibidez, formulario baterako: etiketa zuzenak eremu bakoitza entzutean, erroreak iragarriak eta fokuratuak, Sartu teklarekin bidaltzea, foku-ordena logikoa, ulergarria % 400eko zoomean.
Adibidea
Merkataritza elektronikoko talde batek axe sartzen du Playwrighten erosketa-fluxuan. Lehen astean, pipelineak 41 urraketarengatik huts egiten du; ez blokeatzaile bihurtzea erabakitzen dute, eta beheranzko atalase bat finkatzea: sprint bakoitzak aurrekoak baino urraketa gutxiagorekin itxi behar du. Lau sprintetan zerora iristen dira, eta blokeatzaile bihurtzen dute. Aldi berean, QAk bere eskuzko zerrendara gehitzen du «saskira gehitu» elkarrizketa-koadroa NVDArekin egiaztatzea, axek ez baitzuen antzematen fokua galtzen zela ixtean (2.4.3 Fokuaren ordena). Sei hilabeteren buruko emaitza: zero atzerakada automatiko produkzioan, eta fokuarekin lotutako bi arazo antzemanak argitaratu aurretik.
Ohiko akatsa
Axeren arauak desgaitzea «positibo faltsuak ematen dituztelako», kasu bakoitza aztertu gabe. Arau batzuek (irudidun edo gradientedun hondoen gaineko kontrastekoek, adibidez) eskuzko berrikuspena behar dute, bai, baina ustezko alarma faltsu gehienak azalpen eroso bat duten benetako akatsak dira. Dokumentatu desgaitutako arau bakoitza, arrazoiarekin eta erabakia hartu zuen pertsonarekin.
Automatizazioa ezartzeko egiaztapen-zerrenda
- Irisgarritasun-linterra aktibo interfazeko biltegietan.
- axe-core design systemeko osagaien probetan, egoera guztien gainean.
- axe-core Playwrighten edo Cypressen fluxu kritikoetan, elkarreraginen ondoren aztertuz.
- pa11y-ci edo baliokidea proba-ingurunearen gainean, gaueko exekuzioarekin eta atalase zehaztuarekin.
- Emaitzak artefaktu gisa gordeak, joera neurtzeko.
- Egindakoaren definizioa, egiaztapen automatiko eta eskuzkoekin.
- Istorio-motaren araberako eskuzko egiaztapenen zerrenda QAren eskura.
- Salbuespenen eta desgaitutako arauen erregistroa, justifikazioarekin.
Laburpena
- Automatizazioak arazoen zati bat (% 30-40 inguru) antzematen du modu fidagarrian, eta ezin da ordeztu atzerakaden aurka, baina ez du benetako esperientzia egiaztatzen.
- Kokatu probak maila guztietan: linterra, osagaia, e2e fluxuak axe-corerekin Playwrighten edo Cypressen, pa11y-ci bidezko arakatzea eta eskuzko proba zehaztuak.
- Aztertu elkarreragin ondoren, mugatu etiketak eskatutako mailetara, erregistratu salbuespenak eta gorde emaitzak joera neurtzeko.
- Egindakoaren definizioak eta istorio-motaren araberako eskuzko zerrendek irisgarritasuna taldearen kontratuaren parte bihurtzen dute.
Ikastaro honetako 2 ikasgai irakurri dituzu: ez itzazu galdu
Sortu zure kontua, 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 7. mailako ziurtagiria azterketa gainditzen duzunean
Zure Google kontuarekin edo zure posta elektronikoarekin bakarrik sartzen zara. Ez duzu pasahitzik behar.
Matrikulatu · 7. maila (179 €)