Skip to content

Screenshot To File Node

Automation/Vision

Captures a display and optionally saves it as PNG

vision_screenshot_to_fileautomationLocal only
Inputs4
Outputs4
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.
2/10Low
PerformanceRuntime or resource pressure.
8/10High
GovernancePolicy, audit, or compliance impact.
5/10Medium
ReliabilityOperational stability considerations.
8/10High
CostExternal or compute cost impact.
9/10High

Input Pins

4

▶

Execution
exec_in

Trigger

Session

Struct
session

Automation 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

File Path

Struct
file_path

Path to save the screenshot

FlowPathFlowPath3 fields
pathstringrequired
store_refstringrequired
cache_store_refstring | null

Monitor

Integer
monitor

Monitor index from List Displays (-1 = primary)

Default 0

Output Pins

4

▶

Execution
exec_out

Continue

Success

Boolean
success

Whether the screenshot was saved

Image

Struct
image

Screenshot as NodeImage

NodeImageNodeImage1 fields
image_refstringrequired

Frame

Struct
frame

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

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
vision_screenshot_to_file
Category
Automation/Vision
Version
2