Wait For Screen Change Node

W

Automation/Computer/Wait

Verifies that an action had a visible effect: compares a display or desktop region against a baseline until at least Threshold of it has changed, or times out. Connect Baseline to a screenshot of the same area taken before the action to also catch instant changes; otherwise the baseline is captured when this node starts

computer_wait_screen_changeautomationLocal only

Inputs11

Outputs8

Security exposure5/10

Packageautomation

Ratings

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

SecurityAttack surface and exposure impact.

5/10Medium

PrivacyPotential sensitivity of processed data.

3/10Low

PerformanceRuntime or resource pressure.

5/10Medium

GovernancePolicy, audit, or compliance impact.

5/10Medium

ReliabilityOperational stability considerations.

8/10High

CostExternal or compute cost impact.

9/10High

Input Pins

11

▶

Execution

exec_in

Trigger

Session

Struct

session

Computer session handle

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

Display

Integer

display

Display to watch when no region is set: index from List Displays, -1 = primary

Default -1

Region X

Integer

region_x

Left edge of the watched region in desktop input coordinates

Default 0

Region Y

Integer

region_y

Top edge of the watched region in desktop input coordinates

Default 0

Region Width

Integer

region_width

Region width in desktop input coordinates; 0 with height 0 watches the whole display. The region must lie on one display

Default 0

Region Height

Integer

region_height

Region height in desktop input coordinates; 0 with width 0 watches the whole display

Default 0

Baseline

Struct

baseline

Optional image of the same area captured before the action

SchemaNodeImageNodeImageNodeImage1 fields

image_refstringrequired

Threshold

Float

threshold

Fraction of pixels (0-1) that must differ from the baseline to count as changed

Default 0.01

Range 0 to 1

Poll (ms)

Integer

poll_ms

Pause between captures (20-60000 ms)

Default 100

Timeout (ms)

Integer

timeout_ms

Maximum wait before taking the Timeout branch (0-3600000 ms)

Default 5000

Output Pins

8

▶

Execution

exec_out

The area changed

Timeout

Execution

exec_timeout

No change of at least Threshold before the timeout

Session

Struct

session_out

Computer session handle (pass-through)

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

Changed

Boolean

changed

Whether the area changed before the timeout

Change Ratio

Float

change_ratio

Fraction of pixels that differ from the baseline in the last frame

Before

Struct

before

Baseline image

SchemaNodeImageNodeImageNodeImage1 fields

image_refstringrequired

After

Struct

after

Last captured image

SchemaNodeImageNodeImageNodeImage1 fields

image_refstringrequired

Frame

Struct

frame

Desktop rectangle and pixel size of the After image

SchemaScreenFrameScreenFrameScreenFrame7 fields

display_indexinteger | null

format uint32default nullmin 0

xinteger:int32required

format int32

yinteger:int32required

format int32

widthinteger:uint32required

format uint32min 0

heightinteger:uint32required

format uint32min 0

pixel_widthinteger:uint32required

format uint32min 0

pixel_heightinteger:uint32required

format uint32min 0

Node Info

Internal name

computer_wait_screen_change

Category

Automation/Computer/Wait

Version

1