Get Element State Node

G

Automation/Browser/Extract

Reads whether an element is visible, enabled, checked, editable, focused and in the viewport, plus its box, tag and text. Fails when no element matches.

browser_get_element_stateautomationLocal only

Inputs4

Outputs12

Security exposure7/10

Packageautomation

Ratings

Scores range from 0 to 10. Higher values mean more impact, exposure, or operational weight.

SecurityAttack surface and exposure impact.

7/10High

PrivacyPotential sensitivity of processed data.

5/10Medium

PerformanceRuntime or resource pressure.

8/10High

GovernancePolicy, audit, or compliance impact.

7/10High

ReliabilityOperational stability considerations.

8/10High

CostExternal or compute cost impact.

10/10High

Input Pins

4

▶

Execution

exec_in

Trigger

Session

Struct

session

Automation session

SchemaAutomationSessionAutomationSessionAutomationSession11 fields

session_refstringrequired

platformPlatformrequired

enum "Windows", "MacOS", "Linux"

default_delay_msinteger:uint64required

format uint64min 0

click_delay_msinteger:uint64required

format uint64min 0

debug_modebooleanrequired

browser_typeanyOf (2)

Browser context info if browser is attached

variant 1BrowserTypevariant

enum "Chrome", "Firefox", "Edge", "Safari"

variant 2nullvariant

browser_headlessboolean | null

browser_user_data_dirstring | null

current_page_refstring | null

Current page info if a page is open

current_window_handlestring | null

browser_frame_selectorsArray<Selector>

default []

itemsSelectorarray item

kindSelectorKindrequired

variant 1enumvariant

enum "Css", "Xpath", "TextExact", "TestId"...

variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"

variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"

variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"

valuestringrequired

confidencenumber | null

format double

scopestring | null

CSS Selector

String

selector

CSS selector, or a snapshot ref such as e12

Locator

Struct

locator

Typed selector, including its kind and optional CSS scope. Overrides the legacy CSS selector when connected.

SchemaSelectorSelectorSelector4 fields

kindSelectorKindrequired

variant 1enumvariant

enum "Css", "Xpath", "TextExact", "TestId"...

variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"

variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"

variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"

valuestringrequired

confidencenumber | null

format double

scopestring | null

Output Pins

12

▶

Execution

exec_out

Continue

Session

Struct

session_out

Updated automation session

SchemaAutomationSessionAutomationSessionAutomationSession11 fields

session_refstringrequired

platformPlatformrequired

enum "Windows", "MacOS", "Linux"

default_delay_msinteger:uint64required

format uint64min 0

click_delay_msinteger:uint64required

format uint64min 0

debug_modebooleanrequired

browser_typeanyOf (2)

Browser context info if browser is attached

variant 1BrowserTypevariant

enum "Chrome", "Firefox", "Edge", "Safari"

variant 2nullvariant

browser_headlessboolean | null

browser_user_data_dirstring | null

current_page_refstring | null

Current page info if a page is open

current_window_handlestring | null

browser_frame_selectorsArray<Selector>

default []

itemsSelectorarray item

kindSelectorKindrequired

variant 1enumvariant

enum "Css", "Xpath", "TextExact", "TestId"...

variant 2constvariant

Visible text contained in the element; script, style and head content is ignored.

const "Text"

variant 3constvariant

ARIA role, optionally filtered by accessible name: `button`, `button|Sign in` (case-insensitive substring), `button|=Sign in` (exact) or `button|/^sign/i` (regex).

const "Role"

variant 4constvariant

Element ref from the latest Browser Snapshot, such as `e12`.

const "Ref"

valuestringrequired

confidencenumber | null

format double

scopestring | null

Visible

Boolean

visible

Rendered with a non-empty box

Enabled

Boolean

enabled

Not disabled

Checked

Boolean

checked

Checked, selected or pressed

Editable

Boolean

editable

Accepts typed input

Focused

Boolean

focused

Has keyboard focus

In Viewport

Boolean

in_viewport

Visible and intersecting the viewport

Bounds

Struct

bounds

Box in CSS pixels relative to the viewport

SchemaElementBoundsElementBoundsElementBounds4 fields

xnumber:doublerequired

format double

ynumber:doublerequired

format double

widthnumber:doublerequired

format double

heightnumber:doublerequired

format double

Tag

String

tag

Lowercase tag name

Text

String

text

Visible text, or the field value (empty for passwords)

State

Struct

state

All state values

SchemaElementStateElementStateElementState9 fields

visiblebooleanrequired

enabledbooleanrequired

checkedbooleanrequired

Checked checkbox/radio, selected option, or aria-checked/pressed/selected="true".

editablebooleanrequired

Enabled, not read-only text input, textarea, select or contenteditable.

focusedbooleanrequired

in_viewportbooleanrequired

boundsElementBoundsrequired

Element box in CSS pixels relative to the viewport.

xnumber:doublerequired

format double

ynumber:doublerequired

format double

widthnumber:doublerequired

format double

heightnumber:doublerequired

format double

tagstringrequired

textstringrequired

Visible text, or the value of form fields (empty for password fields).

Node Info

Internal name

browser_get_element_state

Category

Automation/Browser/Extract

Version

1