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

アクセシビリティ

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要素。デフォルトはページ全体です。

戻り値