page.extract()

import { HyperAgent } from "@hyperbrowser/agent";
import { z } from "zod";

const agent = new HyperAgent();
const page = await agent.newPage();
await page.goto("https://news.ycombinator.com");

// Simple extraction (returns string)
const topStory = await page.extract("what is the title of the top story?");
console.log(topStory); // "Show HN: I built a..."

// Structured extraction (returns typed object)
const stories = await page.extract(
  "get the top 5 stories",
  z.object({
    stories: z.array(z.object({
      title: z.string(),
      points: z.number(),
      author: z.string(),
    }))
  })
);

console.log(stories.stories[0].title);

const productSchema = z.object({
  name: z.string().describe("The product name"),
  price: z.number().describe("Price in USD, numbers only"),
  inStock: z.boolean().describe("Whether the item is available"),
  reviews: z.array(z.object({
    rating: z.number().min(1).max(5),
    text: z.string(),
  })).describe("Customer reviews"),
});

const product = await page.extract("get this product's details", productSchema);
// product is fully typed: { name: string, price: number, inStock: boolean, reviews: [...] }

const product = await page.extract(
  "extract the product details",
  z.object({
    name: z.string(),
    price: z.number(),
    originalPrice: z.number().optional(),
    rating: z.number(),
    reviewCount: z.number(),
    availability: z.enum(["in_stock", "out_of_stock", "limited"]),
  })
);

const tableData = await page.extract(
  "extract all rows from the pricing table",
  z.object({
    rows: z.array(z.object({
      plan: z.string(),
      price: z.string(),
      features: z.array(z.string()),
    }))
  })
);

const article = await page.extract(
  "extract the article content",
  z.object({
    title: z.string(),
    author: z.string(),
    publishDate: z.string(),
    content: z.string(),
    tags: z.array(z.string()),
  })
);

const rankings = await page.extract(
  "get the top 10 items from this list",
  z.object({
    items: z.array(z.object({
      rank: z.number(),
      name: z.string(),
      score: z.number().optional(),
    }))
  })
);

try {
  const data = await page.extract("get the user profile", schema);
} catch (error) {
  if (error.message.includes("validation")) {
    console.error("Data didn't match schema:", error);
  } else {
    console.error("Extraction failed:", error);
  }
}