Watcherパッケージリリースノート
Watcherパッケージのバージョン3.0.0以降の変更を説明するリリースノート
Not for use with personal data
4.1.0 (2026年2月24日)
-
機能
- Watcherは同一オリジンのiframeを自動的にスキャンするようになりました。(Cypress統合はすでにこの機能を持っていました。)これは、Playwright、Puppeteer、WebdriverIO、WebDriverJS、およびJava Seleniumの統合にも適用されます。
- RGAA v4(フランスのアクセシビリティ標準)をサポートしました。
accessibilityStandard: 'RGAAv4'に設定するかConfigurationOverrides(JavaScript/TypeScript)またはConfigurationOverrides.AccessibilityStandard.RGAAV4(Java)を使用します。axe-coreバージョン4.11.0以降が必要です。グローバル設定は、この標準が組織に許可されているかどうかを決定します。 -
gitオプションを追加しました。AxeConfiguration(JavaScript/TypeScript)およびAxeWatcherOptions(Java)でGit情報を収集するかどうかを制御します。WatcherをGitデータを収集せずに実行するには、git: false(JavaScript/TypeScript)を設定するか、setGit(false)(Java)を呼び出します。デフォルトでは、true(Git情報が収集されます)。 - axe-coreをバージョン4.11.1に更新しました。
-
バグ修正
- Java統合で、カスタムChromeバイナリパスが
setBinary()オブジェクトにChromeOptions経由で設定された場合に上書きされる問題を修正しました。configure()に渡されたとき。
- Java統合で、カスタムChromeバイナリパスが
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やChromiumといったChromeの代替のエラーハンドリングを改善しました。
- 空のGitデータを適切に処理します。
- WebdriverIOのために、全てのユーザー提供Chromeオプションを含めます。
-
重大な変更
-
Watcher(TypeScriptおよびJavaScript)は、パッケージのインポートに新しいパスを使用するようになりました。更新されたコードサンプルを見るためには、 ブラウザー統合パッケージ用の手順 を確認してください。
ブラウザオートメーションプラットフォーム 旧パス 新パス Cypress @axe-core/watcher@axe-core/watcher/cypress/configCypressコマンド @axe-core/watcher/dist/cypressCommands@axe-core/watcher/cypress/supportPlaywright @axe-core/watcher@axe-core/watcher/playwrightPlaywrightテスト @axe-core/watcher@axe-core/watcher/playwright-testPuppeteer @axe-core/watcher@axe-core/watcher/puppeteerWebdriverIO @axe-core/watcher@axe-core/watcher/wdioWebdriverIOテストランナー @axe-core/watcher@axe-core/watcher/wdioWebDriverJS @axe-core/watcher@axe-core/watcher/webdriverWebDriverJSのJavaScript例:
const { webdriverConfig, wrapWebdriver, WebdriverController } = require('@axe-core/watcher/webdriver') -
PlaywrightのTypeScriptで間違っていた仕様を新しい型に置き換えました
LaunchOptions、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およびChromiumの取り扱いに関する問題を修正しました。
- 最大リトライ回数に達したかどうかを記録します。
- Cypress統合でのコンポーネントテストを実装しました。
3.22.0 (2025年7月1日)
- Java統合で
runOptionsがいかなるnull値も含まないことを確認してください。これにより、黙示の失敗が発生しました。 - Java実装のライセンスファイルが
META-INFディレクトリにコピーされることを確認します。 - Javaで除外されたURLパターンが正しくコピーされなかった問題を修正しました。
- デフォルトのGitブランチを判定する方法を改善しました。
3.21.0 (2025年5月23日)
- Java Watcher をリリースしました。
- デフォルトの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日)
- ページ状態のキャプチャに関する問題を修正しました。
- を指定するテストスイートが
--disable-extensionsWatcherを無効にしないようにしました。
3.19.0 (2025年1月20日)
- PlaywrightおよびPlaywright Testバージョン1.49.0以上を使用する際のエラーメッセージを改善しました
headlessパラメータがあるときにchannelパラメータが設定されている場合、firefox。(完全ヘッド付きモードまたは新しいヘッドレスモードでは、chromiumまたはchromeチャネルのみがサポートされています。) - axe-coreのバージョンチェックを改善しました。
- グローバル設定へのサポート グローバル設定", "context": "link text。
3.18.0 (2024年12月18日)
- セッションハンドリングに関するいくつかの問題を修正し、誤ったまたは空の結果がウェブサイトに表示される可能性がある問題を解決しました。
- Playwrightバージョン>= 4.91で新しいChromiumヘッドレスのサポートを追加しました。参照: 新しいChromiumヘッドレスを試す", "context": "link text Playwright 4.91のリリースノート。
- ユーザーがセッションハンドリングを制御できるようにカスタムタイムアウト値を追加しました。
3.17.2 (2024年12月12日)
-
機能
- Watcherに手動モードを追加しました。
- サポートされていないプロトコル( https", "context": "emphasized text、 http", "context": "emphasized text、または file", "context": "emphasized text)または about:blank", "context": "emphasized text ページでの分析実行はエラーになります。
- Watcherは、使用前に設定されていない場合にエラーをスローするようになりました。
-
バグ修正
- Playwright Testでセッションが再利用され、結果が上書きされる問題を修正しました。
- セッションの作成および管理に関する他の問題をいくつか修正しました。
- 手動モードでは、コントローラーの
start()メソッドを呼び出すと、現在のページのDOMがクリーンとしてマークされ、ページ状態がキャプチャされなくなります。 - 手動モードでは、
flush()が呼び出されたときに、追加のページ状態が時々キャプチャされる問題を修正しました。 - が呼び出された後、ページ状態が失われる問題を修正しました
cy.axeWatcherAnalyze()。cy.click()が呼び出されましたが、cy.wait()呼び出しがありませんでした。 - 最新の LICENSES-3RD-PARTY.md ファイルを @axe-core/watcher パッケージに含めてください。
- コントローラメソッドは、
stop()自動モードをオフにする前に、DOMが変更された場合ページを分析します。 - Watcher の動作が変更され、もし Watcher が手動モードにある場合、コントローラメソッドが
stop()呼び出されてもページを分析しません。 - Playwright の統合におけるラップされたメソッドが不正な型を返す問題を修正しました。
- が、
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日)
- 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 を使用しようとする場合、例外を投げるようにしました。 - Cypress で特定の条件下で表示されるエラーを修正しました。
osモジュールのインポート中に発生した - 追加しました
buildIDAxeConfigurationが並列テスト実行に使用されます。 - 非推奨となった
sessionIDAxeConfigurationを使用することをお勧めします。buildID - Puppeteer に伴う問題を修正し、追加のページステートがキャプチャされる問題を修正しました。
authenticate() - コードの難読化における変更により、axe Watcher のパフォーマンスが改善されました。
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テスト用)に対するプロキシ関数の実装を修正し、
Locatorオブジェクトでエラーが発生する問題を修正しました: Locatorオブジェクトでのみ使用可能。 - 1.43.1リリースからの2つの新しいPlaywright関数をラップしました。
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必須の依存関係として追加しました。 - ラップされた 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() が呼び出されないケースに対処するため、以下の関数を非推奨として置き換える必要がありました:
| 非推奨関数 | 新しい関数 |
|---|---|
wrapPlaywright(browserContext, controller) |
wrapPlaywrightPage(page, controller) |
wrapPuppeteer(context, controller) |
wrapPuppeteerPage(page, controller) |
非推奨関数を使用するとエラーがスローされます。
