# 执行 JS 脚本

节点类型 `browser_javaScript`

## 功能说明

在 worker 中执行 JavaScript，处理传入的值。

## 客户端配置界面

![执行 JS 脚本节点的客户端配置界面](/assets/java-script.f78ec83c0a1adee00f604c3f927de88bdd1cc7cb153070292b5f8d391a9fac33.0538f3a9.webp)

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

## 输入字段

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

| 字段 | 类型或取值 | Schema 必填 | 执行默认值 | 说明与边界 |
|  --- | --- | --- | --- | --- |
| `params` | array<`object`> | 否 | `[]` | params 编辑器初值 `[]` |
| `content` | `string` | 否 | — | 运行 JS 脚本 |
| `outputFormat` | `object`（支持变量引用） | 否 | `{"type":"string"}` | 输出格式 编辑器初值 `{"type":"string"}` |


## 条件与边界

- 脚本在可终止的 worker 中运行（数据处理环境），不访问网页或客户端主进程；需要操作网页时用 injectJavaScript。脚本文本不插值。params 中类型为 object/array 的常量参数必须是合法的 JSON 对象/数组（写入时校验）。返回值按 outputFormat 校验/转换，省略时按 {"type":"string"}（与编辑器新建节点一致）：没有返回值为 null，string 格式下非字符串转为 JSON 文本，number/integer 格式下数字字符串转为数字，无法转换时失败 OUTPUT_TYPE_MISMATCH。
- 校验错误码 `RPA_NODE_INPUT_INVALID`


## 输入引用

| 字段 | 允许的形式 |
|  --- | --- |
| `params` | `literal`, `template` |
| `content` | `literal`, `template` |
| `outputFormat` | `literal`, `template` |


## 输出字段

| 输出字段 | 类型或取值 |
|  --- | --- |
| `value` | `["null","boolean","number","string"]` / array<`JSON`> / `object` |


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

## JSON 示例

可放入流程 `nodes` 数组或其他节点 `blocks` 中的完整节点对象。示例读取前面「元素数据」节点的输出 `read_title.data.text`。

```json
{
  "id": "format_price",
  "type": "browser_javaScript",
  "data": {
    "title": "格式化价格",
    "browserAction": "javaScript",
    "browserUi": {
      "inputs": {
        "params": [
          {
            "key": "price",
            "value": "${read_title.data.text}"
          }
        ],
        "content": "return 'Price: ' + params.price;",
        "outputFormat": {
          "type": "string"
        }
      },
      "exception": {
        "timeout": 30000,
        "policy": "interrupt"
      }
    }
  }
}
```

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