Eine JavaScript-Funktion welche zur Verarbeitung eingehender Nachrichten genutzt werden kann.

Die Nachrichten werden als JavaScript-Objekt mit Namen msg übergeben.

Es ist immer eine Eigenschaft msg.payload mit den Nachrichtennutzdaten vorhanden.

Der Knoten kann ein oder mehrere Nachrichtenobjekte zurückgeben, welche dann an die Ausgänge weitergereicht werden.

Der Setup-Tab enthält Quelltext, welcher ausgeführt wird, wenn der Knoten startet. Der Schließen-Tab enthält Quelltext, welcher ausgeführt wird, wenn der Knoten stoppt.

Wenn ein Promise-Objekt vom Setup-Quelltext zurückgegeben wird, werden Eingänge erst nach seiner Fertigstellung verarbeitet.

Details

Für mehr Informationen zum Schreiben von Funktionen, siehe auch die englischsprachige Onlinedokumentation.

Nachrichten ausgeben

Die Funktion kann Nachrichten, welche ausgegeben werden sollen entweder mittels return zurückgeben oder node.send(nachrichten) aufrufen.

The function can either return the messages it wants to pass on to the next nodes in the flow, or can call node.send(messages).

Sie kann zurückgeben bzw. senden:

Hinweis: Der Setup-Quelltext wird während der Knoteninitialisierung ausgeführt. Daher kann node.send nicht verwendet werden.

Wenn ein Arrayelement ein Array von Nachrichten ist, werden diese einzeln an den jeweiligen Ausgang gesendet.

Wenn null zurückgegeben wird oder ein Arrayelement null ist, wird keine Nachricht ausgegeben.

Logging und Fehlerbehandlung

Um Informationen zu loggen oder Fehler auszugeben, stehen folgende Funktionen zur Verfügung:

Knoteninformation

Im Funktionsblock stehen folgende Knoteninformationen zur Verfügung:

Aufrufen von Homegear-RPC-Methoden

Homegear-RPC-Methoden können mit hg.invoke(methodenName, [parameter1, parameter2, ...) aufgerufen werden.

Datenpersistenz

Daten können mit Hilfe folgender Funktionen gespeichert werden:

und mit folgenden Funktionen abgerufen werden:

Außerdem lässt sich Node-REDs Kontextspeicher-API verwenden.

Umgebungsvariablen

Auf Umgebungsvariablen kann über env.get("MEINE_UMGEBUNGS_VARIABLE") zugegriffen werden..