Safely clones a message object. This handles msg.req/msg.res objects that must not be cloned.

Compares two objects, handling various JavaScript types.

Encode an object to JSON without losing information about non-JSON types such as Buffer and Function.

This function is closely tied to its reverse within the editor

Converts the provided argument to a Buffer, using type-dependent methods.

Converts the provided argument to a String, using type-dependent methods.

Checks if a String contains any Environment Variable specifiers and returns it with their values substituted in place.

For example, if the env var WHO is set to Joe, the string Hello ${WHO}! will return Hello Joe!.

Evaluates a JSONata expression. The expression must have been prepared with @node-red/util-util.prepareJSONataExpression before passing to this function.

Evaluates a property value according to its type.

Generates a psuedo-unique-random id.

Gets a property of a message object.

Unlike @node-red/util-util.getObjectProperty, this function will strip msg. from the front of the property expression if present.

Gets a property of an object.

Given the object:

{
  "pet": {
      "type": "cat"
  }
}

• pet.type will return "cat".
• pet.name will return undefined
• car will return undefined
• car.type will throw an Error (as car does not exist)

Normalise a node type name to camel case.

For example: a-random node type will normalise to aRandomNodeType

Parses a property expression, such as msg.foo.bar[3] to validate it and convert it to a canonical version expressed as an Array of property names.

For example, a["b"].c returns ['a','b','c']

If msg is provided, any internal cross-references will be evaluated against that object. Otherwise, it will return a nested set of properties

For example, without msg set, 'a[msg.foo]' returns ['a', [ 'msg', 'foo'] ] But if msg is set to '{"foo": "bar"}', 'a[msg.foo]' returns ['a', 'bar' ]

Parses a context property string, as generated by the TypedInput, to extract the store name if present.

For example, #:(file)::foo results in { store: "file", key: "foo" }.

Prepares a JSONata expression for evaluation. This attaches Node-RED specific functions to the expression.

Sets a property of a message object.

Unlike @node-red/util-util.setObjectProperty, this function will strip msg. from the front of the property expression if present.

Sets a property of an object.