节点类型 browser_focusElement
将键盘焦点移到指定元素。

截图来自 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 | 否 | — | 选择器 |
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 |
postWaitMs | WorkflowNumber | 否 | 200 | 完成后等待时长(毫秒); minimum after resolution: 0 编辑器初值 200 |
- 定位规则: selectorType=selector 要求 selector;frame 要求 frame+selector;element 要求前序 ElementRef 引用。serial 从 1 开始;randomInterval 使用 serialMin/serialMax,最小值不能大于最大值;先等待选择器匹配到元素,再一次性取序号:区间上限按实际匹配数截断;固定序号或区间下限大于匹配数时立即返回 ELEMENT_NOT_FOUND(reason=range,details.field 为 serial 或 serialMin),不操作页面。
- 校验错误码
RPA_NODE_INPUT_INVALID
| 字段 | 允许的形式 |
|---|---|
selectorType | literal, template |
frame | literal, template |
element | literal, template |
selectorRadio | literal, template |
selector | literal, template |
serialType | literal, template |
serial | literal, numericExpression |
serialMin | literal, numericExpression |
serialMax | literal, numericExpression |
postWaitMs | literal, numericExpression |
| 输出字段 | 类型或取值 |
|---|---|
tabId | string |
element | ElementRef |
isFocused | boolean |
按契约用 ${nodeId.data.field} 引用公开字段。
可放入流程 nodes 数组或其他节点 blocks 中的完整节点对象。
{
"id": "focus_email",
"type": "browser_focusElement",
"data": {
"title": "聚焦邮箱输入框",
"browserAction": "focusElement",
"browserUi": {
"inputs": {
"selectorType": "selector",
"selectorRadio": "CSS",
"selector": "input[name=email]",
"postWaitMs": 200
},
"exception": {
"timeout": 30000,
"policy": "interrupt"
}
}
}
}