Axe DevTools pour Web Capybara
gem fournit une [axe API][] chaînable pour le [Capybara WebDriver][] et l'injecte automatiquement dans toutes les trames. axe-devtools-capybara
Installation et utilisation
Avant de commencer, assurez-vous d'avoir accès au [registre Deque][configuration du registre npm d'attest]. Dans le cas contraire, [consultez le guide d'installation][]
- Ajoutez
axe-devtools-capybara
à votre fichier Gemfile ou gemspec et exécutezbundle install
.
gem "axe-devtools-capybara"
spec.add_dependency "axe-devtools-capybara"
- Inclure la gemme et configurez-la comme indiqué ci-dessous :
require 'axe-devtools-capybara'
# configure `AxeCapybara`
driver = AxeCapybara.configure(:firefox) do |c|
# see below for a full list of configurations
c.jslib_path = "next-version/axe.js"
end
# use the driver configuration instance
driver.page.navigate.to 'https://www.deque.com/'
API
AxeCapybara.configure
La méthode configure prend un argument facultatif comme [symbole][] et un objet de bloc de configuration : configure(*arg, &block)
L'argument facultatif est un nom de navigateur pour capybara
. Les noms de navigateur valides sont :
:firefox
(par défaut):chrome
:safari
Veuillez vous assurer que les pilotes nécessaires (par exemple, [geckodriver
][]) sont installés sur votre machine.
L'objet de configuration de bloc contient les propriétés suivantes :
Propriété | Type | Description |
---|---|---|
jslib_path (facultatif) |
String |
Chemin vers une source axe personnalisée |
skip_iframes (facultatif) |
Booléen |
Indique si les iframes doivent être exclus de l'injection avec axe |
Le bloc de configuration peut également prendre des paramètres pour la configuration avancée d'AxeDevTools
[axe api] : https://github.com/dequelabs/axe-core/blob/develop/doc/API.md
[capybara webdriver] : https://github.com/teamcapybara/capybara/
[geckodriver
] : https://github.com/mozilla/geckodriver/releases
[Symbol] : https://ruby-doc.org/core-2.5.0/Symbol.html
[attest npm registry setup] : https://dequeuniversity.com/guide/attest/2.11/getting-started/npm-setup/
[se référer au guide d'installation] : rb-access-setup#required-access--setup