βοΈ Playwright vs. Selenium: Architecture & Paradigm Shift
For nearly two decades, Selenium WebDriver has been the standard for browser automation using the W3C WebDriver JSON Wire Protocol. However, modern Single Page Applications (SPAs) require direct access to real-time events, network routes, and isolated contexts. Playwright redesigns this paradigm from the ground up: replacing stateless, high-latency HTTP request-response polling with a single persistent bidirectional WebSocket connection, integrated auto-waiting across actionability checks, zero-overhead browser contexts, and out-of-the-box network interception.
SELENIUM ARCHITECTURE (HTTP Polling via W3C WebDriver):
[ Python Code ] ββHTTP POST (Port 9515)βββΊ [ chromedriver.exe ] ββCDP/DebugβββΊ [ Chrome Browser ]
* High round-trip latency (~15-40ms per interaction)
* Separate OS process for each test browser instance
* No native awareness of client-side DOM render loops
PLAYWRIGHT ARCHITECTURE (Single Persistent WebSocket Connection):
[ Python Code ] ββFast IPC Pipes (Stdio)βββΊ [ Playwright Driver ] ββWebSocketβββΊ [ Browser Process ]
β
βββββββββββββββββββββββββββββββ΄ββββββββββββββββββββββββββββββ
βΌ βΌ
[ BrowserContext 1 ] [ BrowserContext 2 ]
(Isolated Incognito) (Isolated Incognito)
NoSuchElementException or StaleElementReferenceException unless verbose explicit waits are configured. Playwright performs actionability checks (visible, stable, enabled, editable) automatically before acting.
# ---------------------------------------------------------
# APPROACH A: Selenium WebDriver (Requires Manual WebDriverWait)
# ---------------------------------------------------------
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
driver = webdriver.Chrome()
driver.get("https://demo.playwright.dev/todomvc/")
# Must wrap every element in explicit condition checking to avoid race conditions
wait = WebDriverWait(driver, timeout=10)
input_field = wait.until(EC.element_to_be_clickable((By.CSS_SELECTOR, ".new-todo")))
input_field.send_keys("Buy Groceries\n")
item = wait.until(EC.visibility_of_element_located((By.XPATH, "//label[text()='Buy Groceries']")))
print("Selenium verified text:", item.text)
driver.quit()
# ---------------------------------------------------------
# APPROACH B: Playwright (Built-in Web-First Auto-Waiting)
# ---------------------------------------------------------
from playwright.sync_api import sync_playwright, expect
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
page.goto("https://demo.playwright.dev/todomvc/")
# Playwright auto-waits for input to be attached, visible, and stable
page.get_by_placeholder("What needs to be done?").fill("Buy Groceries")
page.get_by_placeholder("What needs to be done?").press("Enter")
# Built-in auto-retry assertion
expect(page.get_by_text("Buy Groceries")).to_be_visible()
print("Playwright verified text automatically without explicit wait loops!")
browser.close()
BrowserContext profiles (consuming ~15MB each).
from playwright.sync_api import sync_playwright
import time
with sync_playwright() as p:
browser = p.chromium.launch(headless=True)
start_time = time.time()
# Create 3 isolated user contexts in ONE browser process (Admin, Seller, Buyer)
contexts = [browser.new_context() for _ in range(3)]
pages = [ctx.new_page() for ctx in contexts]
for idx, page in enumerate(pages, 1):
page.goto("https://example.com")
print(f"Context {idx} loaded: '{page.title()}' (Completely independent cookies & storage)")
for ctx in contexts:
ctx.close()
elapsed = time.time() - start_time
print(f"Total time to initialize and close 3 isolated sessions: {elapsed:.2f}s")
browser.close()
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
# Intercept API route and return a mock JSON payload without touching backend servers
def handle_route(route):
route.fulfill(
status=200,
content_type="application/json",
body='{"user": "Admin", "permissions": ["ALL"], "mocked": true}'
)
# Route interception pattern
page.route("**/api/user/profile", handle_route)
# Simulate triggering an API call via fetch inside page
page.goto("https://example.com")
result = page.evaluate("""async () => {
const response = await fetch('/api/user/profile');
return await response.json();
}""")
print("Mocked Network Response Received in Browser Context:")
print(" ", result)
browser.close()
driver.switch_to.frame and default_content). Playwright uses direct, composable frame_locator selectors seamlessly.
# ---------------------------------------------------------
# SELENIUM WAY: Manual switching context (Fragile)
# ---------------------------------------------------------
# driver.switch_to.frame("payment-iframe")
# driver.find_element(By.ID, "card-number").send_keys("4242424242424242")
# driver.switch_to.default_content() # Must remember to switch back!
# ---------------------------------------------------------
# PLAYWRIGHT WAY: Composable frame locator (Thread-safe & Clean)
# ---------------------------------------------------------
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
# Set up simulated HTML containing an iframe
page.set_content("""
Checkout Page
""")
# Interact directly with element inside iframe without context switching
frame = page.frame_locator("#payment-frame")
button_text = frame.locator("#pay-btn").inner_text()
print(f"Inside iframe element text: '{button_text}'")
# Immediate interaction with parent document without calling default_content()
print(f"Parent heading text: '{page.locator('h1').inner_text()}'")
browser.close()
getShadowRoot) to access elements encapsulated within open shadow roots. Playwright pierces Shadow DOM automatically across all locator queries.
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
# Page with custom Web Component encapsulating a Shadow Root
page.set_content("""
Main Page
""")
# Playwright locators automatically pierce shadow boundaries by default!
shadow_button = page.locator("#shadow-btn")
print(f"Found Shadow DOM element directly: '{shadow_button.inner_text()}'")
browser.close()
import tempfile
import os
from playwright.sync_api import sync_playwright
storage_file = os.path.join(tempfile.gettempdir(), "auth_state.json")
with sync_playwright() as p:
browser = p.chromium.launch()
# Step 1: Log in once and save authentication state to file
context = browser.new_context()
page = context.new_page()
page.goto("https://demo.playwright.dev/todomvc/")
# Store session state (cookies, localStorage, session tokens)
context.storage_state(path=storage_file)
context.close()
print(f"Authentication snapshot saved to: {storage_file}")
# Step 2: Launch a new test context pre-authenticated instantly!
authed_context = browser.new_context(storage_state=storage_file)
new_page = authed_context.new_page()
new_page.goto("https://demo.playwright.dev/todomvc/")
print("New session created pre-authenticated in under 10ms without performing UI login!")
browser.close()
display: none). Playwright uses direct event listeners and set_input_files that bind even to custom styled drop-zones.
import tempfile
import os
from playwright.sync_api import sync_playwright
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
# Mock page with a file input
page.set_content('')
# Create dummy files for testing
file1 = os.path.join(tempfile.gettempdir(), "test_report.csv")
with open(file1, "w") as f: f.write("id,status\n1,success")
# Set single or multiple files directly
page.set_input_files("#upload-doc", file1)
uploaded_files_count = page.evaluate("document.getElementById('upload-doc').files.length")
print(f"Files successfully attached to input: {uploaded_files_count}")
# Reset input
page.set_input_files("#upload-doc", [])
print("Files cleared cleanly.")
browser.close()
# Playwright captures execution traces into a single portable zip archive
context.tracing.start(screenshots=True, snapshots=True, sources=True)
# ... actions ...
context.tracing.stop(path="trace.zip")
# Open trace viewer with a single command:
# $ playwright show-trace trace.zip
CAPABILITIES COMPARISON MATRIX:
ββββββββββββββββββββββββββββββββ¬βββββββββββββββββββββββββ¬βββββββββββββββββββββββββ
β Capability β Selenium WebDriver β Playwright for Python β
ββββββββββββββββββββββββββββββββΌβββββββββββββββββββββββββΌβββββββββββββββββββββββββ€
β Communication Protocol β HTTP REST (W3C JSON) β Bidirectional WebSocketβ
β Built-in Auto-Waiting β β Manual (WebDriverWait)β β Native Automatic β
β Context Isolation Speed β Slow (New Browser Proc)β Sub-millisecond Contextβ
β Network Request Mocking β β Limited / Third-partyβ β First-Class Native β
β Shadow DOM Automation β β Requires JavaScript β β Automatic Piercing β
β Code Generation Tool β β (Selenium IDE plugin)β β Built-in CLI codegen β
β DOM Time-Travel Debugging β β Static Screenshots β β Interactive Traces β
β Multi-Tab / Frame Handling β Complex window switchesβ Composable Page/Frame β
ββββββββββββββββββββββββββββββββ΄βββββββββββββββββββββββββ΄βββββββββββββββββββββββββ
# =========================================================
# OLD SELENIUM IMPLEMENTATION (12 Lines)
# =========================================================
from selenium import webdriver
from selenium.webdriver.common.by import By
from selenium.webdriver.support.ui import WebDriverWait
from selenium.webdriver.support import expected_conditions as EC
driver = webdriver.Chrome()
driver.get("https://example.com")
wait = WebDriverWait(driver, 10)
header_el = wait.until(EC.visibility_of_element_located((By.TAG_NAME, "h1")))
assert header_el.text == "Example Domain"
driver.quit()
# =========================================================
# NEW PLAYWRIGHT REFACTOR (6 Lines)
# =========================================================
from playwright.sync_api import sync_playwright, expect
with sync_playwright() as p:
browser = p.chromium.launch()
page = browser.new_page()
page.goto("https://example.com")
# Clean, concise, and automatically waited
expect(page.locator("h1")).to_have_text("Example Domain")
print("Refactored Playwright test passed with cleaner syntax!")
browser.close()