Screenshot Node

S

Automation/Computer/Capture

Takes a screenshot of the primary display, a chosen display, or a region of one display. Frame maps image pixels back to the desktop coordinates the mouse nodes use

computer_screenshotautomationLocal only

Inputs9

Outputs5

Security exposure4/10

Packageautomation

Ratings

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

SecurityAttack surface and exposure impact.

4/10Medium

PrivacyPotential sensitivity of processed data.

3/10Low

PerformanceRuntime or resource pressure.

7/10High

GovernancePolicy, audit, or compliance impact.

5/10Medium

ReliabilityOperational stability considerations.

8/10High

CostExternal or compute cost impact.

9/10High

Input Pins

9

▶

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

Capture Type

String

capture_type

full: the primary display only. display: the display at Display Index. region: a rectangle of one display

Default full

fulldisplayregion

Display Index

Integer

display_index

Display for display capture and pixel-space region capture: index from List Displays, -1 = primary

Default 0

Region Space

String

region_space

pixels: region is in screenshot pixels of the display at Display Index (Retina displays have twice as many pixels as desktop units). desktop: region is in desktop input coordinates, like the mouse nodes, and may be on any display

Default pixels

pixelsdesktop

Region X

Integer

region_x

Left edge of the region (capture_type=region), in Region Space units

Default 0

Region Y

Integer

region_y

Top edge of the region, in Region Space units

Default 0

Region Width

Integer

region_width

Width of the region, in Region Space units

Default 100

Region Height

Integer

region_height

Height of the region, in Region Space units

Default 100

Output Pins

5

▶

Execution

exec_out

Continue

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

Screenshot

Struct

screenshot

Reference to the captured screenshot

SchemaArtifactRefArtifactRefArtifactRef7 fields

artifact_idstringrequired

artifact_typeArtifactTyperequired

enum "Screenshot", "Pdf", "Template", "DomSnapshot"...

pathFlowPathrequired

pathstringrequired

store_refstringrequired

cache_store_refstring | null

mime_typestringrequired

size_bytesinteger | null

format uint64min 0

created_atstring:date-timerequired

format date-time

metadataMap<string, string>required

*stringmap value

Image

Struct

image

Screenshot as NodeImage

SchemaNodeImageNodeImageNodeImage1 fields

image_refstringrequired

Frame

Struct

frame

Desktop rectangle and pixel size of the screenshot; converts image pixels to mouse coordinates

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_screenshot

Category

Automation/Computer/Capture

Version

2