Instrument reference
Session & environment instruments
Browser environment settings, mouse movement and custom headers.
Use them responsibly: they exist for testing your own sites and automating flows you're entitled to automate โ respect the terms of the sites you work with.
These instruments control the environment a flow runs in: the browser properties a page can read, how the pointer moves, and the headers each request carries. They pair with the ๐ฒ human-delay toggle, which adds random pauses between steps.
Stealth#
Normalizes the browser properties that identify an automated session, before the page loads:
navigator.webdriveris hidden; Playwright's own markers are removed.- Plugins, languages, platform, vendor, hardware concurrency and device memory report browser-typical values.
- The WebGL vendor and renderer are overridden (configurable).
- Optionally, a custom user agent and timezone.
Place it early โ ideally the first step, before any Navigate. Some sites will still identify the session as automated regardless of these settings.
Set Headers#
Sets extra HTTP headers on every request the browser session makes from then on โ a JSON object:
{ "Accept-Language": "en-US,en;q=0.9" }
Useful for language pinning, custom User-Agent strings, or API keys a site expects. For a single request, use Fetch with its own headers instead.
Move Mouse#
Moves the pointer like a person would:
- With a selector โ hover over that element (triggers hover menus, tooltips, lazy-loading).
- With X / Y coordinates โ move to a viewport position.
Also the honest way to open hover-only menus before clicking something inside them.