axe-devtools-api Référence de l'API Python
Référence API pour le package Python axe-devtools-api pour injecter et exécuter axe-core
Fournit une API permettant d'injecter et d'exécuter axe-core sur une page web.
axe_devtools_api.Axe
Configure la manière dont axe-core est exécuté et l'exécute sur la page.
report = Axe(page).with_rules("document-title", "label").analyze()Axe(page, report_configuration=None, axe_source=None)
Initialisez une instance Axe avec un adaptateur de navigateur et une configuration optionnelle.
page : Un adaptateur de navigateur, tel qu'une instance AxeDriver de axe-devtools-selenium.
report_configuration : Optionnel. Un objet de configuration de rapport.
axe_source : Optionnel. Une chaîne de code source axe-core à utiliser à la place de la version intégrée.
analyze()
Injectez axe-core dans la page et exécutez l'analyse d'accessibilité.
Renvoie un objet Results. Voir Générer des rapports avec Python pour l'API complète Results et comment configurer les métadonnées du rapport.
report = Axe(page).analyze()including(*selector)
: Un ou plusieurs sélecteurs CSS pour les éléments à inclure.
selector : Un ou plusieurs sélecteurs CSS pour les éléments à inclure.
Retourne cet objet pour le chaînage.
report = Axe(page).including(".sidebar-frame", ".some-class").analyze()excluding(*selector)
: Un ou plusieurs sélecteurs CSS pour les éléments à exclure.
selector : Un ou plusieurs sélecteurs CSS pour les éléments à exclure.
Retourne cet objet pour le chaînage.
report = Axe(page).excluding(".iframe1", ".third-party-ad").analyze()with_rules(*rules)
Spécifiez les règles (par ID) pour que axe-core les exécute. Seules les règles spécifiées sont utilisées. Cette option est incompatible avec with_tags.
rules : Un ou plusieurs identifiants de règles. Voir pour une liste des IDs valides. pour une liste des ID valides.
Retourne cet objet pour le chaînage.
Soulève RuntimeError si appelé conjointement avec with_tags sur la même instance.
report = Axe(page).with_rules("document-title", "label").analyze()with_tags(*tags)
Spécifiez les règles (par tag) pour que axe-core les exécute. Seules les règles spécifiées sont utilisées. Cette option est incompatible avec with_rules.
tags : Un ou plusieurs noms de tags. Voir pour une liste des étiquettes valides. pour une liste de tags valides.
Retourne cet objet pour le chaînage.
Soulève RuntimeError si appelé conjointement avec with_rules sur la même instance.
report = Axe(page).with_tags("best-practice", "wcag2a").analyze()disabling_rules(*rules)
: Un ou plusieurs IDs de règles.
rules : Un ou plusieurs identifiants de règles.
Retourne cet objet pour le chaînage.
report = Axe(page).disabling_rules("html-has-lang", "label").analyze()run_options(options)
Spécifiez à passer à axe-core lors de l'appel de à passer à axe-core lors de l'appel de axe.run.
options : Objet options à passer à axe-core.
Retourne cet objet pour le chaînage.
options = {"iframes": False}
report = Axe(page).run_options(options).analyze()configure(spec)
Configurez axe-core via axe.configure.
spec : Objet spécification à passer à axe.configure.
Retourne cet objet pour le chaînage.
report = Axe(page).configure(spec).analyze()without_iframe_sandboxes()
Supprimez l'attribut sandbox des iframe pour que axe-core puisse s'exécuter à l'intérieur.
Retourne cet objet pour le chaînage.
report = Axe(page).without_iframe_sandboxes().analyze()with_config_file(config_path)
Définissez le chemin vers un fichier de configuration de jeu de règles. Le chemin par défaut est config/axe-ruleset.json, ou la valeur de la variable d'environnement $AXE_RULESET_PATH si elle est définie.
config_path : Chemin vers le fichier de configuration.
Retourne cet objet pour le chaînage.
report = Axe(page).with_config_file("path/to/file.json").analyze()with_ruleset(ruleset_id, enable_best_practices=False)
Utiliser un jeu de règles spécifique pour l'exécution d'axe-core.
ruleset_id : ID du jeu de règles à utiliser. Jeux de règles disponibles : wcag2, wcag2.1, wcag2.2, wcag2aaa, wcag2.1aaa, wcag2.2aaa, 508, en301549, ttv5, rgaav4.
enable_best_practices : Si les règles taguées best-practice doivent être activées. Par défaut False.
Retourne cet objet pour le chaînage.
report = Axe(page).with_ruleset("508").analyze()set_legacy_mode(state=True)
Utilisez axe.run au lieu de axe.runPartial. A des implications transfrontalières.
state : Si le mode héritage doit être activé. Par défaut True.
Retourne cet objet pour le chaînage.
report = Axe(page).set_legacy_mode().analyze()Service d'utilisation
Obtenez un aperçu des tendances d'utilisation de Axe DevTools au sein de votre organisation. Par défaut, le service d'utilisation est désactivé. L'URL par défaut est https://usage.deque.com.
Variables d'environnement du service d'utilisation
Ces variables d'environnement vous permettent de configurer le service d'utilisation et de modifier les propriétés des événements signalés.
| Nom | Type | Peut remplacer | Description |
|---|---|---|---|
AXE_DISTINCT_ID |
Chaîne de caractères | — | Un identifiant UUID qui reste le même pour l'utilisateur connecté (sauf s'il est régénéré) |
AXE_METRICS_URL |
Chaîne de caractères | — | L'URL du point d'accès REST pour l'utilisation |
AXE_TRACK_USAGE |
Booléen | — | Active le rapport de service d'utilisation (par défaut est false) |
AXE_APPLICATION |
Chaîne de caractères | faux | L'application qui a été utilisée pour vérifier les erreurs d'accessibilité |
AXE_DEV_INSTANCE |
Booléen | vrai | Indique si cet événement provient d'actions d'un développeur logiciel. Utile pour marquer et supprimer ensuite les événements enregistrés pendant le développement ou les tests. |
AXE_DEPARTMENT |
Chaîne de caractères | vrai | Le département de l'utilisateur au sein de l'organisation |
AXE_KEYCLOAK_ID |
Chaîne de caractères | faux | L'ID Keycloak de l'utilisateur |
AXE_LOGGED_IN |
Booléen | faux | Enregistre si l'utilisateur est connecté à l'application en test |
AXE_ORGANIZATION |
Chaîne de caractères | vrai | L'organisation de l'utilisateur |
AXE_SESSION_ID |
Chaîne de caractères | faux | Un UUID identifiant la session de l'utilisateur |
AXE_USER_ID |
Chaîne de caractères | faux | L'identité spécifique de l'utilisateur, comme le nom ou l'ID de connexion |
AXE_USER_JOB_ROLE |
Chaîne de caractères | faux | Le rôle professionnel de l'utilisateur |
AXE_USER_STATUS |
Chaîne de caractères | faux | Informations de statut que vous souhaitez associer à l'utilisateur |
enable_tracking(state)
Choisir d'envoyer ou non des données au service d'utilisation.
state : Si le suivi est activé.
Retourne cet objet pour le chaînage.
report = Axe(page).enable_tracking(True).analyze()set_tracking_url(url)
Définir où les données des métriques d'utilisation sont envoyées.
url : URL où les données seront envoyées.
Retourne cet objet pour le chaînage.
report = Axe(page).set_tracking_url("https://usage.deque.com").analyze()set_distinct_id(id)
Définir l'ID distinct utilisé lors de l'envoi des métriques d'utilisation.
id : ID distinct à envoyer.
Retourne cet objet pour le chaînage.
report = Axe(page).set_distinct_id("SOMEUUID").analyze()