Importação e Inicialização para WebDriverJS

Depois de instalar o Axe DevTools para Web, é necessário importá-lo para sua configuração de testes e inicializar o pacote.

Pré-requisitos

Para importar e inicializar o Axe DevTools para Web, ele precisa ser instalado primeiro. Se ainda não o fez, leia o guia sobre como instalá-lo de um pacote, do seu repositório de artefatos ou do Agora da Deque. Você também precisa de um Selenium WebDriver de sua escolha baixado e configurado.

Importação e Inicialização

Importe tanto o Axe DevTools para Web quanto o WebDriverJS. A sintaxe depende da linguagem e do sistema de módulos que seu projeto utiliza. Escolha aquele que corresponde ao seu projeto:

JavaScript com módulos CommonJS

Este é o padrão para um projeto Node.js sem "type": "module" em seu package.json.

const { AxeDevToolsBuilder } = require('@axe-devtools/webdriverjs');
const webdriver = require('selenium-webdriver');

JavaScript com módulos ES

Use esta sintaxe em um projeto com "type": "module" em seu package.json, ou em arquivos .mjs.

import { AxeDevToolsBuilder } from '@axe-devtools/webdriverjs';
import webdriver from 'selenium-webdriver';

TypeScript

O TypeScript usa a mesma sintaxe import que os módulos ES. @axe-devtools/webdriverjs fornece suas próprias declarações de tipo, portanto, não há pacote @types/ separado para instalar. Os resultados das análises são tipados como AxeResults, que o axe-core exporta:

import { AxeDevToolsBuilder } from '@axe-devtools/webdriverjs';
import { Builder } from 'selenium-webdriver';
import type { WebDriver } from 'selenium-webdriver';
import type { AxeResults } from 'axe-core';

Inicializando o Driver

Depois de importar o Axe DevTools para Web, você pode inicializar o driver. Cada varredura requer sua própria instância do Axe DevTools para Web, então você a inicializará enquanto escreve testes.

Em JavaScript:

const driver = new webdriver.Builder().forBrowser('chrome').build();

Em TypeScript, usando os tipos Builder e WebDriver importados acima:

const driver: WebDriver = new Builder().forBrowser('chrome').build();

Próximos Passos

Depois que você instalar, importar e inicializar o Axe DevTools para Web, estará pronto para avançar para escanear a acessibilidade e escrever testes de acessibilidade. Para fazer isso, consulte o guia sobre escrevendo testes.

Solução de Problemas

Se você tiver problemas com qualquer um dos processos de importação ou inicialização do Axe DevTools para Web, entre em contato diretamente com seu representante Deque, entre em contato conosco através do nosso atendimento ao cliente, ou envie-nos um email. Ficaremos felizes em ajudar.