Action Node - Optexity Documentation

An action_node represents a single atomic action. Each node contains exactly one action type.

Structure

{
  "type": "action_node",
  "interaction_action": {
    "click_element": {
      "command": "get_by_role(\"button\", name=\"Submit\")",
      "prompt_instructions": "Click the submit button"
    }
  },
  "before_sleep_time": 0.0,
  "end_sleep_time": 1.0
}

Action Types

Each action node contains exactly one of:

Action	Purpose	Documentation
`interaction_action`	Click, type, select, navigate	Interaction Actions
`extraction_action`	Extract data, screenshots	Extraction Actions
`assertion_action`	Verify page conditions	Assertion Actions
`python_script_action`	Custom Python code	Python Scripts
`sleep_action`	Pure wait / timing step	Sleep Action

Timing Properties

Property	Type	Default	Description
`before_sleep_time`	`float`	`0.0` (extractions: `3.0`)	Seconds to wait before action
`end_sleep_time`	`float`	`1.0` (extractions: `0.0`)	Seconds to wait after action
`expect_new_tab`	`bool`	`False`	Action opens a new tab
`max_new_tab_wait_time`	`float`	`0.0` (if expect_new_tab: `10.0`)	Max wait for new tab

Default Timing by Action Type

Action Type	`before_sleep_time`	`end_sleep_time`
Interaction	`0.0`	`1.0`
Extraction	`3.0`	`0.0`
Assertion	`0.0`	`0.0`
2FA	`0.0`	`0.0`

Examples

Basic Click

{
  "type": "action_node",
  "interaction_action": {
    "click_element": {
      "command": "get_by_role(\"button\", name=\"Continue\")",
      "prompt_instructions": "Click continue"
    }
  }
}

With Custom Timing

{
  "type": "action_node",
  "interaction_action": {
    "click_element": {
      "command": "get_by_role(\"button\", name=\"Submit\")"
    }
  },
  "before_sleep_time": 2.0,
  "end_sleep_time": 3.0
}

Sleep-Only Node

Use a sleep_action when you want to pause without performing any browser interaction. sleep_time is specified in seconds:

{
  "type": "action_node",
  "sleep_action": {
    "sleep_time": 5.0
  }
}

Fail State Node

A fail_state_action is used to handle failure states in the automation. It will stop the automation, raise an exception with the provided failure message and mark it as failed.

{
  "type": "action_node",
  "fail_state_action": {
    "failure_message": "Automation completed at one of the failure states."
  }
}

fail_state_action can also be used with variables.

{
  "type": "action_node",
  "fail_state_action": {
    "failure_message": "Error in login process for user {username[0]}"
  }
}

Opens New Tab

{
  "type": "action_node",
  "interaction_action": {
    "click_element": {
      "command": "get_by_role(\"link\", name=\"View Details\")"
    }
  },
  "expect_new_tab": true
}

See Timing & Retries for detailed timing configuration.

​Structure

​Action Types

​Timing Properties

​Default Timing by Action Type

​Examples

​Basic Click

​With Custom Timing

​Sleep-Only Node

​Fail State Node

​Opens New Tab

Structure

Action Types

Timing Properties

Default Timing by Action Type

Examples

Basic Click

With Custom Timing

Sleep-Only Node

Fail State Node

Opens New Tab