Skip to main content

Documentation Index

Fetch the complete documentation index at: https://hyperbrowser.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Hyperbrowser’s browser instances can automatically block ads and trackers. This improves page load times and reduces detection risk. You can also block trackers and other annoyances like cookie notices.

​
Enable Ad Blocking

Set the appropriate options when creating a session: 
import { Hyperbrowser } from "@hyperbrowser/sdk";
import { config } from "dotenv";

config();

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

async function main() {
  const session = await client.sessions.create({
    adblock: true,
    trackers: true,
    annoyances: true,
    // You must have trackers set to true to enable blocking annoyances and adblock set to true to enable blocking trackers.
  });

  try {
    console.log("Session Live URL:", session.liveUrl);
    console.log("WS Endpoint:", session.wsEndpoint);
    // ... connect with Playwright/Puppeteer and automate
  } finally {
    await client.sessions.stop(session.id);
  }
}

main().catch(console.error);

​
Trackers and Annoyances

When enabled at session creation, Hyperbrowser can block many trackers and filter common annoyances such as cookie prompts and popups. 
await client.sessions.create({
  adblock: true,
  trackers: true,
  annoyances: true,
});
To enable trackers blocking, adblock must be enabled. To enable annoyance blocking, adblock and trackers must both be enabled.

​
Automatically Accept Cookies

Some site prompt users for cookies in a particularly intrusive way for scraping. If the acceptCookies param is set, then Hyperbrowser will automatically accept cookies on the browsers behalf. 
await client.sessions.create({
  acceptCookies: true,
});

​
Next Steps

Lifecycle Management

Manage session lifecycle

Profiles

Persist cookies and local storage

Static IPs

Use dedicated IP addresses

Recordings

Record and replay sessions