# 下载文件

节点类型 `browser_downloadFile`

## 功能说明

下载流程需要的文件。

## 客户端配置界面

![下载文件节点的客户端配置界面](/assets/download-file.35a15d9eb47315c27299eeb276388ee23c9da83d40644af5f983a495339dd605.0538f3a9.webp)

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

## 输入字段

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

| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|  --- | --- | --- | --- | --- |
| `url` | `string` | 否 | — | 文件 URL |
| `path` | `string` | 否 | — | 保存目录 |


## 条件与边界

- url 必填；path 是可选保存目录，不是完整文件名。不限文件大小；只有请求阶段（收到响应头之前）有 30 秒上限，整个下载受节点超时约束，大文件需调大节点超时。
- 校验错误码 `RPA_NODE_INPUT_INVALID`


## 输入引用

| 字段 | 允许的形式 |
|  --- | --- |
| `url` | `literal`, `template` |
| `path` | `literal`, `template` |


## 输出字段

| 输出字段 | 类型或取值 |
|  --- | --- |
| `path` | `string` |
| `name` | `string` |
| `url` | `string` |
| `mimeType` | `string` |
| `sizeBytes` | `number` |
| `reused` | `boolean` |


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

## JSON 示例

可放入流程 `nodes` 数组或其他节点 `blocks` 中的完整节点对象。把本机路径换成你电脑上的绝对路径。

```json
{
  "id": "download_report",
  "type": "browser_downloadFile",
  "data": {
    "title": "下载月度报告",
    "browserAction": "downloadFile",
    "browserUi": {
      "inputs": {
        "url": "https://example.com/files/report.pdf",
        "path": "/Users/example/Downloads"
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

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