What it is
Playwright-Python is a Python library for automating web browsers. It enables end-to-end testing, web scraping, and browser automation across Chromium, Firefox, and WebKit with a single API.
Playwright allows you to launch browsers, navigate pages, interact with elements, capture screenshots, and evaluate JavaScript code. It supports synchronous and asynchronous APIs and provides robust mechanisms for waiting, network interception, and handling popups or frames.
Installation
pip install playwright
playwright installGetting started
The smallest useful thing you can do with it, and what each part means.
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch(headless=True)
page = browser.new_page()
page.goto('https://example.com')
page.screenshot(path='example.png')
browser.close()from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
page.goto('https://example.com')
page.click('text=More information')
browser.close()Advanced usage
Where the library earns its place over a simpler alternative.
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
page.goto('https://example.com/login')
page.fill('#username', 'myuser')
page.fill('#password', 'mypassword')
page.click('#login')
browser.close()page.goto('https://example.com')
page.wait_for_selector('#content')page.on('dialog', lambda dialog: dialog.accept())
page.click('#open-popup')content = page.inner_text('#main')
print(content)Errors and fixes
The failures you are most likely to hit, and what actually resolves them.
- TimeoutError
- Increase the timeout or ensure the element is correctly targeted and visible before interaction.
- PlaywrightError: No node found for selector
- Verify the selector is correct and matches an element on the page.
- BrowserError
- Ensure the browser binaries are installed with `playwright install` and the environment supports GUI if headless=False.
Best practices
- Use synchronous API for simple scripts and asynchronous API for large-scale automation.
- Prefer headless mode for faster execution unless debugging.
- Leverage selectors efficiently to avoid brittle scripts.
- Wait explicitly for elements or network events to ensure reliability.
- Organize automation scripts into reusable functions or classes for maintainability.
Background
Why it exists, and what it was reacting to.
Playwright was developed by Microsoft to provide a reliable and fast automation library for testing modern web applications. The Python bindings allow developers to use Playwright's cross-browser capabilities, including headless and headful modes, to automate interactions with web pages.