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.
Für mehr Informationen zum Schreiben von Funktionen, siehe auch die englischsprachige Onlinedokumentation.
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.
Um Informationen zu loggen oder Fehler auszugeben, stehen folgende Funktionen zur Verfügung:
node.log("Nachricht")
node.warn("Warnung")
node.error("Fehler")
Im Funktionsblock stehen folgende Knoteninformationen zur Verfügung:
node.id
- Die ID des Knotensnode.z
- Die ID des Flowsnode.name
- Der Name des KnotensHomegear-RPC-Methoden können mit hg.invoke(methodenName, [parameter1, parameter2, ...)
aufgerufen werden.
Daten können mit Hilfe folgender Funktionen gespeichert werden:
setNodeData(key, value)
,setFlowData(key, value)
orsetGlobalData(key, value)
und mit folgenden Funktionen abgerufen werden:
getNodeData(key)
,getFlowData(key)
orgetGlobalData(key)
.Außerdem lässt sich Node-REDs Kontextspeicher-API verwenden.
Auf Umgebungsvariablen kann über env.get("MEINE_UMGEBUNGS_VARIABLE") zugegriffen werden.
.