act() Method

await stagehand.act(instruction, options?);
await stagehand.act(action, options?);

import { Stagehand } from "@browserbasehq/stagehand";

const stagehand = new Stagehand({ env: "LOCAL" });
await stagehand.init();

const page = await stagehand.context.newPage();
await page.goto("https://example.com");

// Click an element
await stagehand.act("click the login button");

// Fill a form field
await stagehand.act("type 'user@example.com' in the email field");

// Select from dropdown
await stagehand.act("select 'United States' from the country dropdown");

// Check a checkbox
await stagehand.act("check the 'Remember me' checkbox");

await stagehand.close();

const credentials = {
  email: "user@example.com",
  password: { value: "secret123", description: "Account password" },
};

// Use variables in instruction
await stagehand.act("type %email% in the email field", {
  variables: credentials,
});

await stagehand.act("type %password% in the password field", {
  variables: credentials,
});

await stagehand.act("click the submit button");

// Find elements first
const actions = await stagehand.observe("buttons on the page");

if (actions.length > 0) {
  // Perform action on the first button
  const result = await stagehand.act(actions[0]);
  console.log(result.message);
}

// Use a different model for this action
await stagehand.act("click the submit button", {
  model: "anthropic/claude-3-5-sonnet-latest",
});

// Or with client options
await stagehand.act("fill in the form", {
  model: {
    modelName: "openai/gpt-4o",
    temperature: 0.5,
  },
});

try {
  await stagehand.act("wait for the loading spinner to disappear", {
    timeout: 5000, // 5 seconds
  });
} catch (error) {
  console.error("Action timed out");
}

const page1 = await stagehand.context.newPage();
await page1.goto("https://example.com");

const page2 = await stagehand.context.newPage();
await page2.goto("https://another-site.com");

// Perform action on specific page
await stagehand.act("click the login button", { page: page1 });
await stagehand.act("fill in the search box", { page: page2 });

await stagehand.act("click the submit button");
await stagehand.act("click the first item in the list");
await stagehand.act("double click the file icon");

await stagehand.act("type 'hello world' in the search box");
await stagehand.act("clear the text field and type 'new value'");
await stagehand.act("press Enter in the input field");

await stagehand.act("check the 'I agree' checkbox");
await stagehand.act("uncheck the 'Subscribe' checkbox");
await stagehand.act("select 'Option 2' from the dropdown");
await stagehand.act("upload a file to the file input");

await stagehand.act("scroll to the bottom of the page");
await stagehand.act("scroll to the 'Contact Us' section");
await stagehand.act("click the 'Next Page' button");

const result = await stagehand.act("click the submit button");

if (!result.success) {
  console.error("Action failed:", result.message);
  // Handle failure
} else {
  console.log("Action succeeded:", result.actionDescription);
}