Shiplight

Get console logs from the browser (errors, warnings, etc.)

Get network request logs from the browser

Get all options from a native dropdown

Get a local artifact file (screenshot, DOM snapshot, etc.) from a live browser session. Only accepts local file paths, NOT S3 URIs. For test run artifacts, use get_step_artifacts instead.

Get extension relay server status and tab mapping

Get current state of a session (URL, session type)

Navigate back to the previous page in browser history.

Navigate to a specific URL. Use this to visit web pages. Set new_tab=true to open in a new tab.

Hover over an interactive element.

Type text into an input field. To replace existing content, use clear_input first.

Create a new browser session with optional device emulation. Returns a session_id for subsequent operations. Use storage_state_path to restore a previously saved session (cookies, localStorage, IndexedDB). SCREEN RECORDING: Set browser_options.record_evidence=true only when you believe implementation is complete and are doing a final verification pass — not for exploration, investigation, or mid-task checking. This produces a video and trace the user can watch to confirm the finished change works. Both are saved automatically when the session is closed. After creating a session, IMMEDIATELY re…

Perform an operation that requires accurate interaction like dragging or interacting with a specific area of an element. Only use this action when neccecary.

Press a single keyboard key or key combination. Supports combinations like `Control+A` for select all. Does NOT support sequences - call this action multiple times to press keys in sequence.

Reload the current page. WARNING: This will reset any in-progress forms or multi-step flows (like login). Only use when you need to refresh stale data or clear a stuck state. Do NOT use during login, checkout, or form submission flows.

Right-click an interactive element.

Right-click at the given normalized coordinate.

Save the browser session's storage state (cookies, localStorage, IndexedDB) to a file. Use this after logging in to cache the session for fast restores via new_session's storage_state_path.

Save a value to a named variable for later use in the test.

Scroll the page by specified number of pages (set down=True to scroll down, down=False to scroll up, num_pages=number of pages to scroll like 0.5 for half page, 1.0 for one page, etc.).

Scroll on a scrollable element horizontally and vertically.

Scroll the page until specified text becomes visible.

Select an option from a dropdown/select element by value, label, or index.

Set a date in a native HTML date picker input (<input type="date">). IMPORTANT: ONLY use this action for input elements that have type="date" attribute (native HTML date picker). Do NOT use it for custom/non-native date pickers The date must be in YYYY-MM-DD format (e.g., 2024-03-15).

Switch to a different browser tab by index (0-based).

Click on target element (usually contains hints like "Upload file" or "Choose file" etc.) to trigger the file upload dialog, and choose the files to upload

Verify that a statement is true based on the current page state. Use this to check assertions about the page content, element visibility, or any condition.

Wait for a specified number of seconds before continuing.

Wait for an in-progress download to complete.