> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notte.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# observe

<Tip>
  Read [the Notte skill](https://notte.cc/skill.md) 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.
</Tip>

[Source: node-sdk/src/session.ts](https://github.com/nottelabs/notte/blob/main/node-sdk/src/session.ts)

Observe the current page: the list of actions that can be taken, a
screenshot and page metadata.

The `perception_type` defaults to the session option (`fast`). A bare
string argument is accepted as the perception type.

```typescript theme={null}
Session.observe(options?: ObserveRequest | PerceptionType): Promise<Observation>;
```

## Parameters

<ParamField body="options" type={"ObserveRequest | PerceptionType"}>
  Observation settings, including an optional URL, or a perception-mode string.

  Default:

  ```typescript theme={null}
  {}
  ```
</ParamField>

## Returns

```typescript theme={null}
Promise<Observation>
```

Structured page analysis, available actions, and page metadata.

## Raises

* NotteAPIError if observation fails.

## Example

```typescript theme={null}
const obs = await session.observe();
console.log(obs.space.description);
const deep = await session.observe({ perception_type: 'deep', max_nb_actions: 50 });
```

## Related types

* [Observation](/typescript-sdk-reference/types/observation)
* [ObserveRequest](/typescript-sdk-reference/types/observerequest)
* [PerceptionType](/typescript-sdk-reference/types/perceptiontype)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.