Skip to main content
In “Agent” mode, tasks are built from a sequence of actions. These actions are executed sequentially by the browser.

​
Basic Actions

​
Click

Simulates a left-click on an element. Use this to interact with buttons, links, or any clickable item.
  • Selector: The CSS selector of the target element (e.g., #btn, .link).
  • Wait: Optional delay (in seconds) after clicking.

​
Type

Types text into an input field. Use this for filling out forms or search bars.
  • Selector: The target input (e.g., input[name="q"]).
  • Value: The text to type. Can include {$variables}.
  • Mode: Replace (clears existing text) or Append (adds to end).

​
Wait

Pauses execution for a fixed duration. Use this when you need a simple delay, though Wait for Element is often more reliable.
  • Value: Duration in seconds (e.g., 2.5).

​
Wait for Selector (wait_selector)

Waits until a specific element appears in the DOM. Use this to ensure the page has loaded the content you need before proceeding.
  • Selector: The element to wait for.
  • Value: Timeout in seconds (default: 30).

​
Press (press)

Simulates a keyboard key press. Use this for navigation keys like Enter, Tab, or Escape.
  • Key: The key name (e.g., Enter, Tab, Escape, ArrowDown).
  • Selector: (Optional) Focus this element before pressing.

​
Scroll

Scrolls the page or a specific element. Use this to reveal content that loads on scroll (lazy loading).
  • Selector: (Optional) The element to scroll. If empty, scrolls the window.
  • Value: Pixels to scroll (e.g., 500) or specific commands (bottom, top).

​
Hover

Moves the mouse cursor over an element. Use this to trigger dropdown menus or tooltips.
  • Selector: The target element.
Redirects the browser to a new URL. Use this to start a flow or move to a different page.
  • Value: The full URL (e.g., https://example.com/login).

​
Logic & Flow Control

​
If (if / else / end)

Conditional execution block. Use this to handle dynamic situations, like closing a popup only if it appears.
  • Condition: A JavaScript expression (e.g., exists('.error')).
  • Selector: (Structured mode) Target element.
  • Operator: equals, contains, exists, etc.

​
While (while / end)

Repeats a block of actions while a condition is true. Use this for pagination or waiting for a specific state change.
  • Condition: Same as if.
  • Value: (Optional) Max iterations to prevent infinite loops.

​
For Each (foreach / end)

Iterates over a list of elements. Use this to scrape lists of items, like search results or product cards.
  • Selector: The elements to iterate (e.g., .product-item).
  • Var Name: Variable to store the current element index/data.

​
Repeat N (repeat / end)

Repeats a block N times. Use this when you know exactly how many times an action needs to happen.
  • Value: Number of repetitions.

​
Advanced Actions

​
JavaScript (javascript)

Executes custom JavaScript in the browser context. Use this for complex logic, data extraction, or interactions not supported by other blocks.
  • Value: The JS code (e.g., return document.title;).
  • Output: The return value is stored in block.output for subsequent steps.

​
Screenshot

Takes a screenshot at the current state. Use this for debugging or keeping records of the task execution.
  • Value: (Optional) Filename suffix.
  • Selector: (Optional) Capture only this element.

​
Stop Task

Immediately stops the task execution. Use this to end the task early based on a condition (e.g., login success).
  • Value: Exit status (e.g., success, failure).

​
Set Variable (set)

Updates a runtime variable. Use this to store calculations or flags for later use.
  • Var Name: The variable to update (e.g., counter).
  • Value: The new value (can be a JS expression).

​
Wait for Downloads (wait_downloads)

Waits for file downloads to complete. Use this after clicking a download button to ensure the file is saved.
  • Value: Timeout in seconds.

​
On Error (on_error)

Defines a block of actions to run if an error occurs in the main flow. Use this to implement retry logic or graceful failures (try/catch).

​
CSV (csv)

Parses CSV formatted text into rows (an array of objects). Use this to extract data out of comma separated text for further processing.
  • Value: The CSV text to parse. If left blank, it will attempt to use the output of the previous block (block.output).

​
Merge (merge)

Merges multiple arrays, objects, or primitive values into a single output. Use this when you have collected data from different steps and need to combine them into one payload.
  • Value: Comma-separated list of values or variables to merge (e.g., items, extraItems, {$block.output}).
  • Target Variable: (Optional) The name of a new or existing variable to store the merged result (e.g., allItems).

​
Start Task (start)

Triggers another task to run from within the current task. Use this to create modular workflows by chaining tasks together.
  • Task: The ID of the task to run.