Advanced Stealth Customization

Customize Advanced Stealth with OS configurations

Browserbase’s Advanced Stealth Mode is a real browser and has real browser fingerprints that provide significantly higher success rates than randomly generated configurations. This guide shows you how to customize OS settings for optimal results.

Customization Options

Advanced Stealth Mode offers two configuration options:

1. Default: Automatically configured with a standard desktop fingerprint

   • For general automation use

2. OS Selection: Choose your OS (Linux, Windows, Mac, Mobile, Tablet)

   • Changes the user agent and browser environment to match the selected platform

Operating System Configuration

Specify the operating system to change the browser’s user agent and environment signals.

Node.js

SDK

import Browserbase from "@browserbasehq/sdk";

const bb = new Browserbase({apiKey: process.env.BROWSERBASE_API_KEY!});

const session = await bb.sessions.create({
  projectId: process.env.BROWSERBASE_PROJECT_ID!,
  browserSettings: {
    advancedStealth: true,
    os: "mac",
  },
  proxies: true,
});

Python

SDK

from browserbase import Browserbase
import os

bb = Browserbase(api_key=os.environ["BROWSERBASE_API_KEY"])

session = bb.sessions.create(
    project_id=os.environ["BROWSERBASE_PROJECT_ID"],
    browser_settings={
        "advanced_stealth": True,
        "os": "mac",
    },
    proxies=True,
)

When using contexts, changing the OS could reduce the success rate of your automation.

OS Viewports

OS	Viewport	Use Case
linux	1280x720	Desktop automation with Linux environment
windows	1280x720	Windows-specific testing
mac	1280x720	macOS automation
mobile	384x696	Mobile app testing
tablet	800x1200	Tablet responsive testing

Desktop platforms (Linux, Windows, Mac) all use a standardized viewport with a complete, pre-made fingerprint profile. Viewport customization is not available for Advanced Stealth sessions — this ensures the highest possible success rates against bot detection.

Viewport dimensions listed above are approximate and may change at any time as Browserbase optimizes fingerprint profiles for improved detection avoidance. Do not rely on specific viewport values in your automation logic.

If your use case requires a specific custom viewport, disable Advanced Stealth (advancedStealth: false) and configure the viewport directly. See the Viewports guide for configuration details.

Error Handling & Validation

Scenario	Result	Details
advancedStealth: false + OS	Error	Cannot use OS without Advanced Stealth
Invalid OS value	Error	os: "android" (not supported)
No OS specified	Default profile	Falls back to the default desktop fingerprint

Best Practices

Operating System Selection

• Match Target Environment: Choose an OS that aligns with your use case. For example, use windows when automating Windows-specific sites or testing Windows-only features.
• Default for General Use: For most automation tasks, simply enable advancedStealth: true without specifying an OS. The default profile is optimized for the highest success rates.

Mobile & Tablet Testing

• Dedicated Viewports: Use mobile or tablet OS values for testing responsive designs and mobile-specific features. These platforms use their own dedicated viewport sizes (384x696 for mobile, 800x1200 for tablet).

Maximizing Success Rate

• Maintain Profile Integrity: Avoid modifying viewport dimensions or user agent strings through automation frameworks like Playwright. Our pre-made fingerprints are carefully crafted to work together as complete profiles.
• Enable Proxies: Always pair Advanced Stealth Mode with our proxy infrastructure for optimal bot detection avoidance. The combination provides the highest success rates.

Implementation Tips

• Monitor Success: Track your automation success rates and adjust OS selections if you notice decreased performance on specific sites.

This feature is currently in beta; if you have any feedback, please reach out to [e-mail].