# 获取监听数据

节点类型 `browser_getNetworkData`

## 功能说明

读取先前网络监听节点捕获的数据。

## 客户端配置界面

![获取监听数据节点的客户端配置界面](/assets/get-network-data.9d3e30ddc465c9b63b04457adeb8a75ae1ad93a2e905c771e0f29d8edfbd8914.0538f3a9.webp)

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

## 输入字段

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

| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|  --- | --- | --- | --- | --- |
| `scope` | `"all"` / `"specified"`（支持变量引用） | 否 | `"all"` | 监听范围 编辑器初值 `"all"` |
| `listenerIds` | array<`string`>（支持变量引用） | 否 | — | 选择监听 |
| `eventType` | `"response"` / `"request"`（支持变量引用） | 否 | `"response"` | 获取内容 编辑器初值 `"response"` |
| `filterEnabled` | `boolean`（支持变量引用） | 否 | `false` | 启用筛选条件 编辑器初值 `false` |
| `urlMatch` | `"contains"` / `"exact"` / `"regex"`（支持变量引用） | 否 | `"contains"` | 请求 URL 匹配方式 编辑器初值 `"contains"` |
| `url` | `string` | 否 | `""` | 请求 URL（可选） 编辑器初值 `""` |
| `method` | `"ANY"` / `"GET"` / `"POST"` / `"PUT"` / `"PATCH"` / `"DELETE"` / `"HEAD"` / `"OPTIONS"`（支持变量引用） | 否 | `"ANY"` | 请求方法 编辑器初值 `"ANY"` |
| `resourceType` | `"all"` / `"fetch-xhr"` / `"document"` / `"script"` / `"stylesheet"` / `"image"` / `"font"` / `"media"` / `"other"`（支持变量引用） | 否 | `"all"` | 资源类型 编辑器初值 `"all"` |
| `outputMode` | `"first"` / `"all"`（支持变量引用） | 否 | `"all"` | 获取方式 编辑器初值 `"all"` |
| `waitTimeoutMs` | `WorkflowNumber` | 否 | `10000` | 无数据时等待时长（毫秒）; minimum after resolution: 1 编辑器初值 `10000` |
| `bodyFormat` | `"auto"` / `"json"` / `"text"`（支持变量引用） | 否 | `"auto"` | 响应体格式 编辑器初值 `"auto"` |


## 条件与边界

- scope=specified 要求非空 listenerIds；first 等待至 waitTimeoutMs，all 立即返回当前可用列表；读取成功会消费所选请求/响应。
- 校验错误码 `RPA_NODE_INPUT_INVALID`


## 输入引用

| 字段 | 允许的形式 |
|  --- | --- |
| `scope` | `literal`, `template` |
| `listenerIds` | `literal`, `template` |
| `eventType` | `literal`, `template` |
| `filterEnabled` | `literal`, `template` |
| `urlMatch` | `literal`, `template` |
| `url` | `literal`, `template` |
| `method` | `literal`, `template` |
| `resourceType` | `literal`, `template` |
| `outputMode` | `literal`, `template` |
| `waitTimeoutMs` | `literal`, `numericExpression` |
| `bodyFormat` | `literal`, `template` |


## 输出字段

**适用条件** `{"op":"and","rules":[{"op":"eq","field":"eventType","value":"request"},{"op":"eq","field":"outputMode","value":"first"}]}`

| 输出字段 | 类型或取值 |
|  --- | --- |
| `request` | `RequestInfo` |


**适用条件** `{"op":"and","rules":[{"op":"eq","field":"eventType","value":"request"},{"op":"eq","field":"outputMode","value":"all"}]}`

| 输出字段 | 类型或取值 |
|  --- | --- |
| `requests` | array<`RequestInfo`> |
| `count` | `number` |


**适用条件** `{"op":"and","rules":[{"op":"eq","field":"eventType","value":"response"},{"op":"eq","field":"outputMode","value":"first"}]}`

| 输出字段 | 类型或取值 |
|  --- | --- |
| `response` | `ResponseInfo` |


**适用条件** `{"op":"and","rules":[{"op":"eq","field":"eventType","value":"response"},{"op":"eq","field":"outputMode","value":"all"}]}`

| 输出字段 | 类型或取值 |
|  --- | --- |
| `responses` | array<`ResponseInfo`> |
| `count` | `number` |


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

## JSON 示例

可放入流程 `nodes` 数组或其他节点 `blocks` 中的完整节点对象。前面的「开始网络监听」节点负责捕获请求。

```json
{
  "id": "read_api_response",
  "type": "browser_getNetworkData",
  "data": {
    "title": "读取监听到的 API 响应",
    "browserAction": "getNetworkData",
    "browserUi": {
      "inputs": {
        "scope": "all",
        "eventType": "response",
        "filterEnabled": true,
        "urlMatch": "contains",
        "url": "/api/orders",
        "method": "GET",
        "resourceType": "fetch-xhr",
        "outputMode": "first",
        "waitTimeoutMs": 10000,
        "bodyFormat": "json"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

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