Browser automation

import asyncio
import boxlite

# Connecting to the in-sandbox browser from the host requires the pinned playwright client: pip install "playwright==1.58.0"
from playwright.async_api import async_playwright

async def main() -> None:
    # BrowserBox is an async context manager; entering sets up the browser environment inside the sandbox
    async with boxlite.BrowserBox() as browser_box:
        # Get the Playwright Server WebSocket endpoint (defaults to ws://localhost:3000/)
        ws_endpoint = await browser_box.playwright_endpoint()
        print(f"endpoint: {ws_endpoint}")

        async with async_playwright() as p:
            # Use connect() (not launch()) to attach to the browser inside the sandbox
            browser = await p.chromium.connect(ws_endpoint)
            try:
                page = await browser.new_page()
                await page.goto("https://example.com")
                print("title:", await page.title())
            finally:
                await browser.close()

if __name__ == "__main__":
    try:
        asyncio.run(main())
    except Exception as exc:  # Catch startup/connection/pull failures to avoid an unhandled crash
        print(f"BrowserBox failed: {type(exc).__name__}: {exc}")

import { BrowserBox } from "@boxlite-ai/boxlite";
import { chromium } from "playwright-core";

async function main(): Promise<void> {
  // Note: BrowserBox is created lazily; the browser only starts on the first endpoint method call
  const box = new BrowserBox({ browser: "chromium" });
  try {
    const wsEndpoint = await box.playwrightEndpoint();
    console.log(`endpoint: ${wsEndpoint}`);

    const browser = await chromium.connect(wsEndpoint);
    try {
      const page = await browser.newPage();
      await page.goto("https://example.com");
      console.log("title:", await page.title());
    } finally {
      await browser.close();
    }
  } catch (err) {
    console.error("BrowserBox failed:", err);
  } finally {
    // When not using `await using` for auto-cleanup, stop manually to release the box
    // (SimpleBox also implements Symbol.asyncDispose, so you may use `await using`)
    await box.stop();
  }
}

main();

import asyncio
import boxlite

async def main() -> None:
    # WebKit only works in Playwright Server mode; connect() wraps exactly that
    async with boxlite.BrowserBox(boxlite.BrowserBoxOptions(browser="webkit")) as box:
        browser = await box.connect()  # requires pip install "playwright==1.58.0"
        try:
            page = await browser.new_page()
            await page.goto("https://example.com")
            print("title:", await page.title())
        finally:
            await browser.close()

if __name__ == "__main__":
    try:
        asyncio.run(main())
    except Exception as exc:
        print(f"failed: {type(exc).__name__}: {exc}")

import asyncio
import boxlite
from playwright.async_api import async_playwright

async def main() -> None:
    async with boxlite.BrowserBox() as browser_box:
        ws_endpoint = await browser_box.playwright_endpoint()

        async with async_playwright() as p:
            browser = await p.chromium.connect(ws_endpoint)
            try:
                page = await browser.new_page()
                await page.set_viewport_size({"width": 1280, "height": 720})

                await page.goto("https://httpbin.org/forms/post")
                await page.fill('input[name="custname"]', "John Doe")
                await page.fill('input[name="custemail"]', "[email protected]")
                await page.check('input[value="medium"]')

                # Write the screenshot to a local host path (replace with your own path)
                await page.screenshot(path="<YOUR_PATH>/form.png")  # e.g. ./form.png
                print("screenshot saved")
            finally:
                await browser.close()

if __name__ == "__main__":
    try:
        asyncio.run(main())
    except Exception as exc:
        print(f"failed: {type(exc).__name__}: {exc}")

import asyncio
import boxlite
from playwright.async_api import async_playwright

async def run_one(browser_type: str, port: int) -> None:
    opts = boxlite.BrowserBoxOptions(browser=browser_type, port=port)
    async with boxlite.BrowserBox(opts) as box:
        ws = await box.playwright_endpoint()
        async with async_playwright() as p:
            launcher = getattr(p, browser_type)  # p.chromium / p.firefox / p.webkit (selected dynamically)
            browser = await launcher.connect(ws)
            try:
                page = await browser.new_page()
                await page.goto("https://example.com")
                print(f"{browser_type}: {await page.title()}")
            finally:
                await browser.close()

async def main() -> None:
    await asyncio.gather(
        run_one("chromium", 3000),
        run_one("firefox", 3001),
    )

if __name__ == "__main__":
    try:
        asyncio.run(main())
    except Exception as exc:
        print(f"failed: {type(exc).__name__}: {exc}")