跳转到主要内容

运行和调试测试

简介​

您可以运行单个测试、一组测试或所有测试。通过使用 --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。您可以使用检查器顶部的步过按钮来逐步执行您的测试。或者按下播放按钮，从头到尾运行您的测试。测试完成后，浏览器窗口将关闭。

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

Playwright Inspector

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

下一步​