メインコンテンツへスキップ

Accessibility

Accessibilityクラスは、Chromiumのアクセシビリティツリーを検査するためのメソッドを提供します。アクセシビリティツリーは、スクリーンリーダーやスイッチなどの支援技術で使用されます。

アクセシビリティは非常にプラットフォームに依存するものです。異なるプラットフォームでは、異なるスクリーンリーダーが存在し、出力が大きく異なる場合があります。

Chromium、Firefox、WebKitのレンダリングエンジンは、「アクセシビリティツリー」という概念を持っており、それは異なるプラットフォーム固有のAPIに変換されます。Accessibility名前空間は、このアクセシビリティツリーへのアクセスを提供します。

アクセシビリティツリーのほとんどは、内部ブラウザのAXツリーからプラットフォーム固有のAXツリーへの変換時、または支援技術自体によってフィルタリングされます。デフォルトでは、Playwrightはこのフィルタリングを近似的に行い、ツリーの「興味深い」ノードのみを公開しようとします。

非推奨​

SnapshotAsync​

v1.9より前に追加 accessibility.SnapshotAsync
非推奨

このメソッドは非推奨です。ページのアクセシビリティをテストする必要がある場合は、Axeなどの他のライブラリを使用してください。Axeとの統合については、Node.jsガイドを参照してください。

アクセシビリティツリーの現在の状態をキャプチャします。返されるオブジェクトは、ページのルートとなるアクセス可能なノードを表します。

注

Chromiumのアクセシビリティツリーには、ほとんどのプラットフォームおよびほとんどのスクリーンリーダーで使用されないノードが含まれています。Playwrightは、処理しやすいツリーのために、それらも破棄します。ただし、InterestingOnlyがfalseに設定されていない限り。

使用例

アクセシビリティツリー全体をダンプする例

var accessibilitySnapshot = await page.Accessibility.SnapshotAsync();
Console.WriteLine(System.Text.Json.JsonSerializer.Serialize(accessibilitySnapshot));

フォーカスされたノードの名前をログ出力する例

var accessibilitySnapshot = await page.Accessibility.SnapshotAsync();
Console.WriteLine(System.Text.Json.JsonSerializer.Serialize(accessibilitySnapshot));

引数

  • options AccessibilitySnapshotOptions? (オプション)

    • InterestingOnly bool? (オプション)#

      ツリーから不要なノードを削除します。デフォルトはtrueです。

    • Root ElementHandle? (オプション)#

      スナップショットのルートDOM要素。デフォルトはページ全体です。

戻り値