Playwright

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

Sync

from playwright.sync_api import sync_playwright

def run(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)

Async

import asyncio

from playwright.async_api import async_playwright

async def run(playwright):

chromium = playwright.chromium # or "firefox" or "webkit".

browser = await chromium.launch()

page = await browser.new_page()

await page.goto("http://example.com")

# other actions...

await browser.close()

async def main():

async with async_playwright() as playwright:

await run(playwright)

asyncio.run(main())

• playwright.stop()
• playwright.chromium
• playwright.devices
• playwright.firefox
• playwright.selectors
• playwright.webkit

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("http://whatsmyuseragent.org/")

>>> page.screenshot(path="example.png")

>>> browser.close()

>>> playwright.stop()

playwright.chromium

• type: <BrowserType>

This object can be used to launch or connect to Chromium, returning instances of [ChromiumBrowser].

playwright.devices

• type: <Dict>

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

Sync

from playwright.sync_api import sync_playwright

def run(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)

Async

import asyncio

from playwright.async_api import async_playwright

async def run(playwright):

webkit = playwright.webkit

iphone = playwright.devices["iPhone 6"]

browser = await webkit.launch()

context = await browser.new_context(**iphone)

page = await context.new_page()

await page.goto("http://example.com")

# other actions...

await browser.close()

async def main():

async with async_playwright() as playwright:

await run(playwright)

asyncio.run(main())

playwright.firefox

• type: <BrowserType>

This object can be used to launch or connect to Firefox, returning instances of [FirefoxBrowser].

playwright.selectors

• type: <Selectors>

Selectors can be used to install custom selector engines. See Working with selectors for more information.

playwright.webkit

• type: <BrowserType>

This object can be used to launch or connect to WebKit, returning instances of [WebKitBrowser].