Skip to main content

Get Properties

Retrieves all accessible properties of a UI element and returns them as a JSON string.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.
info

If the ContinueOnError property is true, no error is caught when the project is executed, even if a Catch node is used.

Inputs​

  • Handle - The handle of the window containing the element.
  • Window Selector - The selector for identifying the target window.
  • Element Selector - The selector for identifying the target element.

Output​

  • Properties - A JSON string containing all accessible properties of the element.

Options​

  • Show Window - Whether to show the window before interacting with it. Default is false.

How It Works​

The Get Properties node retrieves all accessible properties of a UI element and returns them as a JSON string. When executed, the node:

  1. Uses the Window Selector and Element Selector to locate the target element
  2. Iterates through all properties of the element object
  3. Filters out private properties (those starting with underscore) and methods
  4. Serializes the remaining properties to a JSON string
  5. Sets the JSON string as the output value

Requirements​

  • Both Window Selector and Element Selector are required to identify the target element
  • The target element must be accessible through UI Automation

Error Handling​

The node will return specific errors in the following cases:

  • Empty or invalid Window Selector or Element Selector
  • Element not found
  • JSON serialization errors

Usage Notes​

  • The output is a JSON-formatted string that can be parsed for specific property values
  • Properties that cannot be accessed or serialized are silently skipped
  • The JSON output is formatted with indentation for readability
  • This node is primarily useful for debugging and inspection of UI elements
  • Complex property values are converted to strings in the output