Globale Configuraties Gebruiken

Overzicht van Globale Configuraties

Het Globaal paneel van axe Configuration biedt een gecentraliseerde manier om toegankelijkheidstestinstellingen binnen uw organisatie te beheren en te controleren. Deze krachtige functie stelt bedrijfsbeheerders in staat om consistente teststandaarden vast te stellen, terwijl individuele teams en ontwikkelaars de flexibiliteit krijgen die ze nodig hebben om effectief te werken.

Wat zijn Globale Configuraties?

Globale configuraties (de Globaal tab van axe Configuration) zijn een reeks controles die bepalen hoe axe Developer Hub opereert tijdens toegankelijkheidstesting. Deze instellingen omvatten:

• Tegen welke toegankelijkheidsnormen moet worden getest (zoals *WCAG 2.1 AA* of *EN 301 549*)
• Of er best practices controles moeten worden opgenomen
• Of er experimentele regels
• Welke versie van axe-core gebruikt moet worden voor testing

Deze instellingen kunnen zowel op bedrijfsniveau als op individueel gebruikersniveau worden beheerd, wat zorgt voor een flexibele maar gecontroleerde testomgeving.

Waarom Globale Configuraties Gebruiken?

Globale configuraties lossen verschillende veelvoorkomende uitdagingen op in toegankelijkheidstesten op bedrijfsniveau:

• Consistentie: Zorg ervoor dat alle teams testen tegen dezelfde toegankelijkheidsnormen
• Naleving: Handhaaf specifieke testvereisten binnen uw organisatie
• Flexibiliteit: Sta teams toe hun testaanpak aan te passen binnen goedgekeurde parameters
• Versiebeheer: Beheer welke axe-core versies kunnen worden gebruikt in projecten
• Kwaliteitsborging: Houd teststandaarden aan terwijl teamspecifieke optimalisaties mogelijk zijn

Hoe Werken Globale Configuraties

Beheerders

Beheerders stellen standaardwaarden voor de organisatie in en definiëren welke instellingen gebruikers via de configurationOverrides optie kunnen wijzigen. Deze instellingen vormen de basis voor testen met axe Developer Hub binnen de organisatie. Deze instellingen worden gewijzigd in het Globaal paneel van axe Configuration.

Gebruikers

In plaats van het gebruik van het **Globale** paneel, personaliseren individuele gebruikers hun testconfiguratie door de configurationOverrides optie in hun testconfiguratiecode te wijzigen of toe te voegen. De configurationOverrides optie werkt samen met de instellingen in het **Globale** paneel zoals gedefinieerd in de tabel in Veelvoorkomende Globale Configuratie en Configuratie-Overschrijvingsscenario's.

De API-referenties bevatten meer informatie over (JavaScript/TypeScript) configurationOverrides of (Java) ConfigurationsOverrides en zijn eigenschappen.

Veelvoorkomende Globale Configuratie en Configuratie-Overschrijvingsscenario's

Wanneer een test wordt uitgevoerd, combineert axe Developer Hub bedrijfs- en gebruikersinstellingen om de uiteindelijke testconfiguratie te creëren. Dit zorgt ervoor dat alle aanpassingen binnen goedgekeurde parameters blijven, terwijl gebruikers de nodige flexibiliteit krijgen.

De volgende tabel illustreert veelvoorkomende scenario's die je tegenkomt bij het werken met globale configuraties. Elk scenario laat zien hoe bedrijfsinstellingen samenwerken met je projectconfiguratie.

De Resultaten Begrijpen

• ✅ Succes: Configuratie werkt zoals verwacht
• ⚠️ Waarschuwing: Configuratie werkt maar wordt niet aanbevolen
• ❌ Fout: Configuratie zal falen

Aanbevelingen

1. Geef altijd de voorkeur aan configurationOverrides boven runOptions.
2. Controleer uw bedrijfsinstellingen voordat u overrides configureert.
3. Overschrijf instellingen alleen als het nodig is.
4. Gebruik de meest eenvoudige configuratie die aan uw behoeften voldoet.

Voorbeeldconfiguratie Override

Hier is een voorbeeldconfiguratie die overrides demonstreert om te voldoen aan *WCAG 2.1 AA* en beste praktijken:

const config = {
  axe: {
    apiKey: 'YOUR_API_KEY',
    projectId: 'YOUR_PROJECT_ID',

    configurationOverrides: {
      accessibilityStandard: 'WCAG 2.1 AA',
      axeCoreVersion: '4.9.1',
      experimentalRules: true,
      bestPractices: true
    }
};

Zie (JavaScript/TypeScript) ConfigurationOverrides Interface of (Java) ConfigurationOverrides Klasse voor een uitleg van de eigenschappen.

Fouten en Waarschuwingen

Fouten

Niet-toegestane Standaard

Als u probeert een standaard te gebruiken die niet is toegestaan, ontvangt u een serverantwoordcode 422, Onverwerkbare Inhoud. Voorbeeldbericht:

Error: Server responded to https://axe.deque.com/api-pub/watcher/sessions with status code 422: "error": "Invalid accessibility standard: WCAG 2.0 AA. Allowed options: EN 301 549, Trusted Tester v5"

Gebruik van runOptions.runOnly met configurationOverrides

Als u beide gebruikt runOptions.runOnly met configurationOverrides, zullen uw tests onmiddellijk falen. Gebruik alleen configurationOverrides.

Waarschuwingen

Gebruik van runOptions.runOnly

Als u runOptions.runOnly in uw configuratie gebruikt, ontvangt u dit waarschuwingsbericht:

@axe-core/watcher Zonder Ondersteuning van Globale Configuraties

Als u een versie van @axe-core/watcher gebruikt die te oud is om globale configuratie-ondersteuning te hebben, ontvangt u dit bericht:

Zie Ook

• axe Configuratie
• (JavaScript/TypeScript) configurationOverrides referentie
• (Java) ConfigurationOverrides Klasse