Advanced Stealth Customization

​

Customization Options

1. Default: Windows OS with 2560x1440 viewport
   • For general automation use
2. OS Only: Choose your OS (Linux, Windows, Mac)
   • Viewport size automatically optimized
3. OS and Viewport: Specify both OS and viewport
   • For exact fingerprint control

​

Operating System Configuration

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", // Auto-defaults to 2560x1440
  },
  proxies: true,
});

​

OS Default Viewports

​

Custom Viewport Configuration

const session = await bb.sessions.create({
  projectId: process.env.BROWSERBASE_PROJECT_ID!,
  browserSettings: {
    advancedStealth: true,
    os: "windows",
    viewport: { 
      width: 1920, 
      height: 1080,
    },
  },
  proxies: true,
});

​

Supported Viewport Combinations

​

Error Handling & Validation

​

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 OS Settings: For general automation, specify only the os parameter and let the system select optimal viewport defaults. This simplifies configuration while maintaining high success rates.

​

Viewport Configuration

• Precise Dimensions: When pixel-perfect matching is required (e.g., UI testing), configure both os and viewport using the supported combinations listed above.
• Mobile & Tablet Testing: Use mobile or tablet OS values with their corresponding viewports for testing responsive designs and mobile-specific features.

​

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

• Validate Configurations: Implement proper error handling for invalid OS/viewport combinations to ensure graceful fallbacks in your automation scripts.
• Monitor Success: Track your automation success rates and adjust OS/viewport combinations if you notice decreased performance on specific sites.