Stealth Mode

​

Overview

Stealth mode provides developers with a robust set of tools for automating web tasks while staying under the radar of advanced anti-bot systems. Browserbase’s custom-built Chromium Browser comes with a set of features enabling you to navigate in Stealth mode.

By using proxies, residential IPs, and fingerprinting, developers can mimic real user behavior across different sessions and IPs.

This mode is useful for things like data scraping, automated testing, and content aggregation in environments with strict bot detection.

​

Basic Stealth

​

Fingerprinting

The fingerprint mechanism handles the viewport, user agents, and headers and can be configured when creating a new Session through the API with the fingerprint field:

• Node.js
• Python

These include changing the HTTP version, browser type, device type, locale, operating system, screen viewport size, and other fingerprinting details.

For a complete list of available options when creating a session, please refer to our API documentation on creating a session.

​

Captcha Solving

Captchas get automatically detected and solved. Proxies must be enabled to turn on captcha solving.

You can detect if a captcha is being solved by listening to the browserbase-solving-started and browserbase-solving-finished events in the console.log of the page.

• Node.js
• Python

Captcha solving can take up to 30 seconds.

If you’d like to disable captcha solving, you can set solveCaptchas to false in the browserSettings when creating a session.

curl -X POST 'https://api.browserbase.com/v1/sessions' \
-H "Content-Type: application/json" \
-H "x-bb-api-key: $BROWSERBASE_API_KEY" \
-d '{
  "projectId": "'$BROWSERBASE_PROJECT_ID'",
  "browserSettings": {
    "solveCaptchas": false
  }
};

​

Custom Captcha Solving

If you encounter a custom captcha provider, you need to specify the explicit selector for the captcha image and button itself.

For this custom captcha provider, you’ll need to specify two CSS selectors:

1. The selector for the captcha image element

1. The selector for the input field where the solution should be entered

You can find these selectors by:

1. Right-clicking on the captcha image and selecting “Inspect”

2. Right-clicking on the input field and selecting “Inspect”

Then configure your browser settings with these selectors:

browserSettings: {
captchaImageSelector: "#imageSelectorHere",
captchaInputSelector: "#inputSelectorHere"
}

​

Advanced Stealth

While Basic Stealth automatically detects and solves Captchas, Advanced Stealth uses more sophisticated techniques to improve performance against common anti-bot systems.

Primarily, Advanced Stealth reduces the chances of being flagged as a bot by using a custom version of the Chrome browser, built and maintained by the Browserbase Stealth Team.

To enable:

• Node.js
• Python

{
    projectId: BROWSERBASE_PROJECT_ID,
    browserSettings: {
        advancedStealth: true,
    },
    proxies:  true,
}

With Advanced Stealth, we handle fingerprinting for you so any custom fingerprint configuration will have no effect.

Proxies are still very important for reliable browsing, and it’s recommended to enable them alongside Advanced Stealth.

Please note, this feature is currently in beta; if you have any feedback, please reach out to support@browserbase.com.