节点类型 browser_getElement
读取一个或多个匹配元素的文本、HTML 或指定属性。

截图来自 MoreLogin 桌面客户端 V2.73.101 的英文界面。
以下字段位于 data.browserUi.inputs。
| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|---|---|---|---|---|
selectorType | "selector" / "element" / "frame"(支持变量引用) | 否 | "selector" | 元素来源 编辑器初值 "selector" |
frame | string | 否 | — | iframe 框架变量 |
element | string | 否 | — | 元素变量 |
selectorRadio | "CSS" / "XPath"(支持变量引用) | 否 | "CSS" | 定位方式 编辑器初值 "CSS"。例如 "${locatorType}",引用取到的值须为 "CSS" 或 "XPath"。 |
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 | "innerText" / "innerHTML" / "attribute"(支持变量引用) | 否 | "innerText" | 输出类型 编辑器初值 "innerText" |
key | string | 否 | — | 属性名 / 子元素选择器 |
- 定位规则: selectorType=selector 要求 selector;frame 要求 frame+selector;element 要求前序 ElementRef 引用。serial 从 1 开始;randomInterval 使用 serialMin/serialMax,最小值不能大于最大值;先等待选择器匹配到元素,再一次性取序号:区间上限按实际匹配数截断;固定序号或区间下限大于匹配数时立即返回 ELEMENT_NOT_FOUND(reason=range,details.field 为 serial 或 serialMin),不操作页面。 outputRange 只有 single/all;type 只有 innerText/innerHTML/attribute(与编辑器一致;元素对象用 getElementRef,iframe 用 getFrame),type=attribute 要求 key(属性名)。返回键和值的单个/数组形状必须按分支读取。不等待元素出现:找不到时立即成功,单个值为空字符串 ""(all 为 []),属性不存在为 "";需要等待时先用“等待元素”。
- 校验错误码
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 |
key | literal, template |
适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}
| 输出字段 | 类型或取值 |
|---|---|
text | string |
matchedCount | number |
适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}
| 输出字段 | 类型或取值 |
|---|---|
text | array<string> |
matchedCount | number |
适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}
| 输出字段 | 类型或取值 |
|---|---|
html | string |
matchedCount | number |
适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}
| 输出字段 | 类型或取值 |
|---|---|
html | array<string> |
matchedCount | number |
适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}
| 输出字段 | 类型或取值 |
|---|---|
attribute | string / null |
matchedCount | number |
适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}
| 输出字段 | 类型或取值 |
|---|---|
attribute | array<string / null> |
matchedCount | number |
按契约用 ${nodeId.data.field} 引用公开字段。
本例读取第一个匹配 .price 的元素文本,结果在 data.text。元素异步加载时,先添加「等待元素出现」。
{
"id": "read_price",
"type": "browser_getElement",
"data": {
"title": "读取商品价格",
"browserAction": "getElement",
"browserUi": {
"inputs": {
"selectorType": "selector",
"selectorRadio": "CSS",
"selector": ".price",
"outputRange": "single",
"serialType": "fixed",
"serial": 1,
"type": "innerText"
},
"exception": {
"timeout": 30000,
"policy": "interrupt"
}
}
}
}