Skip to main content

A pytest wrapper with fixtures for Playwright to automate web browsers

Project description

Pytest Playwright Plugin

CI PyPI Coverage Status black

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.waitForSelector("text=Example Domain")"text=More information")


browser_name - session scope

A string that contains the current browser name.

browser - session scope

A Playwright browser instance for the session.

context - function scope

A separate Playwright context instance for each new test.

page - function scope

A separate Playwright page instance for each new test.

browse_type_launch_args - session scope

A fixture that you can define to overwrite the launch arguments for launch(). It should return a Dict.

browse_context_args - session scope

A fixture that you can define to overwrite the context arguments for newContext(). It should return a Dict.

is_chromium, is_firefox, is_webkit - session scope

A fixture which is a boolean if a specific execution is made by the specified browser.

CLI arguments


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.


Skipping by browser type

import pytest

def test_visit_example(page):
    # ...

Running only on a specific browser

import pytest

def test_visit_example(page):
    # ...

Handle base-url

Start Pytest with the base-url argument. Example: pytest --base-url http://localhost:8080

def test_visit_example(page):
    # -> Will result in http://localhost:8080/admin

Using Mypy types for auto completion

from playwright.sync_api import Page

def test_visit_admin_dashboard(page: Page):
    # ...

Special thanks

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

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 with any additional questions or comments.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for pytest-playwright, version 0.0.5
Filename, size File type Python version Upload date Hashes
Filename, size pytest_playwright-0.0.5-py3-none-any.whl (9.8 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size pytest-playwright-0.0.5.tar.gz (14.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page