Axe DevTools for WebにおけるPythonのエラーハンドリング

Axe DevTools Python 4.3によって引き起こされるエラーの回避方法

Axe DevToolsのバージョン4.3.0以降では、Axe.analyze()を呼び出す際に新しい手法が用いられ、実行の最後に新しいウィンドウが開かれます。このドキュメントに記載されている多くの問題は、この手法に関連する一般的な問題と、それに対する可能な解決策を扱っています。

ドライバーのバージョンが古い場合

一般的な問題の一つに、ドライバーのバージョンが古いことが挙げられます。この問題を解決するには、お使いのgeckodriverまたはchromedriverのローカルインストールが最新であることを確認してください。

この問題の例のエラーメッセージには、switchToWindowに関するメッセージが含まれます。

例:

(node:17566) UnhandledPromiseRejectionWarning: Error: Malformed type for "handle" parameter of command switchToWindow
Expected: string
Actual: undefined

ポップアップブロッカーが有効な場合

ポップアップブロッカーにより、Axe.analyze()を呼び出した際に新しいウィンドウを開くことができなくなります。ほとんどの自動化テストライブラリのデフォルト設定ではポップアップを許可するべきです。テストを実行する際に問題を引き起こす可能性があるため、ポップアップブロッカーを明示的に有効にしないようにしてください。

Axe.set_legacy_mode()

新しいAxe.analyze()技術をエラーなしに実行できない場合、axeはAxe.analyze()のレガシーバージョンを実行するための新しいチェイナブルメソッドを提供します。このメソッドを使用すると、axeはクロスドメインフレームやiframeで発生する可能性のあるアクセシビリティの問題を除外します。

例

from axe_devtools_api import Axe

driver = ... # open webdriver and go to your page
results = Axe(driver).set_legacy_mode().analyze()