Set Emulation Node

S

Automation/Browser/Emulation

Makes the current tab behave like another device or place: locale, time zone, geolocation, screen size, color scheme, user agent and offline mode. Empty or zero inputs leave that setting unchanged; Offline is always applied. Overrides last until the tab closes. Chrome and Edge only.

browser_set_emulationautomationLocal only

Inputs12

Outputs2

Security exposure7/10

Packageautomation

Ratings

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

SecurityAttack surface and exposure impact.

7/10High

PrivacyPotential sensitivity of processed data.

7/10High

PerformanceRuntime or resource pressure.

9/10High

GovernancePolicy, audit, or compliance impact.

6/10Medium

ReliabilityOperational stability considerations.

8/10High

CostExternal or compute cost impact.

10/10High

Input Pins

12

▶

Execution

exec_in

Trigger

Session

Struct

session

Automation session

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

Locale

String

locale

BCP 47 locale such as de-DE, used for Intl formatting, navigator.language and the Accept-Language header

Time Zone

String

timezone_id

IANA time zone such as Europe/Berlin

Geolocation

Struct

geolocation

Position reported by the Geolocation API; also grants the geolocation permission

SchemaGeolocationGeolocationGeolocation3 fields

latitudenumber:doublerequired

format double

longitudenumber:doublerequired

format double

accuracynumber | null

format double

Viewport Width

Integer

viewport_width

Emulated screen width in CSS pixels; set together with Viewport Height

Default 0

Viewport Height

Integer

viewport_height

Emulated screen height in CSS pixels; set together with Viewport Width

Default 0

Device Scale Factor

Float

device_scale_factor

Device pixel ratio for the emulated screen; 0 keeps the display's own ratio

Default 0

Mobile

Boolean

mobile

Emulate a mobile device (meta viewport, overlay scrollbars) with the viewport size

Default false

Color Scheme

String

color_scheme

Value reported to prefers-color-scheme media queries

lightdarkno-preference

User Agent

String

user_agent

User-Agent header and navigator.userAgent for this tab

Offline

Boolean

offline

Simulate a lost network connection; false restores connectivity

Default false

Output Pins

2

▶

Execution

exec_out

Continue

Session

Struct

session_out

Updated automation session

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

Node Info

Internal name

browser_set_emulation

Category

Automation/Browser/Emulation

Version

1