Act

await page.act("click on add to cart");

await page.act("click on add to cart")

act() allows Stagehand to interact with a web page. Provide an action like "Click on the add to cart button", or "Type 'Browserbase' into the search bar". You can define variables that will not be shared with LLM providers

await page.act({
  action: "fill in the form with %username% and %password%",
  variables: {
    username: "john.doe",
    password: "secretpass123",
  },
});

await page.act({
  "fill in the form with %username% and %password%",
  variables={
    "username": "john.doe",
    "password": "secretpass123",
  },
})

Small atomic goals perform the best. Avoid using act() to perform complex actions. For multi-step actions, use Agent instead

You can pass an ObserveResult to act() to perform the suggested action, which will yield a faster and cheaper result (no LLM inference).

Arguments: `ActOptions` | `ObserveResult`

TypeScript
Python

ActOptions:

string

required

Describes the action to perform

AvailableModel

Specifies the model to use

object

Configuration options for the model client

Record<string, string>

Variables to use in the action. Variables in the action string are referenced using %variable_name%

boolean

Set iframes: true if the target element exists within an iframe

number

Timeout in milliseconds for waiting for the DOM to settle

number

Timeout in milliseconds for the action being performed.

ObserveResult:

string

required

A string representing the element selector

string

required

A string describing the possible action

string

required

The method to call on the element

object

required

The arguments to pass to the method

ActOptions:

string

required

Describes the action to perform

string

Specifies the model to use

dict

Configuration options for the model client

dict

Variables to use in the action. Variables in the action string are referenced using %variable_name%

int

Timeout in milliseconds for waiting for the DOM to settle

int

Timeout in milliseconds for the action being performed.

ObserveResult:

string

required

A string representing the element selector

string

required

A string describing the possible action

string

required

The method to call on the element

object

required

The arguments to pass to the method

Returns: `Promise<ActResult>`

boolean

required

If the action was completed successfully

string

required

Details about the action’s execution

string

required

The action performed

Get Started

Concepts

Playbooks

Reference

Integrations

Arguments: `ActOptions` | `ObserveResult`

Returns: `Promise<ActResult>`

​Arguments: ActOptions | ObserveResult

​Returns: Promise<ActResult>

Arguments: `ActOptions` | `ObserveResult`

Returns: `Promise<ActResult>`