Python API reference

Launch a Chromium or Firefox session and hold the handle every other call goes through. Every client call is synchronous, blocking gRPC underneath — there's no asyncio anywhere in the public API.

Page.locator(selector) returns a Locator scoped to a selector, which exposes the same action methods below plus the semantic builders and filters documented under Locator.

Every action and query method on Page (click, fill, hover, press, focus, highlight, count, text_content, inner_text, wait_for) is also available directly on a Locator, scoped to whatever it resolves to. What's below is what a Locator adds: building one semantically instead of by raw selector, and narrowing it once built.

A hook coordinates a browser-native event that fires asynchronously outside any direct call — a new tab, a native file picker, a download. register_hook before the triggering action, then wait for it, so the event can't be missed between the two.

Android automation over adb — no Appium, no separate driver server. Reached through the mobile singleton; iOS has no runtime yet.

allwright.config.yaml (or .json) drives browser choice, timeouts, and named profiles without writing it in code. Every client picks the file up the same way.