このフォルダには、拡張機能の統合テストが含まれています。
これらは Playwright テストランナーと Galata ヘルパーを使用して定義されています。
Playwright の設定は playwright.config.js で定義されています。
統合テストに使用する JupyterLab サーバーの設定は jupyter_server_test_config.py で定義されています。
デフォルトの設定では、失敗したテストのビデオと HTML レポートが生成されます。
新しい実験的な UI モードがあります。気に入るかもしれません。こちらのビデオ をご覧ください。
すべてのコマンドはルートディレクトリから実行されることを想定しています
テストを実行するには、次の手順が必要です:
jlpm install
jlpm build:prod
拡張機能が JupyterLab にインストールされていることを確認してください。
cd ./ui-tests
jlpm install
jlpm playwright install
cd ..
cd ./ui-tests
jlpm playwright test
テスト結果はターミナルに表示されます。テストが失敗した場合、テストレポートは テスト実行の最後にブラウザで開かれます。その動作の設定については Playwright ドキュメント を参照してください。
すべてのコマンドはルートディレクトリから実行されることを想定しています
スナップショットを比較してテストを検証している場合、リポジトリに保存されている 参照スナップショットを更新する必要があるかもしれません。そのためには、次の手順が必要です:
jlpm install
jlpm build:prod
拡張機能が JupyterLab にインストールされていることを確認してください。
cd ./ui-tests
jlpm install
jlpm playwright install
cd ..
cd ./ui-tests
jlpm playwright test -u
お使いのコンピュータで生成されたスナップショットと CI で生成されたスナップショットの間には 若干の差異が生じる場合があります。PR でのスナップショット更新を容易にするには、
please update playwright snapshotsと入力して CI 上のボットによる更新をトリガーできます。 ボットが新しいスナップショットを計算すると、それらを PR ブランチにコミットします。
すべてのコマンドはルートディレクトリから実行されることを想定しています
テストを作成する最も簡単な方法は、playwright のコードジェネレータツールを使用することです:
jlpm install
jlpm build:prod
拡張機能が JupyterLab にインストールされていることを確認してください。
cd ./ui-tests
jlpm install
jlpm playwright install
cd ..
cd ./ui-tests
jlpm start
cd ./ui-tests
jlpm playwright codegen localhost:8888
すべてのコマンドはルートディレクトリから実行されることを想定しています
テストをデバッグするには、playwright のインスペクタツールを使用するのが良い方法です:
jlpm install
jlpm build:prod
拡張機能が JupyterLab にインストールされていることを確認してください。
cd ./ui-tests
jlpm install
jlpm playwright install
cd ..
cd ./ui-tests
jlpm playwright test --debug
Web ブラウザのバージョンを更新するには、パッケージ @playwright/test を更新する必要があります:
cd ./ui-tests
jlpm up "@playwright/test"
jlpm playwright install