evaluateJs

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 Evaluate JavaScript on the current page and return its result as a string. The result is stringified the way evaluate_js records it: objects and arrays as JSON, a JS null as the string "null". On failure the typed ActionExecutionError is thrown with the actual JavaScript error; pass raiseOnFailure: false to get the execution result envelope instead.

Session.evaluateJs(code: string, options?: { raiseOnFailure?: true; }): Promise<string>;
Session.evaluateJs(code: string, options: { raiseOnFailure: false; }): Promise<ApiExecutionResponse>;

Parameters (overload 1)

string

required

{ raiseOnFailure?: true }

Returns (overload 1)

Promise<string>

Parameters (overload 2)

string

required

{ raiseOnFailure: false }

required

Returns (overload 2)

Promise<ApiExecutionResponse>

Example

const title = await session.evaluateJs('document.title');
const payload = JSON.parse(await session.evaluateJs('(async () => JSON.stringify(await (await fetch("/api")).json()))()'));

ApiExecutionResponse

⌘I

Getting Started

APIs

Python SDK

Node SDK

Parameters (overload 1)

Returns (overload 1)

Parameters (overload 2)

Returns (overload 2)

Example

​Parameters (overload 1)

​Returns (overload 1)

​Parameters (overload 2)

​Returns (overload 2)

​Example

​Related types

Parameters (overload 1)

Returns (overload 1)

Parameters (overload 2)

Returns (overload 2)

Example

Related types