Pagina-analyse Beheren

This page is not available in the language you requested. You have been redirected to the English version of the page.
Link to this page copied to clipboard

Met de handmatige modus van Watcher kunt u kiezen wanneer of welke pagina's van uw site worden geanalyseerd op toegankelijkheidsproblemen

Not for use with personal data

Normaal gesproken analyseert axe Developer Hub automatisch elke pagina die door uw testsuite wordt bezocht (ook wel bekend als automatische modus). Soms resulteert deze automatische analyse in te veel pagina's die worden geanalyseerd, pagina's die u niet belangrijk vindt of pagina's die tot andere afdelingen van uw organisatie behoren — pagina's waar uw team geen eigendom over heeft — die worden geanalyseerd. U kunt de automatische modus uitschakelen, zodat u kunt bepalen wanneer (of of) elke pagina wordt geanalyseerd (ook wel bekend als handmatige modus).

Scenario's

Delen van een Website Scannen

U kunt de handmatige modus gebruiken om alleen een deel van een website te scannen. Als uw team bijvoorbeeld eigenaar is van de winkelwagenfunctionaliteit op uw site, maar uw testsuite cataloguspagina's moet bezoeken (die uw team niet bezit) om producten aan de winkelwagen toe te voegen, wilt u waarschijnlijk vermijden de toegankelijkheid van de cataloguspagina's te testen. Zodra u de winkelwagenpagina in uw testsuite heeft bereikt, kunt u de automatische analyse opnieuw inschakelen. Wanneer de testen van de winkelwagen zijn voltooid, kunt u de automatische analyse opnieuw uitschakelen.

Volgende Stappen

Dynamische Inhoud Laden

U kunt de handmatige modus gebruiken om te voorkomen dat pagina's met complexe laadsequenties worden getest. Als de pagina die u wilt testen dynamisch veel bronnen op de achtergrond laadt, kunt u de automatische modus uitschakelen totdat deze volledig is geladen. Dit beperkt de toegankelijkheidsproblemen tot diegenen die pas bestaan wanneer de pagina volledig is geladen. Het zou ook voorkomen dat accessibility checks plaatsvinden tijdens laadanimaties of andere laad-UI.

Volgende Stappen

Specifieke Pagina Statussen Vastleggen

Als u wilt zorgen dat een specifieke pagina status wordt gescand, kunt u handmatig een toegankelijkheidsanalyse uitvoeren nadat u uw pagina heeft ingesteld.

Volgende Stappen

Bereik van een Grote Testsuite Beperken

Door de automatische analyse uit te schakelen, kunt u een grotere, meer uitgebreide testsuite gebruiken maar uw toegankelijkheidstesten beperken tot slechts een deel ervan. In dit geval hoeft u uw grotere testsuite niet op te splitsen in kleinere testsuites en kunt u alleen de toegankelijkheid testen in de testsuites die u belangrijk vindt.

Volgende Stappen

Hoe de Handmatige Modus te Gebruiken

U kunt de automatische analyse in uw configuratie uitschakelen (zie Automatische Analyse Uitschakelen in Configuratie hieronder).

Pagina-analyse wordt beheerd door drie methodes op het Controller object of de equivalente commando's in Cypress.

  1. analyze() (in Cypress: cy.axeWatcherAnalyze()) om een analyse van de huidige pagina uit te voeren.
  2. start() (in Cypress: cy.axeWatcherStart()) om automatische toegankelijkheidsanalyse in te schakelen.
  3. stop() (in Cypress: cy.axeWatcherStop()) om automatische toegankelijkheidsanalyse uit te schakelen.

Een Controller-object verkrijgen

(JavaScript/TypeScript) Voor informatie over het verkrijgen van een Controller object, zie stap vier van de instructiepagina van uw testframework:

JavaScript:

TypeScript:

(Java) Voor Java, zie stap drie van de instructiepagina van het testframework. Stap vier toont hoe de wrappedDriver aangeroepen wordt om zijn flush() methode aan te roepen:

Cypress

(JavaScript/TypeScript) Voor Cypress kunt u het globale cy object gebruiken met deze gelijkwaardige opdrachten:

Controller-methode Cypress-opdracht
analyse() axeWatcherAnalyze()
**flush**() **axeWatcherFlush**()
**start**() **axeWatcherStart**()
**stop**() **axeWatcherStop**()

Playwright-test

(JavaScript/TypeScript) Voor Playwright-test, kan het **Controller** object (**PlaywrightController**) worden verkregen van **page**, dat een **axeWatcher** object bevat. U kunt het **axeWatcher** object gebruiken om de **Controller** methoden aan te roepen (voorbeeld hieronder is in TypeScript):

import { test, expect } from './fixtures'

test('example test', async ({ page }) => {
  await page.goto('https://example.com')
  await page.axeWatcher.analyze()
})

Automatische analyse uitschakelen in configuratie

U kunt automatische toegankelijkheidstesten uitschakelen door

(JavaScript/TypeScript) Bijvoorbeeld, u stelt **autoAnalyze** in op *false* in uw configuratie (deze regel is gemarkeerd in het Cypress JavaScript-voorbeeld hieronder):

const { defineConfig } = require('cypress');
const { cypressConfig } = require('@axe-core/watcher/cypress/config');

const ACCESSIBILITY_API_KEY = process.env.ACCESSIBILITY_API_KEY
const PROJECT_ID = process.env.PROJECT_ID

module.exports = defineConfig(  
  cypressConfig({
    axe: {
      apiKey: ACCESSIBILITY_API_KEY,      projectId: PROJECT_ID,
      autoAnalyze: false
    },
    // Your existing Cypress configuration code here
  })
);

Automatische analyse uitschakelen via een oproep

Met Cypress kunt u het **axeWatcherStop**() commando gebruiken:

cy.axeWatcherStop()

(JavaScript/TypeScript) De andere testintegraties gebruiken de **stop**() methode op uw Controller-object:

await controller.stop()

(Java) In de Java Watcher-integratie gebruikt u de AxeWatcherController.stop() methode.

Zie Het verkrijgen van een Controller Object voor meer informatie over het verkrijgen van een controllerobject voor je testframework.

Pagina's Handmatig Analyseren

Nadat je automatische analyse hebt uitgeschakeld, kun je aanroepen toevoegen aan de (JavaScript/TypeScript) axeWatcherAnalyze() (voor Cypress) of analyze() (met de andere testintegraties). (Java) Voor Java gebruik je de AxeWatcherController.analyze()](dh-java-watchercontroller#analyze) methode.

Bijvoorbeeld, voor Cypress:

describe('My Login Application', () => {
  it('should login with valid credentials', () => {
    cy.visit('https://the-internet.herokuapp.com/login')
      // Analyze the page.
      .axeWatcherAnalyze()      .get('#username')
      .type('tomsmith')
      .get('#password')
      .type('SuperSecretPassword!')
      .get('button[type="submit"]')
      .click()
      .wait(1000)
      // Analyze the page.
      .axeWatcherAnalyze()      // Restart automatic axe analysis.
      .axeWatcherStart()
      .get('#flash')
      .should('exist')
  })
})

Zie Het verkrijgen van een Controller Object voor meer informatie over het verkrijgen van een controllerobject voor je testframework.

Automatische Analyse Inschakelen

Met Cypress kun je de axeWatcherStart opdracht gebruiken:

cy.axeWatcherStart()

De andere testintegraties gebruiken de start methode op je Controller-object:

await controller.start()

Zie Het verkrijgen van een Controller Object voor meer informatie over het verkrijgen van een controllerobject voor je testframework.

Zie Ook

Is this page helpful?

Help us improve this page

Still need help?