# 获取 iframe 框架

节点类型 `browser_getFrame`

## 功能说明

定位 iframe，供后续节点在该框架内查找和操作元素。

## 客户端配置界面

![获取 iframe 框架节点的客户端配置界面](/assets/get-frame.89eca60943fed60c90e6e3563dc159e6d725f65cb60c4e5ed7a2019d5f481758.0538f3a9.webp)

截图来自 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` | `"contentFrame"`（支持变量引用） | 否 | `"contentFrame"` | 输出类型 编辑器初值 `"contentFrame"` |


## 条件与边界

- 在当前页面、已获取的元素容器或 iframe 中查找 iframe，返回真实框架引用。
- 校验错误码 `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"`

| 输出字段 | 类型或取值 |
|  --- | --- |
| `frame` | `FrameRef` |
| `matchedCount` | `number` |


**适用条件** `outputRange` `eq` `"all"`

| 输出字段 | 类型或取值 |
|  --- | --- |
| `frame` | array<`FrameRef`> |
| `matchedCount` | `number` |


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

## JSON 示例

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

```json
{
  "id": "payment_frame",
  "type": "browser_getFrame",
  "data": {
    "title": "获取支付 iframe",
    "browserAction": "getFrame",
    "browserUi": {
      "inputs": {
        "selectorType": "selector",
        "selectorRadio": "CSS",
        "selector": "iframe#payment",
        "outputRange": "single",
        "type": "contentFrame"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

[返回节点目录](/zh/browser-rpa/nodes)