ウォッチャーパッケージ リリースノート

4.3.0 (2026年5月12日)

• バグ修正
  • Java統合におけるレースコンディションを修正しました。ブラウザコンテキストをiframeに切り替える際に誤ってスキャンがトリガーされ、余計な結果が記録される問題がありました。
  • axe-coreをバージョン4.11.4に更新しました。

4.2.0 (2026年4月6日)

• 新機能

  • オプションを拡張して、明示的なGitメタデータの提供をサポートしました。JavaScript/TypeScriptでは、 git プロパティが git ブーリアンに加えてオブジェクトを受け入れるようになりました。Javaでは、 AxeConfiguration 新しい GitConfig メソッドがあります。 AxeWatcherOptions オブジェクトが提供されると、自動Git検出がスキップされます。すべてのフィールドはオプションです。これは、テストが別のリポジトリで行われる場合や、CI環境でのGit自動検出が信頼できない場合に便利です。詳しくは、 setGitInfo(AxeWatcherGitInfo) Gitメタデータの提供 GitConfig を参照してください。 AxeWatcherGitInfo バグ修正 まだ処理中の結果が残っている状態で呼び出すと、不完全な結果が生成される問題を修正しました。（JavaScript/TypeScript統合） Java/Selenium統合で、

• の例外が正しく表示されず、要素が表示されるのを待つ代わりに即座に失敗する問題を修正しました。

  • Java統合の信頼性を向上させました：一時的なエラーが発生したときに、サーバーへの結果送信を最大3回自動的に再試行するようになりました。 flush() 特定の構成セッターメソッドに渡すと、未処理の例外が発生する問題を修正しました。これらのメソッドは、説明的なメッセージと共に例外をスローするようになりました。
  • 4.1.0 (2026年2月24日) findElement() 新機能
  • ウォッチャーは同一オリジンのすべてのiframeを自動的にスキャンするようになりました。（Cypress統合はすでにこの動作を持っていました。）これは、Playwright、Puppeteer、WebdriverIO、WebDriverJS、およびJava Seleniumの統合に適用されます。
  • RGAA v4（フランスのアクセシビリティ基準）のサポートを追加しました。JavaScript/TypeScriptで null に設定するか、Javaでは IllegalArgumentException を使用します。axe-coreバージョン4.11.0以降が必要です。グローバル設定によって、この基準が組織で許可されるかどうかが決まります。

オプションを追加しました。JavaScript/TypeScriptおよびJavaで

• を使用してGitの情報を収集するかどうかを制御します。JavaScript/TypeScriptで

  • を設定するか、Javaでは
  • を呼び出して、Gitデータを収集せずにウォッチャーを実行します。デフォルトは accessibilityStandard: 'RGAAv4' （Git情報が収集される）です。 ConfigurationOverrides axe-coreをバージョン4.11.1に更新しました。 ConfigurationOverrides.AccessibilityStandard.RGAAV4 バグ修正
  • Java統合で、カスタムChromeバイナリパスを設定すると、 git オブジェクト上の AxeConfiguration がに渡されると上書きされる問題を修正しました。 AxeWatcherOptions . git: false 4.0.0 (2025年12月3日) setGit(false) ウォッチャー4.0.0はウォッチャーパッケージのメジャーリリースです。 true (Git info is collected).
  • Updated axe-core to version 4.11.1.

• Bug Fixes

  • Fixed a problem in the Java integration where a custom Chrome binary path set via setBinary() on the ChromeOptions object would be overwritten when passed to configure().

4.0.0 (December 3, 2025)

Watcher 4.0.0 is a major release of the Watcher package.

• 特徴

  • プロキシサポートが追加されました。詳細は プロキシを使用したWatcherの利用 をご覧ください。（HTTPプロキシの実装にはNode.jsバージョン20.18.1以上が必要です）。
  • axe-coreのバージョンを4.11.0に更新しました。
  • Node.jsバージョン24のサポートが追加されました。

• バグ修正

  • GitLabパイプラインを使用した場合のGit情報報告の問題を修正しました。
  • Chrome for TestingやChromiumといったChromeの代替オプションに対するエラーハンドリングを改善しました。
  • 空のGitデータを正しく処理します。
  • WebdriverIOのすべてのユーザー提供Chromeオプションを含めます。

• 重要な変更

  • Watcher（TypeScriptとJavaScript用）は、パッケージのインポートに新しいパスを使用するようになりました。詳細は 指示 をご覧になり、ブラウザ統合パッケージの更新されたコード例をご確認ください。

    ブラウザ自動化プラットフォーム	旧パス	新パス
    Cypress	@axe-core/watcher	@axe-core/watcher/cypress/config
    Cypress コマンド	@axe-core/watcher/dist/cypressCommands	@axe-core/watcher/cypress/support
    Playwright	@axe-core/watcher	@axe-core/watcher/playwright
    Playwright テスト	@axe-core/watcher	@axe-core/watcher/playwright-test
    Puppeteer	@axe-core/watcher	@axe-core/watcher/puppeteer
    WebdriverIO	@axe-core/watcher	@axe-core/watcher/wdio
    WebdriverIO テストランナー	@axe-core/watcher	@axe-core/watcher/wdio
    WebDriverJS	@axe-core/watcher	@axe-core/watcher/webdriver

    WebDriverJS用JavaScript例：

    const { webdriverConfig, wrapWebdriver, WebdriverController } = require('@axe-core/watcher/webdriver')

  • TypeScriptでの誤った指定を LaunchOptions Playwright用に新しい型として置き換えました。 LaunchPersistentContextOptions、から動的に抽出されました。 launchPersistentContext。ユーザーは使用していたサポートされていないオプションを削除する必要があります LaunchOptions。さもなければ、TypeScriptは厳密モードでコンパイルに失敗します。

3.23.0 (2025年8月1日)

• サーバーへの結果送信時のタイムアウトと再試行ロジックを改善しました（JavaScriptおよびTypeScript用Watcher）。
• Chromeバージョン139以降の --load-extensions オプションについての警告を追加しました（JavaScript/TypeScriptおよびJava実装の両方）。
• 失敗した結果のアップロードに対する最大再試行回数を超えた場合に失敗を報告します（Flush: Failed. Maximum retries reached）。
• Chrome for TestingとChromiumの取り扱いに関する問題を修正しました。
• 最大再試行回数に達したかどうかをログに記録します。
• Cypress統合においてコンポーネントテストを実装しました。

3.22.0 (2025年7月1日)

• が含まれないようにします runOptions Java統合での静かな失敗を引き起こした null 値。
• Java実装のライセンスファイルを META-INF ディレクトリにコピーすることを確認します。
• 除外されたURLパターンがJavaで正しくコピーされなかった問題を修正しました。
• デフォルトのGitブランチを決定する方法を改善しました。

3.21.0 (2025年5月23日)

• Javaウォッチャー がリリースされました。
• デフォルトのGitブランチ名を決定するための代替手段を実装しました。
• Cypress統合において、長い wait（）時間が重複したページ状態やテストの失敗を引き起こす問題を修正しました。
• Cypress統合で runOptions.runOnly が正しく機能しない問題を修正しました。

3.20.2（2025年4月17日）

• 誤ったパラメータを変更するように指定したタイムアウトエラーメッセージの問題を修正しました。（例えば、ユーザーは timeoutStart ではなく timeout.start 値を変更するように指示されました。）

3.20.1（2025年3月25日）

• 機能

  • axe-coreの以前のバージョンを選択できるようにしました。
  • 結果をサーバーにフラッシュするプロセスをより堅牢にしました。

• バグ修正

  • ユーザー構成オーバーライドでグローバル構成を統合する際の問題を修正しました。
  • Cypress統合でのレースコンディションの問題を修正しました。
  • Cypress統合において、実験的なルールが有効にされなかった問題を修正しました。
  • EN 301 549標準を有効化しても反映されない問題を修正しました。
  • に問題が発生する場合を修正しました configurationOverrides 、値が設定されていない場合です。
  • PlaywrightおよびPlaywright Testの追加検証を追加しました。
  • パッチバージョン番号なしでaxe-coreのバージョンを選択しようとした際の問題を修正しました。
  • ユーザー構成をグローバル構成と統合するロジックを強化しました。
  • axe-coreバージョンを扱う際の処理を改善しました、 configurationOverrides が提供されていない場合。
  • で許可されていないアクセシビリティ標準のエラーメッセージを改善しました configurationOverrides。
  • エラーメッセージにトラブルシューティングドキュメントへのリンクを含めるよう修正しました。
  • 結果をサーバーに送信する際のエラーハンドリングを改善し、以前はテストスイートが停止していました。

3.20.0

• リリースされていません

3.19.1（2025年2月25日）

• ラップされたメソッドを呼び出した際問題が発生する箇所を修正しました（例えば、 click()）、ブラウザコンテキストが子フレームに切り替えられた後に switchToFrame() （WebdriverIOまたはWebDriverJS）または switchTo().frame() （Java Selenium）を使用すると、分析タイムアウトが発生しました。Axe Watcherは、トップレベルフレームにない場合、分析をスキップするようになりました。詳細は、 子フレームに切り替えた後、ページ状態がキャプチャされない を参照してください。
• テストスイートが --disable-extensions を指定してもウォッチャーが無効にならないようにしました。

3.19.0（2025年1月20日）

• PlaywrightおよびPlaywright Testのバージョン1.49.0以上を使用する際、 headless パラメータを指定するときにエラーメッセージを改善しました。これは channel パラメータが firefoxに設定されている場合です。（完全表示モードまたは新しいヘッドレスモードでサポートされているのは、 chromium または chrome チャンネルのみです。）
• axe-coreのバージョンチェックを改善しました。
• グローバル設定 のサポート。

3.18.0 (2024年12月18日)

• 複数のセッション処理の問題を修正し、ウェブサイトに誤った結果や空の結果が表示される可能性があるという問題を解決しました。
• Playwrightバージョン >= 4.91で新しいChromiumヘッドレスのサポートを追加しました。詳しくは、 新しいChromiumヘッドレスを試してみてください をご覧ください。
• ユーザーがセッション処理を制御できるようにするため、カスタムタイムアウト値を追加しました。

3.17.2 (2024年12月12日)

• 機能

  • Watcherにマニュアルモードを追加しました。
  • サポートされていないプロトコル（ https、 http、または file以外)や about:blank ページで解析を行うと、エラーが発生します。
  • Watcherが使用前に設定されていない場合、エラーをスローするようになりました。

• バグ修正

  • Playwright Testでセッションが再利用され、結果が上書きされる問題を修正しました。
  • セッションの作成および管理に関するその他の問題をいくつか修正しました。
  • マニュアルモードでは、コントローラーの start() メソッドを呼び出すと、現在のページのDOMがクリーンとマークされるので、ページの状態はキャプチャされません。
  • マニュアルモードでは、 flush() が呼び出されたときに追加のページ状態が時々キャプチャされる問題を修正しました。
  • が呼び出された後、 cy.axeWatcherAnalyze() が呼び出されたときに欠落しているページ状態を引き起こす問題を修正しました。 cy.click() が呼び出されましたが、 cy.wait() コールなし。 コントローラーのメソッド
  • に@axe-core/watcherパッケージとともに更新されたLICENSES-3RD-PARTY.mdファイルを含めました。
  • は、DOMが変更された場合、ページを分析します。 自動モードをオフにする前に行います。 stop() Watcherが手動モードの場合、コントローラーメソッド
  • が呼び出されるとページを分析しないようにWatcher'sの動作を変更しました。 stop() が呼び出される。
  • Playwright統合でラップされたメソッドが間違った型を返す問題を修正しました。
  • が1つのオプションのみを受け入れるのを妨げる問題を修正しました。 runOptions 3.17.1

リリースされていません

• 3.17.0

リリースされていません

• 3.16.1 (2024年10月25日)

サードパーティーのライセンスを含めました。

• 3.16.0 (2024年9月26日)

Cypressコマンドに関連する推移的依存関係の問題を修正しました。

• 3.15.2 (2024年9月13日)

3.15.2 (September 13, 2024)

• WebdriverIO バージョン 9 のサポートを追加しました（WebdriverIO バージョン 7 および 8 のサポートは維持）。

3.15.1

• スキップ（リリース候補がありませんでした）

3.15.0

• リリースされていません

3.14.3 (2024年9月5日)

• ユーザーに見える変更はありません

3.14.2 (2024年8月29日)

• Cypressでタイムアウト値のアクセス時に発生するエラーを修正しました。
• Cypressにおいて、ユーザーがコールする前にウォッチャーを使用しようとした場合に例外をスローするようになりました cypressConfig()。
• Cypressで特定の条件下で発生するインポート時のエラーを修正しました os モジュール。
• を追加しました buildID に AxeConfiguration に対応させて並列テストを実行できるようにしました。
• 非推奨になった sessionID を AxeConfiguration に変更しました buildID。
• Puppeteerにおける追加のページ状態のキャプチャを引き起こしていた問題を修正しました authenticate()。
• コードの難読化によりaxeウォッチャーのパフォーマンスが向上しました。

3.14.1

• リリースされていません

3.14.0

• リリースされていません

3.13.1 (2024年7月19日)

• URLを分析スキャンから除外するオプションを提供しました excludeUrlPatterns 。詳細は excludUrlPatterns参照。

3.13.0

• リリースされていません

3.12.0 (2024年7月16日)

• Cypressにおけるコンポーネント再マウントのハンドリングを改善しました。
• WatcherがWebdriverIOバージョン7で読み込めることを保証しました。
• Puppeteer locator サポートを追加しました。
• axe-coreの設定を追加しました runContext および runOptions 。詳細は runContext を参照してください runOptions。

3.11.1 (2024年6月26日)

• Cypressの外部ハンドラーからの戻り値が伝播されない問題を修正しました setupNodeEvents 。
• CypressのChrome拡張を読み込めるように動作を変更しました。

3.11.0 (2024年6月17日)

• Cypressでコンポーネントのアンマウントと再マウントがアクセシビリティスキャンのタイムアウトを引き起こす問題に対処しました。
• 対応ブラウザであっても失敗しないよう、ブラウザ検出ロジックを緩和しました。
• Cypressで結果をフラッシュする際のファイルシステム書き込みを削除しました。

3.10.0 (2024年5月16日)

• Cypressで次の問題を修正しました。 config から返されたオブジェクトが setupNodeEvents 正しく伝播されず、そのオブジェクトへの変更が失われていました。
• プロキシされた関数（Playwright Test用）の実装を修正し、 Locator オブジェクトのエラーが発生していました: Locatorオブジェクトでのみ使用可能です。
• 1.43.1リリースのPlaywright関数を2つ新たにラップしました。

3.9.0 (2024年4月30日)

• Puppeteerバージョン20のために後方互換性のある型を追加しました。
• Cypress用に、次を非推奨としました: axeAnalyze()、 axeFlush()、 axeStart()、および axeStop()。 次のものに置き換えました: axeWatcherAnalyze()、 axeWatcherFlush()、 axeWatcherStart()、および axeWatcherStop()。
• 特定のPuppeteerバージョン21（およびそれ以降）のフックに関する TypeError 問題を修正しました。

3.8.0 (2024年4月9日)

• 生成されるJavaScriptをECMAScript 2018（ES2018）にターゲット変更しました。従来はECMAScript 2015（ES2015）でした。

3.7.0 (2024年3月21日)

• ユーザーに見える変更はありません

3.6.0 (2024年3月7日)

• Cypress統合において、 after:run テストが実行されない場合にイベントが発生しないようにしました。
• Chromedriverチームが新しいホスティングソリューションに移行したため、ChromedriverのダウンロードURL形式を変更しました。WebdriverIOに影響します。

3.5.0 (2024年1月25日)

• Playwrightの Page.goto() メソッドを呼び出すと、ページの状態が誤って2回記録される問題を修正しました。
• Cypress統合において、 setupNodeEvents の特定のユーザー設定が無視される原因となっていた問題を修正しました。
• を必須の依存関係として追加しました。 eventemitter3
• Wrapping 以前ラップされていなかったPlaywrightメソッドをいくつかラップしました。

3.4.0 (2023年12月12日)

• テストがページ遷移を引き起こした際にページの状態が失われたりエラーが発生する問題を修正しました。
• Cypress統合から冗長なコードを一部削除しました。

3.3.0 (2023年12月7日)

• ユーザーに見える変更はありません

3.2.0 (2023年11月9日)

• ユーザーに見える変更はありません

3.1.1 (2023年10月12日)

• ユーザーに見える変更はありません

3.1.0 (2023年9月14日)

• すべての統合が今許可しています --headless=new。

3.0.0 (2023年9月8日)

予期せず呼び出されなかったケースに対処するために analyze() 、次の関数を非推奨にして置き換える必要がありました:

非推奨の関数を使用するとエラーが発生します。