跳转到内容

获取元素

节点类型 browser_getElementRef

功能说明

定位元素并输出元素句柄,供后续点击、读取等操作引用。

客户端配置界面

获取元素节点的客户端配置界面

截图来自 MoreLogin 桌面客户端 V2.73.101 的英文界面。

输入字段

以下字段位于 data.browserUi.inputs。

字段类型或取值Schema 必填执行默认值说明与边界
selectorType"selector" / "element" / "frame"(支持变量引用)否"selector"目标来源 编辑器初值 "selector"
framestring否—iframe 框架
elementstring否—元素引用
selectorRadio"CSS" / "XPath"(支持变量引用)否"CSS"定位方式 编辑器初值 "CSS"
selectorstring否—选择器
outputRange"single" / "all"(支持变量引用)否"single"如果匹配到多个元素对象时 编辑器初值 "single"
serialType"fixed" / "randomInterval"(支持变量引用)否"fixed"如果匹配到多个元素对象时 编辑器初值 "fixed"
serialWorkflowNumber否1元素序号; integer; minimum after resolution: 1 编辑器初值 1
serialMinWorkflowNumber否—最小序号; integer; minimum after resolution: 1
serialMaxWorkflowNumber否—最大序号; integer; minimum after resolution: 1
type"object"(支持变量引用)否"object"输出类型 编辑器初值 "object"

条件与边界

  • 查找并返回真实元素引用;仅运行/同 epoch 调试可复用。
  • 校验错误码 RPA_NODE_INPUT_INVALID

输入引用

字段允许的形式
selectorTypeliteral, template
frameliteral, template
elementliteral, template
selectorRadioliteral, template
selectorliteral, template
outputRangeliteral, template
serialTypeliteral, template
serialliteral, numericExpression
serialMinliteral, numericExpression
serialMaxliteral, numericExpression
typeliteral, template

输出字段

适用条件 outputRange eq "single"

输出字段类型或取值
elementElementRef
matchedCountnumber

适用条件 outputRange eq "all"

输出字段类型或取值
elementarray<ElementRef>
matchedCountnumber

按契约用 ${nodeId.data.field} 引用公开字段。

JSON 示例

可放入流程 nodes 数组或其他节点 blocks 中的完整节点对象。

{
  "id": "find_button",
  "type": "browser_getElementRef",
  "data": {
    "title": "查找提交按钮",
    "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"
      }
    }
  }
}

返回节点目录