ui.get_node
Overview
- Expands one node of the UI tree, identified by the ref that ui.get_tree or ui.find gave you. Use this for the parts ui.get_tree folded away ({role:'more'}) or cut with the node budget, instead of re-fetching the whole screen with a bigger budget. Unlike ui.get_tree this defaults to showing non-interactive structure too, since the point is to look closer. Fails when the ref no longer resolves - a window may have closed, or a list entry may have been recycled by scrolling, in which case re-query ui.get_tree for a fresh ref.
Metadata
| Field | Value |
|---|---|
| Display | Get UI Node |
| Category | ui |
| Access | Public |
| Scope | B1Standalone |
| Tags | Experimental |
| Aliases | — |
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| ref | string | no | — | Node ref from ui.get_tree / ui.find. |
| depth | int | no | 2 | Maximum depth below the node. 0 = unlimited. |
| max_nodes | int | no | 150 | Node budget for the response [1-5000]. |
| include_offscreen | bool | no | false | Include nodes whose rect lies outside the viewport. |
| show_decor | bool | no | false | Include decoration nodes (images, spacers, throbbers). |
Usage
await inzoi.cli.execute('ui.get_node', {
ref: '', // optional
depth: 2, // optional
max_nodes: 150, // optional
include_offscreen: false, // optional
show_decor: false, // optional
});