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

Accessibility

非推奨

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

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

アクセシビリティは非常にプラットフォーム固有のものです。異なるプラットフォームでは、出力が大きく異なる可能性のあるさまざまなスクリーンリーダーがあります。

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

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

非推奨​

SnapshotAsync​

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

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

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

注

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

使用法

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

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

戻り値