From the time that Nick announced the Messaging hooks framework, my fingers have been itching to experiment with it. So fascinating stuff. But unfortunately I never had time for it ...
Started my first experiment tonight, but I am a bit confused.
While the onReceiveEvent is a plain object, the onSendEvent seems to be an array:
Perhaps I am misinterpreting the documentation incorrectly, but that looks to me also like a single plain object.
Might this be related to the case where a node has multiple outputs or something like that?
The hook is passed an array of SendEvent objects. The messages inside these objects are exactly what the node has passed to node.send - meaning there could be duplicate references to the same message object.
In other words, a single call to node.send() might contain multiple messages, and will trigger a single onSend event with all of those messages provided in the array of SendEvent objects.
Ok thanks Nick! That is clear.
I was first confused because there where no square brackets in the json example. But of course that shows the content of a single event object... And I had overlooked that part in the written documentation, which indeed explains it very well.
