accessibility-skill

アクセシビリティテストスキル

TestMu AI のアクセシビリティテストは、既存の自動化スイートに追加する形で利用できます。別のツールをインストールする必要はありません。ドライバーで機能を有効にし、任意のタイミングでスキャンを実行するか、ページ遷移のたびに自動スキャンするよう設定します。結果は Accessibility ダッシュボードに表示されます。

**最初に、唯一の重大な制限を把握しておいてください。**自動化機能でスキャンを開始することはできますが、結果を取得する API も、終了コードも、ビルドをブロックするフラグもありません。レポートをプログラムで取得する場合（たとえば、ビルドを失敗させる場合）は、Accessibility MCP サーバーを使用してください（「基本パターン」を参照）。自動スキャンで検出できるのは WCAG の一部に限られ、手動テストやスクリーンリーダーによるテストに代わるものではありません。

基本パターン

アクセシビリティを有効にする（機能）

// One master switch is required; everything else is optional refinement.
capability.setCapability("accessibility", true);                 // required
capability.setCapability("accessibility.wcagVersion", "wcag21aa"); // wcag21a | wcag21aa
capability.setCapability("accessibility.bestPractice", false);    // default false
capability.setCapability("accessibility.needsReview", true);      // include ambiguous issues

Selenium + アクセシビリティ

// Option A: trigger a scan at a chosen point (recommended - precise, faster)
capability.setCapability("accessibility", true);
driver.get("https://example.com");
driver.executeScript("lambda-accessibility-scan"); // scan the current page; call as often as needed

// Option B: auto-scan every navigation (Selenium only)
capability.setCapability("accessibility", true);
capability.setCapability("accessibility.autoscan", true);

通常のコマンド（例：mvn test）で実行してください。フックを使用していても、呼び出さなければレポートは生成されません。

Playwright + アクセシビリティ

const capabilities = {
  "accessibility": true,
  "accessibility.wcagVersion": "wcag21a",
  "accessibility.bestPractice": false,
  "accessibility.needsReview": true
};

// Playwright needs the internal scan extension loaded once, after page creation.
// Use Chrome (not Chromium). There is no autoscan/hook on this path.
await ltPage.goto("chrome://extensions/?id=johgkfjmgfeapgnbkmfkfkaholjbcnah");
const toggle = ltPage.locator('#crToggle').nth(0);
await toggle.click();

npx playwright test で実行してください。

Cypress + アクセシビリティ

// lambdatest-config.json - capabilities are dotted here
{ "accessibility": true, "accessibility.wcagVersion": "wcag21aa", "accessibility.needsReview": true }

スキャナーを登録します（ファイルは Cypress のバージョンによって異なります）。

• v10+：cypress/support/e2e.js にインポートし、cypress.config.js にプラグインを追加します
• v9：cypress/support/index.js にインポートし、cypress/plugins/index.js にプラグインを追加します

lambdatest-cypress-cli run で実行してください。

ネイティブモバイルアプリ（Appium）

# The scan hook is mandatory for native apps (no autoscan mode).
caps["accessibility"] = True
driver.execute_script("lambda-accessibility-scan")

結果をプログラムで取得する（MCP サーバー）

自動化の方法では、結果はダッシュボードにのみ書き込まれます。レポートを呼び出し元に返す方法は、Accessibility MCP サーバーだけです。

• getAccessibilityReport — 公開 URL をスキャンしてレポートを返します
• buildLocalAppForAnalysis — ローカルアプリをビルドして配信し、スキャンします（デプロイ前）
• AnalyseAppViaTunnel — トンネルの背後ですでに実行中のローカルアプリをスキャンします

エージェントがスキャン結果に基づいて動作する必要がある場合は、これを使用して「ビルドのたびにスキャンする」実際のループを構築してください。

認証

export LT_USERNAME="your-username"     # from your TestMu AI Profile page
export LT_ACCESS_KEY="your-access-key"

クイックリファレンス

タスク	方法
スキャンを有効にする	accessibility: true 機能（必須）
WCAG レベル	accessibility.wcagVersion = wcag21a または wcag21aa
ベストプラクティスのチェック	accessibility.bestPractice = true（デフォルトは false）
判断が難しい問題	accessibility.needsReview = true
任意のタイミングでスキャンする	driver.executeScript("lambda-accessibility-scan")
ページ遷移のたびにスキャンする	accessibility.autoscan = true（Selenium のみ）
コード内で結果を取得する	Accessibility MCP サーバー（それ以外はダッシュボードのみ）
ダッシュボード	https://accounts.lambdatest.com/dashboard -> Accessibility

詳細パターン

フレームワークごとの設定、機能の完全なリファレンス、アクセシビリティスコア、重大度レベル、WCAG ルールと修正方法の対応（修正ガイダンス）、自動化で対応できる内容とできない内容については、reference/playbook.md を参照してください。