Kontrola v prohlížeči nevidí pole zobrazená jen v některém stavu záznamu
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Test procházel všechny stránky administrace a kontrola přístupnosti byla zelená. Nezávislý auditor přesto dvakrát po sobě našel pole bez přístupného názvu: nejdřív rozhodnutí a datum u otevřené přihlášky, potom částku příjmu a datum vrácení u přihlášky s platbou. Při druhém nálezu už test měl vlastní přihlášky – jen bez navázané platby.
Root cause
Sekce “Root cause”Komponenta detailu vykresluje ovládání podle stavu dat:
{canEdit && payment && payment.status !== "zrusen" && <section>… <input type="number" /> …</section>}{refund.status === "pozadovano" && <span>… <input type="date" /> …</span>}Kontrola v prohlížeči (axe, vlastní průchod DOM) hodnotí jen to, co je v DOM. Každá další podmínka je další kombinace dat, kterou test musí znát a připravit; zapomenutá kombinace se neprojeví selháním, ale tichou mezerou. Záznam založený „nějak“ (bez platby, v uzavřeném stavu) navíc vytváří dojem pokrytí.
Stejnou slepou skvrnu měla kontrola vodorovného přetékání: měřila šířku dokumentu, ale obsah se roloval ve vnitřním kontejneru, takže přetečení o stovku pixelů nebylo vidět.
Fix
Sekce “Fix”Dvě vrstvy, každá na to, co umí:
- Zdrojový test přes AST – projde soubory komponent a u každého
<input>,<select>,<textarea>vyžadujearia-label/aria-labelledby, obalující<label>neboid. Nezávisí na datech ani na větvích.
const visit = (node: ts.Node) => { if (ts.isJsxSelfClosingElement(node) || ts.isJsxOpeningElement(node)) { const tag = node.tagName.getText(src); if (["input", "select", "textarea"].includes(tag) && !hasAttr(node, "aria-label") && !hasAttr(node, "id") && !insideLabel(node)) out.push(`${file}:${line(node)}`); } ts.forEachChild(node, visit);};První běh našel 45 polí; většina měla jen zástupný text, který při psaní zmizí.
- Fixtury pro stavy, kde záleží na rozložení – přihláška s vlastním předpisem, příjmem a čekající refundací založená přes skutečné rozhraní, kontrolovaná na několika šířkách; měří se přetečení posuvného kontejneru (
scrollWidth - clientWidth) a poloha tlačítek, ne jen šířka dokumentu.
Jak se tomu vyvarovat v jiných systémech
Sekce “Jak se tomu vyvarovat v jiných systémech”- Detection: spočítej v komponentě podmínky kolem ovládacích prvků (
&&, ternární výrazy) a porovnej s počtem stavů, které test zakládá. Hledej kontrolu přetékání, která čte jendocument.documentElement.scrollWidth. - Anti-pattern: „test má vlastní záznam“ bez otázky, v jakém stavu a s jakými vazbami; pravidlo pro všechny prvky ověřované jen na vykreslených.
- Lepší přístup: plošná pravidla staticky (AST, lint), rozložení a chování na pojmenovaných stavech s vlastními daty; po každém nálezu typu „unikla větev“ přidat plošnou pojistku, ne jen další fixturu.