Skip to main content

Playwright

Playwright module provides a method to launch a browser instance. The following is a typical example of using Playwright to drive automation:

from playwright.sync_api import sync_playwright, Playwright

def run(playwright: Playwright):
chromium = playwright.chromium # or "firefox" or "webkit".
browser = chromium.launch()
page = browser.new_page()
page.goto("http://example.com")
# other actions...
browser.close()

with sync_playwright() as playwright:
run(playwright)

Methods

stop

Added in: v1.8 playwright.stop

Terminates this instance of Playwright in case it was created bypassing the Python context manager. This is useful in REPL applications.

from playwright.sync_api import sync_playwright

playwright = sync_playwright().start()

browser = playwright.chromium.launch()
page = browser.new_page()
page.goto("https://playwright.dev/")
page.screenshot(path="example.png")
browser.close()

playwright.stop()

Usage

playwright.stop()

Returns


Properties

chromium

Added in: v1.8 playwright.chromium

This object can be used to launch or connect to Chromium, returning instances of Browser.

Usage

playwright.chromium

Type


devices

Added in: v1.8 playwright.devices

Returns a dictionary of devices to be used with browser.new_context() or browser.new_page().

from playwright.sync_api import sync_playwright, Playwright

def run(playwright: Playwright):
webkit = playwright.webkit
iphone = playwright.devices["iPhone 6"]
browser = webkit.launch()
context = browser.new_context(**iphone)
page = context.new_page()
page.goto("http://example.com")
# other actions...
browser.close()

with sync_playwright() as playwright:
run(playwright)

Usage

playwright.devices

Type


firefox

Added in: v1.8 playwright.firefox

This object can be used to launch or connect to Firefox, returning instances of Browser.

Usage

playwright.firefox

Type


request

Added in: v1.16 playwright.request

Exposes API that can be used for the Web API testing.

Usage

playwright.request

Type


selectors

Added in: v1.8 playwright.selectors

Selectors can be used to install custom selector engines. See extensibility for more information.

Usage

playwright.selectors

Type


webkit

Added in: v1.8 playwright.webkit

This object can be used to launch or connect to WebKit, returning instances of Browser.

Usage

playwright.webkit

Type