Skip to content

Capture Window Node

Automation/Computer/Window

Captures a screenshot of a specific window. Frame maps image pixels to the desktop coordinates the mouse nodes use

computer_capture_windowautomationLocal only
Inputs3
Outputs5
Security exposure3/10
Packageautomation

Ratings

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

SecurityAttack surface and exposure impact.
3/10Low
PrivacyPotential sensitivity of processed data.
2/10Low
PerformanceRuntime or resource pressure.
6/10Medium
GovernancePolicy, audit, or compliance impact.
4/10Medium
ReliabilityOperational stability considerations.
7/10High
CostExternal or compute cost impact.
10/10High

Input Pins

3

▶

Execution
exec_in

Trigger

Session

Struct
session

Computer session handle

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

Window ID

String
window_id

ID of the window to capture

Output Pins

5

▶

Execution
exec_out

Continue

Error

Execution
exec_error

Capture failed

Screenshot

String
screenshot

Base64-encoded PNG image

Image

Struct
image

Screenshot as NodeImage

NodeImageNodeImage1 fields
image_refstringrequired

Frame

Struct
frame

The window's desktop rectangle and the image's pixel size, or null when the window reports no geometry

ScreenFrameScreenFrame7 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_capture_window
Category
Automation/Computer/Window
Version
2