跳至主要内容

运行和调试测试

简介​

您可以运行单个测试、一组测试或所有测试。可以使用 --browser 标志在单个浏览器或多个浏览器上运行测试。默认情况下，测试以无头方式运行，这意味着在运行测试时不会打开浏览器窗口，并且结果将在终端中显示。如果您愿意，可以使用 --headed CLI 参数以有头模式运行测试。

您将学习

运行测试​

命令行​

要运行您的测试，请使用 pytest 命令。默认情况下，这将在 Chromium 浏览器上运行您的测试。测试默认以无头模式运行，这意味着在运行测试时不会打开浏览器窗口，并且结果将在终端中显示。

pytest

以有头模式运行测试​

要以有头模式运行测试，请使用 --headed 标志。这将在运行测试时打开一个浏览器窗口，并在完成后关闭浏览器窗口。

pytest --headed

在不同的浏览器上运行测试​

要指定要运行测试的浏览器，请使用 --browser 标志后跟浏览器的名称。

pytest --browser webkit

要指定要运行测试的多个浏览器，请多次使用 --browser 标志，后跟每个浏览器的名称。

pytest --browser webkit --browser firefox

运行特定测试​

要运行单个测试文件，请传入要运行的测试文件的名称。

pytest test_login.py

要运行一组测试文件，请传入要运行的测试文件的名称。

pytest tests/test_todo_page.py tests/test_landing_page.py

要运行特定的测试，请传入要运行的测试的函数名称。

pytest -k test_add_a_todo_item

并行运行测试​

要并行运行测试，请使用 --numprocesses 标志后跟要在其上运行测试的进程数。我们建议使用逻辑 CPU 内核的一半。

pytest --numprocesses 2

（这假设已安装 pytest-xdist。有关更多信息，请参见 此处。）

有关更多信息，请参见 Playwright Pytest 用法 或 Pytest 文档，了解 常规 CLI 用法。

调试测试​

由于 Playwright 在 Python 中运行，因此您可以使用您选择的调试器进行调试，例如，在 Visual Studio Code 中使用 Python 扩展。Playwright 附带 Playwright Inspector，它允许您逐步执行 Playwright API 调用、查看其调试日志并探索 定位器。

要调试所有测试，请运行以下命令。

PWDEBUG=1 pytest -s

要调试一个测试文件，请运行该命令后跟要调试的测试文件的名称。

PWDEBUG=1 pytest -s test_example.py

要调试特定的测试，请添加 -k 后跟要调试的测试的名称。

PWDEBUG=1 pytest -s -k test_get_started_link

此命令将打开一个浏览器窗口以及 Playwright Inspector。您可以使用 Inspector 顶部的单步执行按钮逐步执行测试。或者按下播放按钮从头到尾运行测试。测试完成后，浏览器窗口将关闭。

在调试过程中，您可以使用“选择定位器”按钮在页面上选择一个元素，并查看 Playwright 将用于查找该元素的定位器。您还可以编辑定位器，并在浏览器窗口中查看其实时突出显示。使用“复制定位器”按钮将定位器复制到剪贴板，然后将其粘贴到您的测试中。

Playwright Inspector

查看我们的 调试指南，了解有关 Playwright Inspector 以及使用 浏览器开发者工具 进行调试的更多信息。

下一步​