execute

AI agent instructions

Read the Notte skill and follow its setup instructions when setting up Notte or building browser automation. This is the shared source for CLI setup, authentication, and the browser-to-code workflow.

Source: node-sdk/src/session.ts Execute an action on the current page. When the action fails and raiseOnFailure is true (the default, see the session option), the structured exception_detail returned by the API is rehydrated into an ActionExecutionError whose errorType names the server-side error class. captcha_solve actions get a 100 s request timeout and are retried up to 3 times on HTTP 408.

Session.execute(action: ExecuteAction, options?: boolean | ExecuteOptions): Promise<CaptchaExecutionResponse>;

Parameters

ExecuteAction

required

Action type, target, and action-specific arguments.

boolean | ExecuteOptions

Override failure handling for this call; otherwise use the session setting.Default:

{}

Returns

Promise<CaptchaExecutionResponse>

The execution response, including success and failure details when throwing is disabled.

Raises

ActionExecutionError if the action fails and failure throwing is enabled.
NotteAPIError if the API request fails.

Example

import { actions } from 'notte-sdk';

await session.execute({ type: 'goto', url: 'https://www.notte.cc' });
await session.execute(actions.fill({ selector: "input[name='email']", value: 'user@example.com' }));
const result = await session.execute({ type: 'click', id: 'B1' }, { raiseOnFailure: false });
if (!result.success) console.log(result.message);

⌘I

Getting Started

APIs

Python SDK

Node SDK

Parameters

Returns

Raises

Example

​Parameters

​Returns

​Raises

​Example

​Related types

Parameters

Returns

Raises

Example

Related types