Headless execution is supported for all browsers on all platforms.

- [Usage](#usage)

- [Record and generate code](#record-and-generate-code)

- [Sync API](#sync-api)

- [Async API](#async-api)

- [With pytest](#with-pytest)

- [Interactive mode (REPL)](#interactive-mode-repl)

- [Examples](#examples)

- [Mobile and geolocation](#mobile-and-geolocation)

- [Evaluate JS in browser](#evaluate-js-in-browser)

- [Intercept network requests](#intercept-network-requests)

- [Known issues](#known-issues)

- [Documentation](#documentation)

[](https://pypi.python.org/pypi/playwright/)

pip install playwright

playwright install

This installs Playwright and browser binaries for Chromium, Firefox and WebKit. Playwright requires Python 3.7+.

[](https://anaconda.org/Microsoft/playwright)

conda config --add channels conda-forge

conda config --add channels microsoft

conda install playwright

playwright install

This installs Playwright and browser binaries for Chromium, Firefox and WebKit with the conda package manager. Playwright requires a conda environment with Python 3.7+.

Playwright can record user interactions in a browser and generate code. [See demo](https://user-images.githubusercontent.com/284612/95930164-ad52fb80-0d7a-11eb-852d-04bfd19de800.gif).

playwright codegen

This is our default API for short snippets and tests. If you are not using asyncio in your

application, it is the easiest to use Sync API notation.

If your app is based on the modern asyncio loop and you are used to async/await constructs,

Playwright exposes Async API for you. You should use this API inside a Python REPL supporting `asyncio` like with `python -m asyncio`

Use our [pytest plugin for Playwright](https://github.com/microsoft/playwright-pytest#readme).

def test_playwright_is_visible_on_google(page):

page.goto("https://www.google.com")

page.type("input[name=q]", "Playwright GitHub")

page.click("input[type=submit]")

page.wait_for_selector("text=microsoft/Playwright")

Blocking REPL, as in CLI:

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

Async REPL such as `asyncio` REPL:

>>> from playwright.async_api import async_playwright

>>> playwright = await async_playwright().start()

>>> browser = await playwright.chromium.launch()

>>> page = await browser.new_page()

>>> await page.goto("http://whatsmyuseragent.org/")

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

>>> await browser.close()

>>> await playwright.stop()

This snippet emulates Mobile Safari on a device at a given geolocation, navigates to maps.google.com, performs action and takes a screenshot.

from playwright.sync_api import sync_playwright

with sync_playwright() as p:

iphone_11 = p.devices["iPhone 11 Pro"]

browser = p.webkit.launch(headless=False)

context = browser.new_context(

**iphone_11,

locale="en-US",

geolocation={"longitude": 12.492507, "latitude": 41.889938 },

permissions=["geolocation"]

)

page = context.new_page()

page.goto("https://maps.google.com")

page.click("text=Your location")

page.screenshot(path="colosseum-iphone.png")

browser.close()

<details>

<summary>Async variant</summary>

import asyncio

from playwright.async_api import async_playwright

async def main():

async with async_playwright() as p:

iphone_11 = p.devices["iPhone 11 Pro"]

browser = await p.webkit.launch(headless=False)

context = await browser.new_context(

**iphone_11,

locale="en-US",

geolocation={"longitude": 12.492507, "latitude": 41.889938},

permissions=["geolocation"]

)

page = await context.new_page()

await page.goto("https://maps.google.com")

await page.click("text="Your location"")

await page.screenshot(path="colosseum-iphone.png")

await browser.close()

asyncio.run(main())

</details>

This code snippet navigates to example.com in Firefox, and executes a script in the page context.

from playwright.sync_api import sync_playwright

with sync_playwright() as p:

browser = p.firefox.launch()

page = browser.new_page()

page.goto("https://www.example.com/")

dimensions = page.evaluate("""() => {

}""")

print(dimensions)

browser.close()

<details>

<summary>Async variant</summary>

import asyncio

from playwright.async_api import async_playwright

async def main():

async with async_playwright() as p:

browser = await p.firefox.launch()

page = await browser.new_page()

await page.goto("https://www.example.com/")

dimensions = await page.evaluate("""() => {

}""")

print(dimensions)

await browser.close()

asyncio.run(main())

</details>

This code snippet sets up request routing for a Chromium page to log all network requests.

from playwright.sync_api import sync_playwright

with sync_playwright() as p:

browser = p.chromium.launch()

page = browser.new_page()

def log_and_continue_request(route, request):

print(request.url)

route.continue_()

# Log and continue all network requests

page.route("**/*", log_and_continue_request)

page.goto("http://todomvc.com")

browser.close()

<details>

<summary>Async variant</summary>

import asyncio

from playwright.async_api import async_playwright

async def main():

async with async_playwright() as p:

browser = await p.chromium.launch()

page = await browser.new_page()

async def log_and_continue_request(route, request):

print(request.url)

await route.continue_()

# Log and continue all network requests

await page.route("**/*", log_and_continue_request)

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

await browser.close()

asyncio.run(main())

</details>

You need to use `page.wait_for_timeout(5000)` instead of `time.sleep()`. It is better to not wait for a timeout at all, but sometimes it is useful for debugging. In these cases, use our wait method instead of the system one. This is because we internally rely on asynchronous operations and when using `time.sleep(5)` they can't get processed correctly.

Check out our [new documentation site](https://playwright.dev/python/docs/intro)!