List Elements Node

L

Automation/Browser/Extract

Lists elements matching a selector with their text, chosen attributes, box and visibility. When a browser snapshot exists for the page, each element, including elements inside frames, also gets a ref usable as a Ref selector.

browser_list_elementsautomationLocal only

Inputs6

Outputs4

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

6

▶

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

Attributes

String Array

attributes

Attribute names to include for each element

Default ["id","name","type","href","aria-label","placeholder","role"]

Limit

Integer

limit

Maximum elements returned

Default 50

Output Pins

4

▶

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

Elements

Struct Array

elements

Matching elements in document order

SchemaListedElementListedElementListedElement7 fields

indexinteger:uint

format uintdefault 0min 0

refstring | null

Snapshot ref, when a browser snapshot exists for this page.

tagstringrequired

textstringrequired

attributesMap<string, string>

default {}

*stringmap value

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

visiblebooleanrequired

Count

Integer

count

Number of matches before the limit

Node Info

Internal name

browser_list_elements

Category

Automation/Browser/Extract

Version

1