From dcf3546cdf2b7223d5e2cf8e5558355e68bb1474 Mon Sep 17 00:00:00 2001 From: anna2130 Date: Mon, 3 Nov 2014 05:29:57 -0800 Subject: [PATCH] Created Deprecated: Message properties overriding node properties (markdown) --- ...d:-Message-properties-overriding-node-properties.md | 10 ++++++++++ 1 file changed, 10 insertions(+) create mode 100644 Deprecated:-Message-properties-overriding-node-properties.md diff --git a/Deprecated:-Message-properties-overriding-node-properties.md b/Deprecated:-Message-properties-overriding-node-properties.md new file mode 100644 index 0000000..1a9dfc1 --- /dev/null +++ b/Deprecated:-Message-properties-overriding-node-properties.md @@ -0,0 +1,10 @@ +Properties can be set in a node or in an incoming message to define behaviour. + +For example, when using a file node, either setting 'Filename' in the node or setting `msg.filename` in an incoming message will read from that file. If both properties are set `msg.filename` will currently override the node property. + +This behaviour is only found in some nodes and can have unexpected consequences as described in this [issue](https://github.com/node-red/node-red/issues/399). Therefore, message overriding has been deprecated. In future nodes and future releases `msg.some_property` will only be used if the property is not set in the node. Nodes currently using the override functionality will continue to function in this release but will also receive a warning noting that this behaviour is deprecated. + +The core nodes and properties affected by this behaviour are: +* **http request:** `msg.url` and `msg.method` +* **email:** `msg.to` +* **file:** `msg.filename` \ No newline at end of file