Expand description
DataDome anti-bot bypass for zendriver.
This crate is a sibling to zendriver-cloudflare and zendriver-imperva.
It detects which DataDome surface a tab is currently showing, observes the
page until the datadome clearance cookie lands (on device-check surfaces
the invisible JS interrogation resolves on its own), and escalates a CAPTCHA
surface (slider / puzzle / press-hold) to a caller-supplied solver callback.
§Limitations
A successful clearance means the datadome cookie landed in the browser —
it does not guarantee every subsequent request will be accepted.
DataDome runs an invisible device-check that scores the fingerprint the
browser emitted during the interstitial. If that score falls below
threshold the next request returns a fresh challenge regardless of the
cookie value.
The most common root cause of a repeated challenge after apparent clearance
is the WebGL / WebGPU fingerprint leak (issue #20): an un-shimmed
UNMASKED_RENDERER_WEBGL extension string or GPUAdapterInfo.device field
exposes the real GPU and flags the session as a headless browser.
Run with BrowserBuilder::stealth enabled to minimize fingerprint
surface. Without stealth the bypass will succeed locally but fail on
real DataDome-protected sites under scoring.
Re-exports§
pub use bypass::ClearanceOutcome;pub use bypass::DataDomeBypass;pub use captcha::DataDomeChallenge;pub use captcha::DataDomeSolution;pub use detection::DataDomeSurface;pub use detection::DdConfig;pub use detection::DetectionSnapshot;pub use detection::detect_surface;pub use error::DataDomeError;
Modules§
- bypass
- DataDome bypass driver.
- captcha
- CAPTCHA escalation: types handed to / returned from the caller-supplied
solver, plus the CDP helpers that build the challenge descriptor and apply
the solved
datadomecookie. DataDome’s solution is a COOKIE (it whitelists the browser), not a form-field token — the structural delta from imperva. - detection
- DataDome surface detection. One
Runtime.evaluateround-trip bundles the cookie read,window.ddparse, and captcha-delivery iframe walk. - error
- DataDome-bypass errors.