A Pytest wrapper for Playwright to automate web browsers (Chromium, Firefox, WebKit).
- Have a separate new page and context for each test with Pytest fixtures
- Run your end-to-end tests on multiple browsers by a CLI argument
- Run them headful with the
--headful
argument to debug them easily - Using base-url to only use the relative URL in your
Page.goto
calls
pip install pytest-playwright
Basic example for more see the examples sections as a reference.
def test_example_is_working(page):
page.goto("https://example.com")
page.waitForSelector("text=Example Domain")
page.click("text=More information")
A string that contains the current browser name.
A Playwright browser instance for the session.
A separate Playwright context instance for each new test.
A separate Playwright page instance for each new test.
A fixture that you can define to overwrite the launch arguments for launch()
. It should return a Dict.
A fixture that you can define to overwrite the context arguments for newContext()
. It should return a Dict.
A fixture which is a boolean if a specific execution is made by the specified browser.
By default, the tests run on the Chromium browser. You can pass multiple times the --browser
flag to run it on different browsers or a single time to run it only on a specific browser.
Possible values: chromium
, firefox
, webkit
By default, the tests run in headless mode. You can pass the --headful
CLI flag to run the browser in headful mode.
import pytest
@pytest.mark.skip_browser("firefox")
def test_visit_example(page):
page.goto("https://example.com")
# ...
import pytest
@pytest.mark.only_browser("chromium")
def test_visit_example(page):
page.goto("https://example.com")
# ...
Start Pytest with the base-url
argument. Example: pytest --base-url http://localhost:8080
def test_visit_example(page):
page.goto("/admin")
# -> Will result in http://localhost:8080/admin
from playwright.sync_api import Page
def test_visit_admin_dashboard(page: Page):
page.goto("/admin")
# ...
To pause the Pytest test execution and interact with the browser (if its launched with headless=False
) via the developer tools or call Playwright interactively, you can use the breakpoint()
statement in your code to get a pdb inline REPL.
On the CI it's useful to have screenshots if a test is failing, this can be implemented by adding the following in your conftest.py
which will store the screenshots in the .playwright-screenshots
directory which can be uploaded e.g. in your CI as an artifact.
This snippet requires slugify
to convert test names to file paths, which can be installed with pip install python-slugify
.
from slugify import slugify
from pathlib import Path
def pytest_runtest_makereport(item, call) -> None:
if call.when == "call":
if call.excinfo is not None:
page = item.funcargs["page"]
screenshot_dir = Path(".playwright-screenshots")
screenshot_dir.mkdir(exist_ok=True)
page.screenshot(path=str(screenshot_dir / f"{slugify(item.nodeid)}.png"))
Max Schmitt for creating and maintaining the Pytest Playwright plugin.
This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.
When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.