Playwright

Setup a browser session with Playwright.

1

Install Playwright and Hyperbrowser

npm install playwright-core @hyperbrowser/sdk

or

yarn add playwright-core @hyperbrowser/sdk
2

Setup your Environment

To use Hyperbrowser with your code, you will need an API Key. You can get one easily from the dashboard. Once you have your API Key, add it to your .env file as HYPERBROWSER_API_KEY .

3

Setup Browser Session

Next, you can easily startup a browser session using playwright and your Hyperbrowser API Key.

import { chromium } from "playwright-core";
import { config } from "dotenv";

config();

const main = async () => {
  // Connect to browser using Playwright
  const browser = await chromium.connectOverCDP(
    `wss://connect.hyperbrowser.ai?apiKey=${process.env.HYPERBROWSER_API_KEY}`
  );

  // Create a new context and page
  const defaultContext = browser.contexts()[0];
  const page = defaultContext.pages()[0];

  // 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);
  });

  await page.goto("https://example.com");
  console.log("Page 2:", await page.title());
  await page.evaluate(() => {
    console.log("Page 2:", document.title);
  });

  await page.goto("https://apple.com");
  console.log("Page 3:", await page.title());
  await page.evaluate(() => {
    console.log("Page 3:", document.title);
  });

  await page.goto("https://google.com");
  console.log("Page 4:", await page.title());
  await page.evaluate(() => {
    console.log("Page 4:", document.title);
  });

  // Clean up
  await page.close();
  await defaultContext.close();
  await browser.close();
};

main();
4

View Session in Dashboard

You can view all your sessions in the dashboard and see their recordings or other key metrics like logs.

Last updated

Logo

© 2025 S2 Labs, Inc. All rights reserved.