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

4.6.0 (2026年8月10日)

• 機能

  • クロスオリジンの<iframe>要素の内容を分析するためにallowedOrigins構成オプションが追加されました。同一オリジンのフレームは常に分析されますが、クロスオリジンのフレームはそのオリジンをリストに含めない限りスキップされます。AxeConfiguration（JavaScript/TypeScriptの統合）ではallowedOriginsを設定するか、AxeWatcherOptions上でsetAllowedOrigins()を呼び出します（Java統合）。ワイルドカードはサポートされないため、すべてのオリジンを明示的に指定する必要があります。許可する各オリジンはそのフレームの内容をすべての分析に追加するため、分析が遅くなります。クロスオリジンiframeを分析を参照してください。（JavaScript/TypeScriptおよびJava統合）
  • サポートを終了した Node.js 20 は寿命が尽きました。Axe Watcher は現在、Node.js 22.11.0 以上が必要です。（JavaScript/TypeScript 統合）
  • axe-coreがバージョン4.13.0に更新されました。（JavaScript/TypeScriptおよびJava統合）

• バグ修正

  • Microsoft Edgeを対象にテストを実行した際に結果が記録されず、エラーが報告されない問題を修正しました。Watcherは、Microsoft Edge WebDriverが読み取るms:edgeOptionsキャパビリティにブラウザオプションを送信するようになり、goog:chromeOptionsではなくなりました。Microsoft EdgeをWebdriverIOと一緒に使用するには、Watcher 4.6.0以降が必要です。（JavaScript/TypeScript WebdriverIO統合）
  • Watcherは、ブラウザキャパビリティのargs値が文字列の配列でない場合に、argsプロパティを名前付きでエラーとして報告するようになり、無関係なエラーで失敗しなくなりました。（JavaScript/TypeScript WebdriverIO統合）
  • 取得したスクリーンショットがAxe Developer Hubにアップロードできないという問題を修正しました。（JavaScript/TypeScript Cypress統合）
  • 異なるプロジェクト ID で複数のテストを同時に実行すると、あるテストの設定が他のテストの設定を上書きする可能性があるという問題を修正しました。（JavaScript/TypeScript 統合）

4.5.1 (2026年7月16日)

• 機能
  • Microsoft Edge（Chromium）は、Java Selenium統合でサポートされるようになりました。以前は、EdgeはJava Seleniumを除くすべての統合で利用可能でした。EdgeOptionsをconfigure()に渡し、EdgeDriverをwrapDriver()に渡します。EdgeはSelenium 4以降を必要とします。JavaとSeleniumのための手順を参照してください。（Java Selenium統合）

4.5.0 (2026年7月6日)

• 機能
  • Axe Watcherがテストブラウザとして、Chrome for Testing、Chrome、Chromiumに加え、Microsoft Edge (Chromium) を公式にサポートするようになりました。EdgeはJavaScript/TypeScriptとの統合およびJava Playwrightで利用可能ですが、Java Seleniumではサポートされていません。

4.4.0 (2026年6月12日)

• 機能

  • スキャンには、元のテストのファイルパスと名前がAxe Developer Hubに自動的に含まれるようになりました。 (Playwright Test、Cypress、およびWebdriverIOの統合)
  • Java SDKは現在、Seleniumに加えPlaywrightをサポートしています。com.deque.axe_core:watcherアーティファクトはPlaywrightサポートを含んで出荷されます。統合手順についてはJavaとPlaywrightドキュメントを参照してください。
  • Java/Playwrightの統合では、違反スクリーンショットをキャプチャします。スクリーンショットは、screenshotDirが設定されているときにサーバーにアップロードされ、ローカルに保存されます。
  • Added setScreenshotDir() to AxeWatcherOptions (Java). Use it to specify a local directory for saving screenshots. Screenshots are saved locally even when the server is unreachable.
  • Java SDKの(Selenium)AxeWatcherControllerと(Playwright)AxeWatcherPlaywrightControllerの両方にsetTestContext()を追加しました。Axe Developer Hubで特定のテストに違反を帰属させるために使用します。
  • ローカルに保存されるスクリーンショットは、YYYYMMDDTHHmmssSSS-{id}.pngで指定されたタイムスタンプ付のファイル名を使用するようになり、取得時間順にソートされます。
  • Added elementInternals configuration option. Set elementInternals: true in AxeConfiguration (JavaScript/TypeScript) or call setElementInternals(true) on AxeWatcherOptions (Java) to include ElementInternals accessibility data in scans. This reduces false positives on pages that use custom elements with attachInternals(). Requires axe-core version 4.12.0 or later.
  • axe-coreをバージョン4.12.1に更新しました。

• バグ修正

  • analyze()を呼び出したときに(またはCypressでaxeWatcherAnalyze()を呼んだときに)、テスト終了時に重複したスキャン結果がアップロードされる可能性がある問題を修正しました。
  • 同時にフラッシュ要求が2件届いたときに、スキャン結果が複数回アップロードされる可能性があった問題を修正しました。
  • Watcherがすべての子フレームで動作し、重複したページ状態がアップロードされる問題を修正しました。Watcherは現在、トップフレームでのみ動作します。iframeコンテンツのアクセシビリティカバレッジは変わらず、axe-coreはすべてのフレームで動作し、トップフレームが結果をまとめます。
  • 多くのページ状態をキャプチャするテストのパフォーマンスを改善しました。結果ストレージは、スキャンごとの書き込み時間が一定であり、累積された結果の総数に応じて増加しません。
  • Java/Playwrightの統合におけるsetHeadless()とsetChannel()の検証を改善しました。誤った組み合わせの構成は、サイレントエラーや予期しない動作ではなく、アクション可能なメッセージでIllegalArgumentExceptionをスローします。
  • Watcherが設定を読み込む前にフラッシュ要求が届いた場合、除外されたURLパターンが常に尊重されるわけではなかった問題を修正しました。

4.3.0 (2026年5月12日)

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

4.2.0 (2026年4月6日)

• 機能

  • Extended the git option to support providing explicit Git metadata. In JavaScript/TypeScript, the git property in AxeConfiguration now accepts a GitConfig object in addition to a boolean. In Java, AxeWatcherOptions has a new setGitInfo(AxeWatcherGitInfo) method. When a GitConfig or AxeWatcherGitInfo object is provided, automatic Git detection is skipped. All fields are optional. This is useful when tests run in a repository that is separate from the repository under test, or in CI environments where Git auto-detection is unreliable. See まだ処理中の結果が残っている状態で呼び出すと、不完全な結果が生成される問題を修正しました。（JavaScript/TypeScript統合） for more information.

• バグ修正

  • JavaScript/TypeScriptの統合で、結果がまだ処理中のときにflush()を呼び出すと不完全な結果が生成される可能性がある問題を修正しました。
  • Java/Selenium統合で、findElement()からの例外が正しく表面化されず、要素が表示されるまで待機する代わりに明示的な待機が直ちに失敗する問題を修正しました。
  • ウォッチャーは同一オリジンのすべてのiframeを自動的にスキャンするようになりました。（Cypress統合はすでにこの動作を持っていました。）これは、Playwright、Puppeteer、WebdriverIO、WebDriverJS、およびJava Seleniumの統合に適用されます。
  • Java統合で、特定の構成セッターメソッドにnullを渡すと未処理の例外が発生する問題を修正しました。これらのメソッドは現在、説明メッセージとともにIllegalArgumentExceptionをスローします。

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

• 機能

  • を設定するか、Javaでは
  • RGAA v4 (フランスのアクセシビリティスタンダード) のサポートを追加しました。accessibilityStandard: 'RGAAv4'をConfigurationOverrides (JavaScript/TypeScript) で設定するか、ConfigurationOverrides.AccessibilityStandard.RGAAV4 (Java) を使用します。axe-coreバージョン4.11.0以降が必要です。グローバル構成で、このスタンダードが組織に許可されるべきか否かを決定します。
  • Git情報収集を制御するために、gitオプションをAxeConfiguration (JavaScript/TypeScript) およびAxeWatcherOptions (Java) に追加しました。Gitデータを収集せずにWatcherを実行するには、git: false (JavaScript/TypeScript) を設定するかsetGit(false) (Java) を呼び出します。デフォルトはtrue (Git情報を収集する) です。
  • axe-coreをバージョン4.11.1に更新しました。

• バグ修正

  • Java統合で、setBinary()を使用してChromeOptionsオブジェクトに設定したカスタムChromeバイナリパスがconfigure()に渡されたときに上書きされる問題を修正しました。

4.0.0 (2025年12月3日)

Watcher 4.0.0は、Watcherパッケージのメジャーリリースです。

• 機能

  • プロキシサポートを追加しました。詳細はプロキシを使用した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のPlaywrightでのLaunchOptionsの誤った指定を、launchPersistentContextから動的に抽出される新しいタイプLaunchPersistentContextOptionsに置き換えました。ユーザーは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にnull値が含まれていないことを確認し、Java統合でサイレントエラーを引き起こす問題を修正しました。
• Java実装のライセンスファイルがMETA-INFディレクトリにコピーされることを確認します。
• 除外されたURLパターンがJavaで正しくコピーされなかった問題を修正しました。
• デフォルトのGitブランチを決定する方法を改善しました。

3.21.0 (2025年5月23日)

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

3.20.2（2025年4月17日）

• タイムアウトエラーメッセージが変更すべき間違ったパラメータを指定していた問題を修正しました。 (例えば、ユーザーが正しいtimeout.start値の代わりにtimeoutStartを変更するように指示されていた)。

3.20.1（2025年3月25日）

• 機能

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

• バグ修正

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

3.20.0

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

3.19.1（2025年2月25日）

• Fixed a problem where calling a wrapped method (such as click()) after switching the browser context to a child frame using switchToFrame() (WebdriverIO or WebDriverJS) or switchTo().frame() (Java Selenium) caused an analyze timeout. Axe Watcher now skips the analyze when not in the top-level frame. See 子フレームに切り替えた後、ページ状態がキャプチャされない for more information.
• --disable-extensionsを指定するテストスイートがWatcherを無効にしないことを確認します。

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ヘッドレスをサポートしました。Playwright 4.91リリースノートにある新しい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ファイルを含めました。
  • コントローラーメソッドstop()は、ドキュメントオブジェクトモデル (DOM) が変更された場合、オートマチックモードを終了する前にページを分析するようになりました。
  • Watcherがマニュアルモードの場合、コントローラーメソッドstop()が呼び出されてもページを分析しないようにWatcherの動作を変更しました。
  • Playwright統合でラップされたメソッドが間違った型を返す問題を修正しました。
  • runOptionsが1つのオプションのみを受け入れることができなかった問題を修正しました。

リリースされていません

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

リリースされていません

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

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

• 3.16.0 (2024年9月26日)

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

• 3.15.2 (2024年9月13日)

3.15.2 (2024年9月13日)

• 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()を呼び出さずにWatcherを使用しようとした場合に例外が発生するようになりました。
• osモジュールをインポートした際に、特定の条件下でCypressで発生したエラーを修正しました。
• 並列テスト実行のためにAxeConfigurationにbuildIDを追加しました。
• AxeConfigurationの中でsessionIDをbuildIDに置き換える形で非推奨にしました。
• authenticate()の処理により、Puppeteerで追加のページ状態がキャプチャされる問題を修正しました。
• コード難読化の変更により、Axe Watcherのパフォーマンスが改善されました。

3.14.1

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

3.14.0

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

3.13.1 (2024年7月19日)

• excludeUrlPatternsオプションを使用して、URLを分析スキャンから除外できるようになりました。excludeUrlPatternsをご覧ください。

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でsetupNodeEventsから返されたconfigオブジェクトが正しく伝播されず、加えられた変更が失われた問題を修正しました。
• 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 2015（ES2015）ではなく、ECMAScript 2018（ES2018）を対象に更新しました。

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を必須の依存関係として追加しました。
• 以前にラップされていなかったPlaywrightメソッドのWrappingを追加しました。

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()が予期せず呼び出されないケースを解消するために、次の関数を非推奨にして置き換える必要がありました：

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