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

截图来自 MoreLogin 桌面客户端 V2.73.101 的英文界面。
以下字段位于 data.browserUi.inputs。
| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|---|---|---|---|---|
selectorType | "selector" / "element" / "frame"(支持变量引用) | 否 | "selector" | 目标来源 编辑器初值 "selector" |
frame | string | 否 | — | iframe 框架 |
element | string | 否 | — | 元素引用 |
selectorRadio | "CSS" / "XPath"(支持变量引用) | 否 | "CSS" | 定位方式 编辑器初值 "CSS" |
selector | string | 否 | — | 选择器 |
outputRange | "single" / "all"(支持变量引用) | 否 | "single" | 如果匹配到多个元素对象时 编辑器初值 "single" |
serialType | "fixed" / "randomInterval"(支持变量引用) | 否 | "fixed" | 如果匹配到多个元素对象时 编辑器初值 "fixed" |
serial | WorkflowNumber | 否 | 1 | 元素序号; integer; minimum after resolution: 1 编辑器初值 1 |
serialMin | WorkflowNumber | 否 | — | 最小序号; integer; minimum after resolution: 1 |
serialMax | WorkflowNumber | 否 | — | 最大序号; integer; minimum after resolution: 1 |
type | "object"(支持变量引用) | 否 | "object" | 输出类型 编辑器初值 "object" |
- 查找并返回真实元素引用;仅运行/同 epoch 调试可复用。
- 校验错误码
RPA_NODE_INPUT_INVALID
| 字段 | 允许的形式 |
|---|---|
selectorType | literal, template |
frame | literal, template |
element | literal, template |
selectorRadio | literal, template |
selector | literal, template |
outputRange | literal, template |
serialType | literal, template |
serial | literal, numericExpression |
serialMin | literal, numericExpression |
serialMax | literal, numericExpression |
type | literal, template |
适用条件 outputRange eq "single"
| 输出字段 | 类型或取值 |
|---|---|
element | ElementRef |
matchedCount | number |
适用条件 outputRange eq "all"
| 输出字段 | 类型或取值 |
|---|---|
element | array<ElementRef> |
matchedCount | number |
按契约用 ${nodeId.data.field} 引用公开字段。
可放入流程 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"
}
}
}
}