Reading Pages

There are three ways to get data out of a tab: read the DOM as text, capture a screenshot, or have an AI agent extract structured data against a schema.

Page content

content() reads the tab's current title, URL, visible text, and links from the real DOM, including JavaScript-rendered content:

const { title, url, text, links } = await tab.content()console.log(title)console.log(text.slice(0, 200))for (const link of links ?? []) {  console.log(link.text, link.href)}

content = tab.content()print(content.title)print(content.text[:200])for link in content.links or []:    print(link.text, link.href)

Screenshots

screenshot() captures the tab as a PNG. It works headless, with no display needed. By default you get raw PNG bytes. Ask for base64 if you are passing the image on, for example to an LLM:

import { writeFile } from "node:fs/promises"// PNG bytes (Uint8Array)const png = await tab.screenshot({ fullPage: true })await writeFile("page.png", png)// Base64-encoded PNG stringconst b64 = await tab.screenshot({ type: "base64" })

# PNG bytespng = tab.screenshot(full_page=True)with open("page.png", "wb") as f:    f.write(png)# Base64-encoded PNG stringb64 = tab.screenshot(encoding="base64")

Pass fullPage: true to capture the entire scrollable page instead of just the viewport.

Structured extraction

extract() hands the page to a DOM-aware AI agent and returns data validated against your schema. The schema is a Zod object schema (v3 or v4) in TypeScript, and a pydantic model class or a raw JSON schema dict in Python:

import { z } from "zod"const article = await tab.extract(  "extract the article title and author",  z.object({    title: z.string(),    author: z.string(),  }),)console.log(article.title, article.author)

from pydantic import BaseModelclass Article(BaseModel):    title: str    author: strarticle = tab.extract(    "extract the article title and author",    Article,)print(article.title, article.author)

The result is parsed with your schema before it is returned, so a successful call always gives you data in the shape you asked for.