Skip to content

Wait for Window Node

Automation/Computer/Window

Waits until a window matches the title and application, or the timeout passes. When several windows match, the focused one is returned, otherwise the first in the operating system's window order (front to back)

computer_wait_for_windowautomationLocal only
Inputs6
Outputs3
Security exposureUnrated
Packageautomation

Ratings

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

No score metadata has been set for this node yet.

Input Pins

6

▶

Execution
exec_in

Trigger

Session

Struct
session

Active session

AutomationSessionAutomationSession11 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

Title

String
window_title

Window title substring

Application

String
process_name

Exact application name

Require Focus

Boolean
focused

Wait until the matched window is focused

Default false

Timeout

Integer
timeout_ms

Maximum wait in milliseconds

Default 10000

Output Pins

3

▶

Execution
exec_out

Window found

Timeout

Execution
exec_timeout

Window not found in time

Window

Struct
window

Matched window

WindowInfoWindowInfo9 fields
idstringrequired
titlestringrequired
app_namestring | null
xinteger:int32required
format int32
yinteger:int32required
format int32
widthinteger:uint32required
format uint32min 0
heightinteger:uint32required
format uint32min 0
is_focusedbooleanrequired
is_minimizedbooleanrequired

Node Info

Internal name
computer_wait_for_window
Category
Automation/Computer/Window
Version
2