vedro-pw

The vedro-pw plugin allows you to use Playwright within your Vedro scenarios for end-to-end testing of web applications.

Installation

$ vedro plugin install vedro-pw

$ pip install vedro-pw

# ./vedro.cfg.py
import vedro
import vedro_pw


class Config(vedro.Config):
    class Plugins(vedro.Config.Plugins):
        class Playwright(vedro_pw.Playwright):
            enabled = True

Usage

Use the provided context functions in your scenarios to interact with Playwright:

• launched_browser: Launches a local or remote browser based on the configuration.
• created_browser_context: Creates a new browser context.
• opened_browser_page: Opens a new page in the browser context.

Basic Example

Here's a simple Vedro scenario that opens the Playwright homepage and verifies the page title.

import vedro
from vedro_pw import opened_browser_page, expect

class Scenario(vedro.Scenario):
    subject = "Open Playwright homepage"

    async def given(self):
        self.page = await opened_browser_page()

    async def when(self):
        await self.page.goto("https://playwright.dev/")

    async def then(self):
        assert await expect(self.page).to_have_title("Playwright")

Command-Line Options

The plugin adds several command-line arguments for flexibility:

Example Usage

$ vedro run --pw-browser=firefox --pw-headed --pw-screenshots=on-failure

Capture Modes

CaptureMode determines when to capture artifacts:

• never: Do not capture.
• on-failure: Capture only when a scenario fails.
• on-reschedule: Capture when a scenario is rescheduled.
• always: Always capture.

Artifacts like screenshots, videos, and traces are attached to the scenario results and can be used in reports.