Stealth Mode

Stealth mode helps you avoid detection by anti-bot systems. It randomizes browser fingerprints and can be configured when creating a new session via the API. Options include:

Devices - Specify mobile or desktop device profiles
Locales - Set browser locale (e.g. en-US, fr-FR)
Operating Systems - Simulate different OSes like Android, iOS, Windows, macOS, Linux
Screen Size - Specify viewport dimensions to emulate different devices
User Agents - Rotate user agent strings

To enable stealth mode and other stealth configurations, you can set the desired options in the session creation params when creating a session.

import { connect } from "puppeteer-core";
import { Hyperbrowser } from "@hyperbrowser/sdk";
import { config } from "dotenv";

config();

const client = new Hyperbrowser({
  apiKey: process.env.HYPERBROWSER_API_KEY,
});

const main = async () => {
  const session = await client.sessions.create({
    useStealth: true,
    operatingSystems: ["macos"],
    device: ["desktop"],
    locales: ["en"],
    screen: {
      width: 1920,
      height: 1080,
    },
  });

  try {
    const browser = await connect({
      browserWSEndpoint: session.wsEndpoint,
      defaultViewport: null,
    });

    const [page] = await browser.pages();

    // Navigate to a website
    console.log("Navigating to Hacker News...");
    await page.goto("https://news.ycombinator.com/");
    const pageTitle = await page.title();
    console.log("Page 1:", pageTitle);
    await page.evaluate(() => {
      console.log("Page 1:", document.title);
    });
  } catch (err) {
    console.error(`Encountered error: ${err}`);
  } finally {
    await client.sessions.stop(session.id);
  }
};

main();

import { chromium } from "playwright-core";
import { Hyperbrowser } from "@hyperbrowser/sdk";
import { config } from "dotenv";

config();

const client = new Hyperbrowser({
  apiKey: process.env.HYPERBROWSER_API_KEY,
});

const main = async () => {
  const session = await client.sessions.create({
    useStealth: true,
    operatingSystems: ["macos"],
    device: ["desktop"],
    locales: ["en"],
    screen: {
      width: 1920,
      height: 1080,
    },
  });

  try {
    const browser = await chromium.connectOverCDP(session.wsEndpoint);

    const context = browser.contexts()[0];
    const page = await context.newPage();

    // Navigate to a website
    console.log("Navigating to Hacker News...");
    await page.goto("https://news.ycombinator.com/");
    const pageTitle = await page.title();
    console.log("Page 1:", pageTitle);
    await page.evaluate(() => {
      console.log("Page 1:", document.title);
    });
  } catch (err) {
    console.error(`Encountered error: ${err}`);
  } finally {
    await client.sessions.stop(session.id);
  }
};

main();

import asyncio
from pyppeteer import connect
import os
from dotenv import load_dotenv
from hyperbrowser import AsyncHyperbrowser
from hyperbrowser.models import CreateSessionParams, ScreenConfig

# Load environment variables from .env file
load_dotenv()

client = AsyncHyperbrowser(api_key=os.getenv("HYPERBROWSER_API_KEY"))


async def main():
    session = await client.sessions.create(
        params=CreateSessionParams(
            use_stealth=True,
            operating_systems=["macos"],
            device=["desktop"],
            locales=["en"],
            screen=ScreenConfig(width=1920, height=1080),
        )
    )

    try:
        browser = await connect(
            browserWSEndpoint=session.ws_endpoint, defaultViewport=None
        )

        pages = await browser.pages()
        page = pages[0]

        # Navigate to a website
        print("Navigating to Hacker News...")
        await page.goto("https://news.ycombinator.com/")
        page_title = await page.title()
        print("Page title:", page_title)
        await page.evaluate("() => { console.log('Page 1:', document.title); }")

    except Exception as e:
        print(f"Error: {e}")
    finally:
        await client.sessions.stop(session.id)


# Run the async main function
if __name__ == "__main__":
    asyncio.run(main())

import asyncio
from playwright.async_api import async_playwright
import os
from dotenv import load_dotenv
from hyperbrowser import AsyncHyperbrowser
from hyperbrowser.models import CreateSessionParams, ScreenConfig

# Load environment variables from .env file
load_dotenv()

client = AsyncHyperbrowser(api_key=os.getenv("HYPERBROWSER_API_KEY"))


async def main():
    session = await client.sessions.create(
        params=CreateSessionParams(
            use_stealth=True,
            operating_systems=["macos"],
            device=["desktop"],
            locales=["en"],
            screen=ScreenConfig(width=1920, height=1080),
        )
    )

    try:
        async with async_playwright() as p:
            browser = await p.chromium.connect_over_cdp(session.ws_endpoint)
            default_context = browser.contexts[0]
            page = await default_context.new_page()

            # Navigate to a website
            print("Navigating to Hacker News...")
            await page.goto("https://news.ycombinator.com/")
            page_title = await page.title()
            print("Page title:", page_title)
            await page.evaluate("() => { console.log('Page 1:', document.title); }")

    except Exception as e:
        print(f"Error: {e}")
    finally:
        await client.sessions.stop(session.id)


# Run the async main function
if __name__ == "__main__":
    asyncio.run(main())

PreviousAdvanced Privacy & Anti-Detection NextProxies

Last updated 1 month ago

import { connect } from "puppeteer-core"; import { Hyperbrowser } from "@hyperbrowser/sdk"; import { config } from "dotenv"; config(); const client = new Hyperbrowser({ apiKey: process.env.HYPERBROWSER_API_KEY, }); const main = async () => { const session = await client.sessions.create({ useStealth: true, operatingSystems: ["macos"], device: ["desktop"], locales: ["en"], screen: { width: 1920, height: 1080, }, }); try { const browser = await connect({ browserWSEndpoint: session.wsEndpoint, defaultViewport: null, }); const [page] = await browser.pages(); // Navigate to a website console.log("Navigating to Hacker News..."); await page.goto("https://news.ycombinator.com/"); const pageTitle = await page.title(); console.log("Page 1:", pageTitle); await page.evaluate(() => { console.log("Page 1:", document.title); }); } catch (err) { console.error(`Encountered error: ${err}`); } finally { await client.sessions.stop(session.id); } }; main();

import { chromium } from "playwright-core"; import { Hyperbrowser } from "@hyperbrowser/sdk"; import { config } from "dotenv"; config(); const client = new Hyperbrowser({ apiKey: process.env.HYPERBROWSER_API_KEY, }); const main = async () => { const session = await client.sessions.create({ useStealth: true, operatingSystems: ["macos"], device: ["desktop"], locales: ["en"], screen: { width: 1920, height: 1080, }, }); try { const browser = await chromium.connectOverCDP(session.wsEndpoint); const context = browser.contexts()[0]; const page = await context.newPage(); // Navigate to a website console.log("Navigating to Hacker News..."); await page.goto("https://news.ycombinator.com/"); const pageTitle = await page.title(); console.log("Page 1:", pageTitle); await page.evaluate(() => { console.log("Page 1:", document.title); }); } catch (err) { console.error(`Encountered error: ${err}`); } finally { await client.sessions.stop(session.id); } }; main();

import asyncio from pyppeteer import connect import os from dotenv import load_dotenv from hyperbrowser import AsyncHyperbrowser from hyperbrowser.models import CreateSessionParams, ScreenConfig # Load environment variables from .env file load_dotenv() client = AsyncHyperbrowser(api_key=os.getenv("HYPERBROWSER_API_KEY")) async def main(): session = await client.sessions.create( params=CreateSessionParams( use_stealth=True, operating_systems=["macos"], device=["desktop"], locales=["en"], screen=ScreenConfig(width=1920, height=1080), ) ) try: browser = await connect( browserWSEndpoint=session.ws_endpoint, defaultViewport=None ) pages = await browser.pages() page = pages[0] # Navigate to a website print("Navigating to Hacker News...") await page.goto("https://news.ycombinator.com/") page_title = await page.title() print("Page title:", page_title) await page.evaluate("() => { console.log('Page 1:', document.title); }") except Exception as e: print(f"Error: {e}") finally: await client.sessions.stop(session.id) # Run the async main function if __name__ == "__main__": asyncio.run(main())

import asyncio from playwright.async_api import async_playwright import os from dotenv import load_dotenv from hyperbrowser import AsyncHyperbrowser from hyperbrowser.models import CreateSessionParams, ScreenConfig # Load environment variables from .env file load_dotenv() client = AsyncHyperbrowser(api_key=os.getenv("HYPERBROWSER_API_KEY")) async def main(): session = await client.sessions.create( params=CreateSessionParams( use_stealth=True, operating_systems=["macos"], device=["desktop"], locales=["en"], screen=ScreenConfig(width=1920, height=1080), ) ) try: async with async_playwright() as p: browser = await p.chromium.connect_over_cdp(session.ws_endpoint) default_context = browser.contexts[0] page = await default_context.new_page() # Navigate to a website print("Navigating to Hacker News...") await page.goto("https://news.ycombinator.com/") page_title = await page.title() print("Page title:", page_title) await page.evaluate("() => { console.log('Page 1:', document.title); }") except Exception as e: print(f"Error: {e}") finally: await client.sessions.stop(session.id) # Run the async main function if __name__ == "__main__": asyncio.run(main())