Erişilebilirlik Testleri için Pa11y ve axe

Pa11y ve axe-core, WCAG ile uyumlu erişilebilirlik sınamasını otomatikleştiren açık kaynaklı araçlardır. Her ikisi de bir sayfayı ayrıştırır, DOM'a karşı kuralları çalıştırır ve ihlalleri bildirir. Erişilebilirlik sorunlarının büyük bölümünü otomatik olarak yakalayın; kalanlar için elle sınama yapın.

axe-core, Chrome DevTools, Lighthouse, Jest, Cypress, Playwright ve daha birçok araçtaki erişilebilirlik denetimlerini sağlayan bir JavaScript kitaplığıdır. Otomatik erişilebilirlik sınaması için fiilî standarttır — geniş kural kapsamına ve düşük yanlış pozitif oranına sahiptir.

axe DevTools tarayıcı uzantısı (Chrome, Firefox, Edge), DevTools'a bir "Erişilebilirlik" sekmesi ekler. "Tüm sayfaları tara" seçeneğine tıklayın; uzantı, etkilenen öğeler, önem derecesi ve giderme yönergeleriyle birlikte her ihlali listeler. Geliştirme sırasında yapılan tek seferlik denetimler için idealdir.

Pa11y bir Node.js CLI aracıdır: npx pa11y https://example.com bir URL'yi denetler. Sorun listesini terminale yazdırır. Hızlı denetimler, kabuk betikleri veya düşük ek yük gerektiren CI tümleştirmesi için kullanın.

Uçtan uca erişilebilirlik sınaması için axe-core'u Playwright ile birleştirin: const results = await new AxeBuilder({ page }).analyze(). results.violations.length === 0 olduğunu doğrulayın. Gerilemeleri üretim ortamına ulaşmadan yakalar.

jest-axe, Jest sınamalarında oluşturulmuş bileşenlere karşı axe'ı çalıştırır. Bileşeni React Testing Library ile oluşturun ve kapsayıcıyı axe'a geçirin: expect(await axe(container)).toHaveNoViolations(). Artık her bileşen sınaması bir erişilebilirlik denetimi de içerir.

Her iki araç da proje başına kuralları devre dışı bırakmanıza veya değiştirmenize izin verir: bilinçli tasarım kararlarıyla çelişen kuralları kapatın, bilinen kritik kurallar için katılığı artırın. Devre dışı bırakılan her kuralı, nedenini açıklayan bir yorumla belgelendirin — gelecekteki geliştiricilerin ihtiyaç duyacağı bağlam budur.

Otomatik araçlar, WCAG sorunlarının yaklaşık %30-40'ını yakalar. Geri kalanlar (anlamlı odak sırası, okunabilir alt metni, anlamsal başlık hiyerarşisi ve gerçek kullanıcı arayüzü davranışını yansıtan ARIA kullanımı) insan incelemesi gerektirir. Otomasyon erişilebilirlik için gereklidir, ancak tek başına yeterli değildir.

Windows'ta NVDA, Mac'te VoiceOver ve kurumsal kitleler için JAWS ile sınama yapın. Gerçek ekran okuyucusu sınaması, otomasyonun ortaya çıkaramadığı sorunları gösterir — kafa karıştırıcı duyurular, bozuk bölgeler ve mantıksız odak sırası. Her büyük SR ile her sürümde bir kez sınama yapmak makul bir başlangıç düzeyidir.

En değerli erişilebilirlik doğrulaması, gerçek ürünü kullanan engelli kullanıcılardan gelir. Kullanıcıları erişilebilirlik danışmanlık kuruluşları, üniversitelerin engelli hizmetleri veya UserTesting.com gibi sınama platformları aracılığıyla bulun. Gerçek dünyadaki geri bildirimleri, hiçbir otomatik aracın ortaya çıkaramadığı sorunları yakalar.

PR'ları erişilebilirlik gerilemelerinde (yeni ihlallerde) engelleyin, ancak eski ihlallerde (mevcut başlangıç düzeyinde) engellemeyin. Böylece dağıtımı engellemeden çıtayı yükseltmeye devam edebilirsiniz. Genel erişilebilirlik durumunun öncü göstergesi olarak toplam ihlal sayısını zaman içinde izleyin.

Birden fazla araç kullanın: kapsamlı otomatik denetim için axe, ikinci bir görüş için Pa11y, niteliksel boşluğu kapatmak için elle ekran okuyucusu sınaması. Araçların örtüşmesi azdır; birlikte, tek bir aracın bulabileceğinden daha fazla sorunu kapsarlar.

axe ve Pa11y gibi otomatik araçlar, WCAG erişilebilirlik sorunlarının yüzde kaçını güvenilir biçimde yakalayabilir?

Çoğu erişilebilirlik denetimini axe-core sağlar; tarayıcı uzantısı tek seferlik denetimler, jest-axe ve Playwright tümleştirmeleri ise sürekli sınama için uygundur. Pa11y tamamlayıcı bir CLI aracıdır. Otomasyon sorunların yaklaşık %30-40'ını yakalar; tam kapsam için bunu elle ekran okuyucusu sınamasıyla (NVDA, VoiceOver) ve gerçek engelli kullanıcı sınamasıyla tamamlayın. CI'da yeni gerilemeleri engellerken eski başlangıç düzeyini engel olarak kullanmayın.