Find Elements Node

F

Automation/Browser/Snapshot

Searches the latest browser snapshot by role, accessible name and text and returns matching refs. Takes a fresh full snapshot when none exists, the page navigated, or Refresh is set. Requires Chrome or Edge.

browser_find_elementsautomationLocal only

Inputs8

Outputs6

Security exposure6/10

Packageautomation

Ratings

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

SecurityAttack surface and exposure impact.

6/10Medium

PrivacyPotential sensitivity of processed data.

4/10Medium

PerformanceRuntime or resource pressure.

7/10High

GovernancePolicy, audit, or compliance impact.

6/10Medium

ReliabilityOperational stability considerations.

8/10High

CostExternal or compute cost impact.

9/10High

Input Pins

8

▶

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

Role

String

role

ARIA role such as button, link or textbox (empty matches any role)

Name

String

name

Accessible name to match (empty matches any name)

Name Match

String

name_match

How Name is compared: case-insensitive contains, exact, or regex

Default contains

containsexactregex

Text

String

text

Case-insensitive text contained in the name, value, text or description

Refresh

Boolean

refresh

Always take a fresh full snapshot before searching

Default false

Limit

Integer

limit

Maximum matches returned

Default 20

Output Pins

6

▶

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

Refs

String Array

refs

Matching refs

Lines

String Array

lines

Snapshot line of each match

Elements

Struct Array

elements

Matching snapshot elements

SchemaSnapshotElementSnapshotElementSnapshotElement10 fields

refstring | null

Ref usable as a `Ref` selector until the document changes.

rolestringrequired

ARIA role; `text` for plain text lines.

namestring

default ""

valuestring | null

descriptionstring | null

textstring | null

levelinteger | null

format uint32min 0

urlstring | null

statesArray<string>

focused, disabled, checked, checked=mixed, pressed, expanded, collapsed, selected, required, readonly, invalid, cursor=pointer.

itemsstringarray item

depthinteger:uint32required

format uint32min 0

Count

Integer

count

Number of matches before the limit

Node Info

Internal name

browser_find_elements

Category

Automation/Browser/Snapshot

Version

1