跳转到内容

元素数据

节点类型 browser_getElement

功能说明

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

客户端配置界面

元素数据节点的客户端配置界面

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

输入字段

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

字段类型或取值Schema 必填执行默认值说明与边界
selectorType"selector" / "element" / "frame"(支持变量引用)否"selector"元素来源 编辑器初值 "selector"
framestring否—iframe 框架变量
elementstring否—元素变量
selectorRadio"CSS" / "XPath"(支持变量引用)否"CSS"定位方式 编辑器初值 "CSS"。例如 "${locatorType}",引用取到的值须为 "CSS" 或 "XPath"。
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"innerText" / "innerHTML" / "attribute"(支持变量引用)否"innerText"输出类型 编辑器初值 "innerText"
keystring否—属性名 / 子元素选择器

条件与边界

  • 定位规则: 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

输入引用

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

输出字段

适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"single"}]}

输出字段类型或取值
textstring
matchedCountnumber

适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"innerText"},{"op":"eq","field":"outputRange","value":"all"}]}

输出字段类型或取值
textarray<string>
matchedCountnumber

适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"single"}]}

输出字段类型或取值
htmlstring
matchedCountnumber

适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"innerHTML"},{"op":"eq","field":"outputRange","value":"all"}]}

输出字段类型或取值
htmlarray<string>
matchedCountnumber

适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"single"}]}

输出字段类型或取值
attributestring / null
matchedCountnumber

适用条件 {"op":"and","rules":[{"op":"eq","field":"type","value":"attribute"},{"op":"eq","field":"outputRange","value":"all"}]}

输出字段类型或取值
attributearray<string / null>
matchedCountnumber

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

JSON 示例

本例读取第一个匹配 .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"
      }
    }
  }
}

返回节点目录