message.addJSONNullBefore

Signature: message.addJSONNullBefore(nodePath, childNode)

Returns: void

Add the specified childNode to the first node that matches nodePath.

Note

This method only applies to JSON-formatted messages.

Parameters

Type	Name	Description	Default
String	nodePath	the node path (XPath, HPath, Column ID, etc.)
String	childNode	the name of the child node to add

Example

// Given a JSON message like:
message = qie.createJSONMessage(
    JSON.stringify(
        {
            "name": "David",
            "age": 44
        }
    )
);

// Add a null child node immediately BEFORE the node at nodePath
message.addJSONNullBefore(
    "/name",      // nodePath to insert before
    "introvert"   // name of the child node
);

// Resulting JSON:
// {
//     "introvert": null,
//     "name": "David",
//     "age": 44
// }