Skip to main content

Node function

The function node is used to write custom JavaScript code, allowing for complex calculations, data transformations, and message processing logic. It provides the flexibility to implement logic that is not supported by standard nodes.

Settings for the function node​

IMG2

1. Name​

A field for specifying the name of the node.
The name is displayed in the workspace and helps to easily identify the node.
If left empty, the node will be called function.

Example:

  • Node name: auth data

2. Function​

This field is where the JavaScript code is entered, which will be executed for each message passing through the node.

Input data format:​

The code receives an object msg, representing the current message.

Output data format:​

  • The node must return a message object (or an array of objects) to pass the data further down the stream.
  • If null is returned, the message will not be sent further.

Example:

// Incrementing the value of msg.payload by 1
msg.payload = msg.payload + 1;
return msg;

Usage examples​

Example 1: Multiplying the value in msg.payload​

msg.payload = msg.payload * 2;
return msg;

Description:

  • Takes the value of msg.payload, multiplies it by 2, and sends the updated object.

Example 2: Adding a new property​

msg.newProperty = "Hello, World!";
return msg;

Description:

  • Creates a new property newProperty and adds it to the msg object.

Example 3: Conditional message processing​

if (msg.payload > 100) {
    msg.alert = "High value detected!";
} else {
    msg.alert = "Value is normal.";
}
return msg;

Description:

  • Adds an alert property with a warning message depending on the value of msg.payload.

Example 4: Filtering messages​

if (msg.payload > 50) {
    return msg; // Pass the message further
}
return null; // Stop the message

Description:

  • Passes messages only with msg.payload > 50, while others are stopped.