Skip to content

Find element

Node type browser_getElementRef

What it does

Locate an element and return a handle for later element actions.

Desktop client configuration

Find element configuration in the desktop client

Captured in the English interface of MoreLogin Desktop V2.73.101.

Inputs

These fields belong in data.browserUi.inputs.

FieldType or valuesSchema requiredExecution defaultDescription and bounds
selectorType"selector" / "element" / "frame" (supports variable references)No"selector"Target source. Editor initial value "selector"
framestringNo—iframe
elementstringNo—Element reference
selectorRadio"CSS" / "XPath" (supports variable references)No"CSS"Selector type. Editor initial value "CSS"
selectorstringNo—Selector
outputRange"single" / "all" (supports variable references)No"single"When multiple element objects match. Editor initial value "single"
serialType"fixed" / "randomInterval" (supports variable references)No"fixed"When multiple element objects match. Editor initial value "fixed"
serialWorkflowNumberNo1Element index; integer; minimum after resolution: 1. Editor initial value 1
serialMinWorkflowNumberNo—Minimum index; integer; minimum after resolution: 1
serialMaxWorkflowNumberNo—Maximum index; integer; minimum after resolution: 1
type"object" (supports variable references)No"object"Output type. Editor initial value "object"

Mode requirements and limits

  • The node finds and returns a real element reference. The reference can be reused only within the same run or in debugging within the same epoch.
  • Validation code RPA_NODE_INPUT_INVALID

Input references

FieldAllowed forms
selectorTypeliteral, template
frameliteral, template
elementliteral, template
selectorRadioliteral, template
selectorliteral, template
outputRangeliteral, template
serialTypeliteral, template
serialliteral, numericExpression
serialMinliteral, numericExpression
serialMaxliteral, numericExpression
typeliteral, template

Outputs

Mode outputRange eq "single"

Output fieldType or values
elementElementRef
matchedCountnumber

Mode outputRange eq "all"

Output fieldType or values
elementarray<ElementRef>
matchedCountnumber

Reference published fields as ${nodeId.data.field}.

JSON example

A complete node object for a workflow's nodes array or another node's blocks.

{
  "id": "find_button",
  "type": "browser_getElementRef",
  "data": {
    "title": "Find the submit button",
    "browserAction": "getElementRef",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "button[type=submit]",
        "outputRange": "single",
        "serialType": "fixed",
        "serial": 1,
        "type": "object"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}

Back to the node catalog