CypressからPlaywrightへ移行 すべてを書き直す必要はありません。
Nexus StudioQAのTest Adapterは、ルールに基づいてCypressとWebdriverIOのテストをPlaywrightに変換します。現在はベータ版です。差分を確認でき、すべてのアサーションが維持され、変換した各テストは正式に採用する前に試行されます。どのルールでも変換できない部分は、隠さず一覧に表示します。
執筆: Verdict System LLCのNexus StudioQAチーム。
最終更新日: .
変換の仕組み
手作業での書き直しは不要です。変換内容が知らされないこともありません。
まずルールで変換、残りの部分だけAIで
変換にはプロンプトではなく、固定されたルール群を使用します。任意で利用できるAIが扱うのは、ルールで対応できない部分だけです。そのコードにも、他のAI作成テストと同じ厳格なVet検査が適用されます。AIを使用する場合、初回の回答に対するエンジンの判定を、一度だけ生成側に戻します。2回目の回答は、初回より悪化していない場合にのみ採用します。
差分を確認できます
レビュー画面では、元のテストと変換後のテストを並べ、変換前後のアサーション数も表示します。
すべてのアサーションを維持
アサーション、条件、ループ、待機はそのまま維持します。変換によってアサーションが失われる場合、該当箇所を1行ずつ承認しない限り、取り込みは実行されません。
各テストを正式採用前に試行
変換したテストは、証跡も履歴も書き込まない隔離環境から始まります。それぞれ異なるブラウザーで3回の試行に問題なく合格すると、隔離環境を出ます。そのため、Chromiumでしか通らないテストは2回目で失敗します。
変換できない部分も見える状態に
プロジェクト固有のコマンド、画面の見た目を検証するプラグイン、
cy.taskは、未変換部分として元の行とともに一覧に残り、任意のAI処理や手作業で対応できます。公開されている2つのCypressテストスイートで一度測定したところ、一方は約半数のファイルがルールだけで残りなく変換されましたが、プロジェクトのコードに依存するもう一方では、そのようなファイルはありませんでした。大規模なプロジェクトでは、一部のファイルでこの最後の対応が必要になるとお考えください。
移行元と現在の対応状況
| 出典 | 現在の対応状況 | 補足 |
|---|---|---|
| Cypress | Playwrightに変換済み (ベータ版) | 差分を表示し、アサーションを保持し、各テストを試行実行します。cy.taskと視覚的テスト用のプラグインは未変換のまま残ります。 |
| WebdriverIO | Playwrightに変換済み (ベータ版) | 同じ確認手順: 差分、アサーション数、試行実行。 |
| JavaScript、TypeScriptまたはPythonのSelenium | 調整して取り込み済み | ルールに従ってStudioのフィクスチャに合わせて書き換えます。テストはSeleniumのままです。 |
Selenium IDE (.side) | 読み取り、JavaScriptまたはPythonのPlaywrightテストとして書き出し | SeleniumとSelenium IDEを参照。 |
| Playwright | 調整して取り込み済み | ブラウザの起動と設定はStudioのフィクスチャに移し、アサーションは保持します。 |
| Robot Framework | 実験的機能 | ベータ版には含まれません。 |
| JavaとC# | 現在は変換未対応 | 今後の開発計画で次に予定: 読み取りだけでなく、変換にも対応。 |
| Katalon、TestRail、Gherkin、Appium、Postman | 現在は利用不可 | 開発計画の「将来」に記載。日程は未定。 |
SeleniumとSelenium IDE
Seleniumテストは調整し、Selenium IDEプロジェクトは読み取ります。どちらも一から書き直す必要はありません。
Seleniumコード
mocha、jest、pytestまたはunittest上で、JavaScript、TypeScriptまたはPythonのSeleniumを使って書かれたテストを、ルールに従って調整します。Seleniumテストのままなので、チームは引き続き通常のファイルとして内容を確認し、編集できます。
Selenium IDEプロジェクト
.sideファイルは通常のJSONで、アダプターがそのまま読み取ります。各ロケーターは、その手順についてIDEが記録した対象から取得し、新たに作り出すことはありません。制御フロー (if,while,times,do,forEach) と対応ルールのないコマンドは、元の行を保持した未変換項目としてファイルの外に残します。
まだ実装されていない機能
状況を含む全一覧は開発計画に掲載しています。
移行の検証
元のテストを廃止する前に、変換後のテストが元と同じように動作することを示すレポートです。次の実装を予定しています。現在は試行実行で確認できます。
JavaとC#の変換、対応する変換元の拡充
JavaとC#の変換は次の実装を予定しています。Katalon、Gherkin、Appium、Postman、TestRailは、開発計画で将来の対応として挙げています。これは方向性であり、確約ではありません。日程は未定で、項目が取り下げられることもあります。