pytest-playwright-artifacts 0.2.0

Capture screenshots, HTML, and console logs on Playwright test failures

Capture debugging artifacts on Playwright test failures

When your Playwright tests fail, you need to see what went wrong. This pytest plugin does a couple things to make it easier to debug and build playwight tests:

1. Automatically captures HTML, screenshots, console logs, and failure summaries the moment a test fails and dumps them into a per-test folder for easy debugging.
2. Allows you to assert that no console errors were logged during a test.
3. Automatically retry tests that fail due to playwright flakiness

No more guessing what the page looked like, what JavaScript errors occurred, or what the actual DOM content was.

Installation

uv add --dev pytest-playwright-artifacts

The plugin activates automatically once installed. No configuration needed.

Usage

Artifacts on failure

def test_my_page(page):
    page.goto("https://example.com")
    assert page.title() == "Example"

When this test fails, you'll find artifacts in test-results/<test-name>/:

• failure.html - Rendered DOM content at the moment of failure
• screenshot.png - Full-page screenshot
• failure.txt - Failure summary with traceback
• console_logs.log - All captured console messages

Fail tests on console errors

from pytest_playwright_artifacts import assert_no_console_errors

def test_no_console_errors(page, request):
    page.goto("https://example.com")
    assert_no_console_errors(request)

This fails the test if any console.error() messages were logged during the test.

Retry on Playwright timeouts

Playwright tests can flake due to network latency or slow animations. The plugin can retry a test automatically when it fails with a TimeoutError. Only playwright._impl._errors.TimeoutError triggers a retry — assertion failures and other errors fail immediately. Retried attempts show as R / RERUN in pytest output.

Per-test

@pytest.mark.playwright_timeout_retries(2)
def test_checkout(page):
    page.goto("https://example.com/checkout")
    page.click("#pay-button")
    expect(page.locator(".success")).to_be_visible()

Per-folder

Add a pytestmark to conftest.py in the folder you want to cover:

# tests/e2e/conftest.py
import pytest

pytestmark = [pytest.mark.playwright_timeout_retries(2)]

Global default

Set a default for the entire suite in pyproject.toml. A marker on an individual test or folder always takes precedence.

[tool.pytest.ini_options]
playwright_timeout_retries = 2

Configuration

Filter noisy console messages

Use regex patterns to ignore known noisy messages:

pyproject.toml:

[tool.pytest.ini_options]
playwright_console_ignore = [
  "Invalid Sentry Dsn:.*",
  "Radar SDK: initialized.*",
  "\\[Meta Pixel\\].*",
]

Patterns match against both the raw console text and the formatted log line.

Change artifact output directory

By default, artifacts are saved to test-results/. You can customize this:

Command line:

pytest --playwright-artifacts-output=my-artifacts

pyproject.toml:

[tool.pytest.ini_options]
playwright_artifacts_output = "my-artifacts"

Related Projects

• pytest-playwright-visual-snapshot: Adds visual regression testing capabilities to your Playwright and pytest suite.
• playwright-trace-analyzer: Provides a CLI for inspecting Playwright trace files without needing the full browser viewer.
• pytest-plugin-utils: Offers reusable logic for managing artifacts and configurations when building other pytest plugins.
• gh-clean-artifacts: Helps manage storage costs by pruning old or large GitHub Actions artifacts.
• pytest-line-runner: Simplifies test execution by allowing you to run pytest tests using file line numbers.
• pytest-celery-utils: Enables inspection of Celery task queues in Redis directly from your pytest environment.
• python-package-prompts: Contains LLM instructions for maintaining Python standards across projects using pytest and other libraries.

MIT License

---

This project was created from iloveitaly/python-package-template