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.

Puppeteer is a popular Node.js library for browser automation that integrates seamlessly with Hyperbrowser sessions. This guide shows you how to connect Puppeteer to your cloud browsers. Python has an unofficial library called pyppeteer, however, it is unmaintained and is out of sync with the main Puppeteer library so we recommend using playwright-python instead.

​
Installation

npm install @hyperbrowser/sdk puppeteer-core dotenv
For Node.js, use puppeteer-core instead of puppeteer since Hyperbrowser provides the browser. This saves disk space and installation time.

​
Basic Connection

Connect Puppeteer to a Hyperbrowser session: 
import { Hyperbrowser } from "@hyperbrowser/sdk";
import { connect } from "puppeteer-core";
import { config } from "dotenv";

config();

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

async function main() {
  // Create session
  const session = await client.sessions.create();

  try {
    // Connect Puppeteer
    const browser = await connect({
      browserWSEndpoint: session.wsEndpoint,
      defaultViewport: null,
    });
    const defaultContext = browser.defaultBrowserContext();

    // Get or create a page
    const pages = await defaultContext.pages();
    const page = pages[0];

    // Navigate and interact
    await page.goto("https://example.com");
    console.log("Title:", await page.title());
  } catch (err) {
    console.error("Encountered error:", err);
  } finally {
    // Clean up
    await client.sessions.stop(session.id);
  }
}

main().catch(console.error);

​
Next Steps

Playwright Integration

Connect with Playwright

Session Lifecycle

Manage sessions

Stealth Mode

Configure anti-detection

Profiles

Persist browser state