A high-level API to automate web browsers
Project description
🎭 Playwright for Python
![Join Slack](https://pypi-camo.freetls.fastly.net/4e0265d4d36c72d75642235ad451c1e58b4f726c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6a6f696e2d736c61636b2d696e666f6d6174696f6e616c)
Docs | API
Playwright is a Python library to automate Chromium, Firefox and WebKit browsers with a single API. Playwright delivers automation that is ever-green, capable, reliable and fast. See how Playwright is better.
Linux | macOS | Windows | |
---|---|---|---|
Chromium 90.0.4430.0 | ✅ | ✅ | ✅ |
WebKit 14.2 | ✅ | ✅ | ✅ |
Firefox 87.0b10 | ✅ | ✅ | ✅ |
Headless execution is supported for all browsers on all platforms.
Usage
pip install playwright
playwright install
This installs Playwright and browser binaries for Chromium, Firefox and WebKit. Playwright requires Python 3.7+.
Record and generate code
Playwright can record user interactions in a browser and generate code. See demo.
# Pass --help to see all options
playwright codegen
Playwright offers both sync (blocking) API and async API. They are identical in terms of capabilities and only differ in how one consumes the API.
Sync API
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.
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
for browser_type in [p.chromium, p.firefox, p.webkit]:
browser = browser_type.launch()
page = browser.new_page()
page.goto('http://whatsmyuseragent.org/')
page.screenshot(path=f'example-{browser_type.name}.png')
browser.close()
Async API
If you 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
$ python -m asyncio
import asyncio
from playwright.async_api import async_playwright
async def main():
async with async_playwright() as p:
for browser_type in [p.chromium, p.firefox, p.webkit]:
browser = await browser_type.launch()
page = await browser.new_page()
await page.goto('http://whatsmyuseragent.org/')
await page.screenshot(path=f'example-{browser_type.name}.png')
await browser.close()
asyncio.run(main())
With pytest
Use our pytest plugin for Playwright.
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")
Interactive mode (REPL)
Blocking REPL, as in CLI:
>>> from playwright.sync_api import sync_playwright
>>> playwright = sync_playwright().start()
# Use playwright.chromium, playwright.firefox or playwright.webkit
# Pass headless=False to see the browser UI
>>> 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:
$ python -m asyncio
>>> 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()
Examples
Mobile and geolocation
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()
Async variant
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.newPage()
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())
Evaluate JS in browser
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("""() => {
return {
width: document.documentElement.clientWidth,
height: document.documentElement.clientHeight,
deviceScaleFactor: window.devicePixelRatio
}
}""")
print(dimensions)
browser.close()
Async variant
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("""() => {
return {
width: document.documentElement.clientWidth,
height: document.documentElement.clientHeight,
deviceScaleFactor: window.devicePixelRatio
}
}""")
print(dimensions)
await browser.close()
asyncio.run(main())
Intercept network requests
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()
Async variant
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())
Documentation
Check out our new documentation site!
Is Playwright ready?
Yes, Playwright for Python is ready! The latest version of Playwright for Python is 1.8.0a. We are ready to drop the Alpha bit once we hear from you. Once it is gone, we will become semver compatible and the API will be frozen in its present form for years. We will still be adding features with every release, but we promise to not break it anymore!
Migration from the pre-release versions
The API has changed since the last 0.170.0 version:
-
Snake case notation for methods and arguments:
# old browser.newPage()
# new browser.new_page()
-
Import has changed to include sync vs async mode explicitly:
# old from playwright import sync_playwright
# new from playwright.sync_api import sync_playwright
That's about it! Our new doc site uses proper notation and examples for the new API.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distributions
Hashes for playwright-1.10.0-py3-none-win_amd64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3a2ae1173eb0844de995f8305106d1195f9cf86f7292bbeffd8feec8810a94dc |
|
MD5 | 5e4c697559ee67c1bb6f79dc816e2500 |
|
BLAKE2b-256 | 7c985d69a0633bfb0ab400626eb624ccbecb0c5f335cb49f66d9920059bbccec |
Hashes for playwright-1.10.0-py3-none-win32.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 67c28b654c1cc750f1831bdc20cc8036cd2a3420410e490bfd4015adff838ed8 |
|
MD5 | 3a384d0ff8db7c8f7710a79321da7828 |
|
BLAKE2b-256 | ff7e48f0dcc6986bef98ce722543e7bf4faf6a071be6de9f466333dd94307e3b |
Hashes for playwright-1.10.0-py3-none-manylinux1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 934e9c6ae6b2e8f8f71cbe30d3a702d16afd129fab30418351ce72c31b0c4ad0 |
|
MD5 | 3ca6c4d5967cf30f1209d0c78adeed25 |
|
BLAKE2b-256 | c688701ed9401839a8e773e5935a4d0fc3723ea4f5436a2c50a164cfd0a9c409 |
Hashes for playwright-1.10.0-py3-none-macosx_11_0_universal2.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | c2ec61af91b87294c2dd79313b2fc32b5b810e886d4450bac8e4f116e17fb75e |
|
MD5 | 217639b02261cf4f8ac0c0a147024b14 |
|
BLAKE2b-256 | 2fd20a76b361a4d66e35b48af9650a2712df017a2642751af4241ff4c76d97de |
Hashes for playwright-1.10.0-py3-none-macosx_10_13_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 554763ac930eb1a9173cfb2f158cda9f008619a82556f4da259171b96f8d3414 |
|
MD5 | aa8eea395abcafe6800a1d629912ab5f |
|
BLAKE2b-256 | 2164f0cfb683ab2acf4becb0b2b235690198e1085df61cb9b2a155e40ed5781d |