RuleGo RuleGo
🏠首页
  • 快速入门
  • 规则链
  • 标准组件
  • 扩展组件
  • 自定义组件
  • 可视化
  • RuleGo-Server
  • RuleGo-MCP-Server
  • AOP
  • 触发器
  • 高级主题
  • 性能
  • 标准组件
  • 扩展组件
  • 自定义组件
  • 组件市场
  • 概述
  • 快速入门
  • 路由
  • DSL
  • API
  • Options
  • 组件
🔥编辑器 (opens new window)
  • 可视化编辑器 (opens new window)
  • RuleGo-Server (opens new window)
  • ❓问答

    • FAQ
💖支持
👥加入社区
  • Github (opens new window)
  • Gitee (opens new window)
  • GitCode (opens new window)
  • 更新日志 (opens new window)
  • English
  • 简体中文
🏠首页
  • 快速入门
  • 规则链
  • 标准组件
  • 扩展组件
  • 自定义组件
  • 可视化
  • RuleGo-Server
  • RuleGo-MCP-Server
  • AOP
  • 触发器
  • 高级主题
  • 性能
  • 标准组件
  • 扩展组件
  • 自定义组件
  • 组件市场
  • 概述
  • 快速入门
  • 路由
  • DSL
  • API
  • Options
  • 组件
🔥编辑器 (opens new window)
  • 可视化编辑器 (opens new window)
  • RuleGo-Server (opens new window)
  • ❓问答

    • FAQ
💖支持
👥加入社区
  • Github (opens new window)
  • Gitee (opens new window)
  • GitCode (opens new window)
  • 更新日志 (opens new window)
  • English
  • 简体中文

广告采用随机轮播方式显示 ❤️成为赞助商
  • 快速入门

  • 规则链

  • 标准组件

    • 标准组件概述
    • 过滤器

      • js脚本过滤器
        • 配置
        • Relation Type
        • 执行结果
        • 配置示例
        • 应用示例
      • 字段过滤器
      • 消息路由
      • js脚本路由
      • 过滤器组
      • 表达式过滤器
      • 并行网关
      • 条件分支
    • 动作

    • 转换器

    • 外部的

    • 流

  • 扩展组件

  • 自定义组件

  • 组件市场

  • 可视化

  • AOP

  • 触发器

  • 高级主题

  • RuleGo-Server

  • 问题

目录

js脚本过滤器

jsFilter组件:JavaScript脚本过滤器。使用JavaScript脚本对消息(msg)、元数据(metadata)、消息类型(msgType)进行过滤。根据脚本返回值决定消息的路由方向(True或者False链)。

JavaScript脚本支持ECMAScript 5.1(+) 语法规范和部分ES6规范,如:async/await/Promise/let。允许在脚本中调用Go自定义函数,请参考udf 。

# 配置

字段 类型 说明 默认值
jsScript string js脚本 无
  • jsScript:用于编写过滤逻辑的JavaScript脚本。该字段内容会被封装到以下函数体中:

        function Filter(msg, metadata, msgType) { 
            ${jsScript} 
         }
    
    1
    2
    3

    参数说明:

    • msg:消息内容
      • 当dataType=JSON时,类型为jsonObject,可直接使用点号访问属性,如msg.temperature
      • 其他dataType时,类型为string
    • metadata:消息元数据,类型为jsonObject
    • msgType:消息类型,类型为string
    • 返回值:必须返回boolean类型,决定消息的路由方向

注意事项

  1. jsScript脚本必须有明确的返回值(return true/false)
  2. 脚本执行有超时限制,可通过config.ScriptMaxExecutionTime配置

# Relation Type

  • True: 脚本返回true时,消息将沿True链路径继续传递
  • False: 脚本返回false时,消息将沿False链路径继续传递
  • Failure: 脚本执行出错时,消息将沿Failure链路径继续传递

# 执行结果

该组件是纯过滤组件,不会修改传入的msg、metadata和msgType内容。

# 配置示例

  {
    "id": "s1",
    "type": "jsFilter",
    "name": "过滤",
    "configuration": {
      "jsScript": "return msg.temperature > 50;"
    }
  }
1
2
3
4
5
6
7
8

# 应用示例

如果msgType是:EVENT_APP1,则把消息推送到:http://192.168.136.26:9099/app1/api/msg,否则推送到:http://192.168.136.26:9099/app2/api/msg

{
  "ruleChain": {
    "id":"rule01",
    "name": "测试规则链",
    "root": true
  },
  "metadata": {
    "nodes": [
      {
        "id": "s1",
        "type": "jsFilter",
        "name": "过滤",
        "configuration": {
          "jsScript": "return msgType =='EVENT_APP1';"
        }
      },
      {
        "id": "s2",
        "type": "restApiCall",
        "name": "推送数据-app2",
        "configuration": {
          "restEndpointUrlPattern": "http://192.168.136.26:9099/app1/api/msg",
          "requestMethod": "POST",
          "maxParallelRequestsCount": 200
        }
      },
      {
        "id": "s3",
        "type": "restApiCall",
        "name": "推送数据-app2",
        "configuration": {
          "restEndpointUrlPattern": "http://192.168.136.26:9099/app2/api/msg",
          "requestMethod": "POST",
          "maxParallelRequestsCount": 200
        }
      }
    ],
    "connections": [
      {
        "fromId": "s1",
        "toId": "s2",
        "type": "True"
      },
      {
        "fromId": "s1",
        "toId": "s3",
        "type": "False"
      }
    ]
  }
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
在 GitHub 上编辑此页 (opens new window)
上次更新: 2025/04/02, 01:29:50
标准组件概述
字段过滤器

← 标准组件概述 字段过滤器→

Theme by Vdoing | Copyright © 2023-2025 RuleGo Team | Apache 2.0 License

  • 跟随系统
  • 浅色模式
  • 深色模式
  • 阅读模式