目次
Playwright v1.65.0は、テストランナーのBun上での実行を正式にサポートしました。Bunでテストを実行できるようになりましたが、監視動作やTypeScript設定に違いがあるため、CIを変更する前に移行を検証する必要があります。
要点#
- Playwright v1.65.0は、テストランナーの実行環境としてBunを正式にサポートしています。
- BunがTypeScriptのテストファイルを自らトランスパイルするため、PlaywrightはBabelとコンパイルキャッシュを使用しません。
- Watch Modeは利用できず、UI Modeではファイル変更後にテストが自動で再実行されません。
--only-changedオプションには制限があり、Bun上では--tsconfigは効果がありません。
Bun対応で変わること#
今回の変更は、Playwrightのテストランナーを実行するランタイムに関するものです。Node.jsは引き続き利用でき、Bunが正式にサポートされる選択肢に加わりました。
TypeScriptのテストでは、実行処理の流れが変わります。Playwrightのリリース説明には、次のように記載されています。
> テストランナーがBun上で動作するようになりました。BunがTypeScriptのテストファイルを自らトランスパイルするため、PlaywrightはBabelもコンパイルキャッシュも使用しません。
これにより、Bunを利用するチームは、その環境内でPlaywrightのテストを実行するための正式なサポートを得られます。ただし、Node.js上のランナーと完全に同じ機能が使えることを意味するわけではありません。ランタイムのサポートとワークフローの互換性は、別々に検討してください。
TypeScriptの処理が重要な理由#
PlaywrightをBun上で実行すると、BunがTypeScriptのテストファイルを実行可能なJavaScriptに変換します。そのため、PlaywrightはBabelによる変換処理やコンパイルキャッシュを使用しません。
これらの処理は実行経路から外れますが、すべてのテストスイートが高速化する根拠にはなりません。提供されたリリース情報には、ベンチマークの数値はありません。ブラウザーの起動、アプリケーションの応答時間、テスト自体の処理は、いずれも全体の実行時間に影響します。
また、トランスパイルはTypeScriptの型チェックの代わりにはなりません。プロジェクトで型チェックを別途実行している場合は、Bunの評価中も継続してください。テストの成功が示すのは、そのテストが正常に実行されたことです。プロジェクト全体が型チェックに合格することを示すものではありません。
切り替えを評価する方法#
まずは、繰り返し実施できる小規模な比較から始めてください。Playwright v1.65.0を使い、検証するBunのバージョンを記録し、各実行でアプリケーションのビルドとブラウザーのバージョンをそろえます。
1. 既存のNode.js環境で代表的なテスト群を実行し、結果を保存します。 2. v1.65.0のドキュメントに記載された起動方法を使い、PlaywrightのテストランナーをBun上で動かして、同じテスト群を実行します。 3. テストの検出、成功・失敗の結果、テストスイートで使っているセットアップやティアダウンの動作を比較します。 4. 共有のCI設定を変更する前に、Bun上でテストスイート全体を実行します。
比較の際は、ランナーが実際に使っているランタイムを確認してください。Bunで依存関係をインストールしただけでは、PlaywrightのランナーがBun上で動いているとは限りません。速度を判断材料にする場合は、同等の条件で複数回計測し、依存関係やブラウザーのインストール時間を含めたかどうかも記録してください。
ワークフローの違い#
導入前に注意すべき制限は、次の4つです。
- Watch Mode: Bun上では利用できないため、継続的なテスト実行に依存するワークフローに影響します。
- UI Mode: ファイルを変更してもテストは自動で再実行されず、対話的な開発サイクルが変わります。
- `--only-changed`: 動作に制限があります。テストの選択に利用する前に、v1.65.0のドキュメントで用途に合うか確認してください。
- `--tsconfig`: Bun上では効果がないため、このフラグで選択した設定が適用されるとは考えないでください。
--tsconfigの違いは、テストコマンドでTypeScript設定を明示的に選択している場合に特に重要です。既存のコマンドが同じ意味を保つと想定せず、その設定に依存するインポートを含め、テストに必要な動作を検証してください。
主にCIでテストスイート全体を実行するチームなら、これらの制限に対応しやすいかもしれません。開発中の自動再実行に依存するチームでは、確認事項が増えます。実際のワークフローに合わせてランタイムを選び、Bunでの比較検証をクリアするまでは既存のNode.jsコマンドを残してください。
次のステップ#
Playwright v1.65.0を使って代表的なテスト群をBun上で実行し、同じテスト群をNode.js上で実行した結果と比較してから、デフォルトのテストコマンドを変更してください。
出典: https://www.publickey1.jp/blog/26/playwrightbun.html
目次
