RuleGo RuleGo
🏠Home
  • Quick Start
  • Rule Chain
  • Standard Components
  • Extension Components
  • Custom Components
  • Visualization
  • RuleGo-Server
  • RuleGo-MCP-Server
  • AOP
  • Trigger
  • Advanced Topics
  • Performance
  • Standard Components
  • Extension Components
  • Custom Components
  • Components Marketplace
  • Overview
  • Quick Start
  • Routing
  • DSL
  • API
  • Options
  • Components
🔥Editor (opens new window)
  • RuleGo Editor (opens new window)
  • RuleGo Server (opens new window)
  • Github (opens new window)
  • Gitee (opens new window)
  • Changelog (opens new window)
  • English
  • 简体中文
🏠Home
  • Quick Start
  • Rule Chain
  • Standard Components
  • Extension Components
  • Custom Components
  • Visualization
  • RuleGo-Server
  • RuleGo-MCP-Server
  • AOP
  • Trigger
  • Advanced Topics
  • Performance
  • Standard Components
  • Extension Components
  • Custom Components
  • Components Marketplace
  • Overview
  • Quick Start
  • Routing
  • DSL
  • API
  • Options
  • Components
🔥Editor (opens new window)
  • RuleGo Editor (opens new window)
  • RuleGo Server (opens new window)
  • Github (opens new window)
  • Gitee (opens new window)
  • Changelog (opens new window)
  • English
  • 简体中文

广告采用随机轮播方式显示 ❤️成为赞助商
  • Quick Start

  • Rule Chain

  • Standard Components

    • Standard Components Overview
    • filter

      • jsFilter
        • Configuration
        • Relation Type
        • Execution result
        • Configuration example
        • Application example
      • fieldFilter
      • msgTypeSwitch
      • jsSwitch
      • groupFilter
      • exprFilter
      • fork
      • Switch
    • action

    • transform

    • external

    • flow

  • Extension Components

  • Custom Components

  • Components marketplace

  • Visualization

  • AOP

  • Trigger

  • Advanced Topic

  • RuleGo-Server

  • FAQ

  • Endpoint Module

  • Support

目录

jsFilter

jsFilter component: script filter. You can use JavaScript script to filter msg, metadata, msgType. The script should return the route to True or False chain.

JavaScript script supports ECMAScript 5.1(+) syntax specification and some ES6 specifications, such as: async/await/Promise/let. It allows calling Go custom functions in the script, please refer to udf .

# Configuration

Field Type Description Default value
jsScript string js script None
  • jsScript: You can filter msg, metadata, msgType. This field is the following function body content

        function Filter(msg, metadata, msgType) { 
            ${jsScript} 
         }
    
    1
    2
    3
    • msg: Message content, if dataType=JSON, type is: jsonObject, you can use msg.temperature to operate. If dataType is other types, the field type is:string
    • metadata: Message metadata, type: jsonObject
    • msgType: Message type
    • Function return value type: boolean, determines the connection relationship with the next node (Relation Type)

Note

jsScript script must have a return value, return true/false;
Script execution timeout configuration reference: config.ScriptMaxExecutionTime

# Relation Type

  • True: Send the message to the True chain
  • False: Send the message to the False chain
  • Failure: Execution failed, send the message to the Failure chain

# Execution result

This component will not change the content of msg, metadata and msgType.

# Configuration example

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

# Application example

If msgType is: EVENT_APP1, then push the message to: http://192.168.136.26:9099/app1/api/msg, otherwise push to: http://192.168.136.26:9099/app2/api/msg

{
  "ruleChain": {
    "id":"rule01",
    "name": "Test rule chain",
    "root": true
  },
  "metadata": {
    "nodes": [
      {
        "id": "s1",
        "type": "jsFilter",
        "name": "Filter",
        "configuration": {
          "jsScript": "return msgType =='EVENT_APP1';"
        }
      },
      {
        "id": "s2",
        "type": "restApiCall",
        "name": "Push data-app2",
        "configuration": {
          "restEndpointUrlPattern": "http://192.168.136.26:9099/app1/api/msg",
          "requestMethod": "POST",
          "maxParallelRequestsCount": 200
        }
      },
      {
        "id": "s3",
        "type": "restApiCall",
        "name": "Push data-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
Edit this page on GitHub (opens new window)
Last Updated: 2025/04/02, 01:29:50
Standard Components Overview
fieldFilter

← Standard Components Overview fieldFilter→

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

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