Axe DevTools Selenium
Le axe-devtools-selenium
gem fournit une [axe API][] chaînable pour le [Selenium WebDriver][] et l'injecte automatiquement dans tous les frames.
Installation et utilisation
Assurez-vous d'avoir accès au [registre de Deque][configuration du registre npm]. Dans le cas contraire, reportez-vous à la [documentation d'installation][].
Suivez les étapes ci-dessous pour configurer le gem axe-devtools-selenium :
- Ajoutez
axe-devtools-selenium
commande ou fichier spécifique à votre fichier Gemfile ou gemspec et exécutezbundle install
commande spécifique.
gem "axe-devtools-selenium"
spec.add_dependency "axe-devtools-selenium"
- Incluez gem et configurez.
require 'axe-devtools-selenium'
# configure `AxeSelenium`
driver = AxeSelenium.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
AxeSelenium.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 selenium-webdriver
. Les noms de navigateur valides sont :
:firefox
(par défaut):chrome
:safari
Veuillez vous assurer que les pilotes respectifs (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 |
De plus, le bloc de configuration peut prendre des paramètres pour la configuration avancée d'AxeDevTools
[axe api] : https://github.com/dequelabs/axe-core/blob/develop/doc/API.md
[selenium webdriver] : https://rubygems.org/gems/selenium-webdriver
[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/
[documentation d'installation] : rb-access-setup#required-access--setup