1
0
mirror of https://github.com/node-red/node-red.git synced 2023-10-10 13:36:53 +02:00

Created Deprecated: Message properties overriding node properties (markdown)

anna2130 2014-11-03 05:29:57 -08:00
parent c2ccd8562e
commit dcf3546cdf

@ -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`