此文件夹包含扩展的集成测试。
这些测试使用 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