Axe DevTools Watir
La gem fournit une [axe API][] chaînable pour [Watir][] et s'injecte automatiquement dans tous les cadres. axe-devtools-watir
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 la gem axe-devtools-watir :
-
Ajoutez
axe-devtools-watir
à votre Gemfile :gem "axe-devtools-watir"
Ou ajoutez-le à votre fichier gemspec :
spec.add_dependency "axe-devtools-watir"
Exécutez
bundle install
pour télécharger et installer gem. -
Incluez gem et configurez.
require 'axe-watir' # Note that this shouldn't be 'axe-devtools-watir'
# configure `AxeWatir`
driver = AxeWatir.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/'
Bien que la gem soit appelée axe-devtools-watir, elle doit être référencée comme axe-watir avec require.
API
AxeWatir.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 watir
. Les noms de navigateur valides sont :
:firefox
(par défaut):chrome
:safari
:internet_explorer
:edge
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 |
De plus, 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
[watir] : http://watir.com/
[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