Automation (webdriver) flag
True when the browser is being driven by Selenium, Playwright, Puppeteer or similar.
In one line
Can tell if Selenium, Playwright, or Puppeteer is controlling the browser
True when the browser is being driven by Selenium, Playwright, Puppeteer or similar.
Tells a site a script, not a person, may be on the page. Bot defenses use it with other tells (missing plugins, headless UA) to block or challenge scrapers and agents.
What it can and can't do
What the user does: Nothing. It happens when the page loads
It can
- Check whether the browser says it is automated
- Combine it with other clues like a headless label
- Block, slow, or challenge likely scrapers and AI agents
It cannot
- Be sure; bot makers can hide the flag
- See what the script is doing
- Tell a good script from a bad one
- Show true when you browse by hand
Browser support
| Browser | Status | First version | Released | Note |
|---|---|---|---|---|
| Chrome | Supported | 63 | 2017-12-06 | None |
| Edge | Supported | 12 | 2015-07-29 | None |
| Firefox | Supported | 60 | 2018-05-09 | None |
| Safari | Supported | 10.1 | 2017-03-27 | None |
| Safari on iPhone | Supported | 10.3 | 2017-03-27 | None |
| Chrome on Android | Supported | 63 | 2017-12-05 | None |
| Samsung Internet | Supported | 8.0 | 2018-07-18 | None |
How a site asks for it
| API | navigator.webdriver |
| Browser compat keys | api.Navigator.webdriver |
| How access is granted | none |
| What the user sees | None |
| Needs a secure context (HTTPS) | No |
| Needs a user gesture | No |
| How long it lasts | read fresh on every page load; nothing stored |
| How to take it back | none needed (no grant) |
| Inside an iframe | Readable from cross-origin iframes too (same values) |
Typical flow
- Page script reads the value
- No prompt is shown
Data you get
Shape: object
How often: static per session
| Field | Type | Unit | Range | Precision |
|---|---|---|---|---|
webdriver | boolean | None | true when under WebDriver control | Not listed |
Technical limits
- Trivially spoofed by stealth plugins
- Does not identify who runs the automation
The story
What it is
A simple true or false that says a script, not a person, is driving the browser.
For you
You never see it. In an ordinary browser it says false and nothing changes. If you run an automation tool, some sites will challenge you.
For makers
It is the cheapest bot test: one line of code. Defences use it with other tells like missing plugins and headless user agents. It catches lazy scrapers but not skilled ones.
Where you see it
| Type | Example | Apps |
|---|---|---|
| security | A web firewall serves a challenge page to clients with the flag set. | Cloudflare |
| shopping | A concert ticket seller blocks scalper scripts that run in automated browsers. | Ticketmaster |
| games | A multiplayer browser game bans automation that plays for you. | None named |
| ads | An ad network refuses to count ad views from automated browsers. | None named |
| analytics | A traffic tool removes automated visits so your numbers are cleaner. | Google Analytics |
| developer | A QA engineer sees the flag in a test run and sets sites to test mode. | Puppeteer |
| travel | A flight site stops fare scraping bots by challenging automated browsers. | None named |
Risks
- Blocks useful automation
- Easy to hide
What the platform says
- MDN: Navigator.webdriver. Docs say this flag is true when the browser is controlled by WebDriver automation.
Good uses and abuse
Legitimate uses
- Bot defense
- Fraud scoring
Known abuse
- Blocking legitimate agents
Scores
| Score | Value | Meaning |
|---|---|---|
| Sensitivity | 1 of 5 | How revealing the data is |
| Utility | 4 of 5 | How useful it is to honest apps |
| Friction | 0 of 5 | How much the user has to do |
| Fingerprint bits | 0.1 | Rough identifying entropy, when known |
A real example: LinkedIn
Collected as automation flag and framework detection. Read by the LinkedIn APFC fingerprint script (48 features, alleged by BrowserGate, partly confirmed by BleepingComputer).
Sources
How well checked: Based on official documentation.