mirror of https://github.com/node-red/node-red.git
52 lines
2.6 KiB
HTML
52 lines
2.6 KiB
HTML
<!--
|
||
Copyright JS Foundation and other contributors, http://js.foundation
|
||
|
||
Licensed under the Apache License, Version 2.0 (the "License");
|
||
you may not use this file except in compliance with the License.
|
||
You may obtain a copy of the License at
|
||
|
||
http://www.apache.org/licenses/LICENSE-2.0
|
||
|
||
Unless required by applicable law or agreed to in writing, software
|
||
distributed under the License is distributed on an "AS IS" BASIS,
|
||
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
||
See the License for the specific language governing permissions and
|
||
limitations under the License.
|
||
-->
|
||
|
||
<script type="text/x-red" data-help-name="function">
|
||
<p>定義對接收到的消息進行處理的JavaScript代碼（函數的主體）。</p>
|
||
<p>輸入消息在名爲<code>msg</code>的JavaScript對象中傳遞。</p>
|
||
<p>通常，<code>msg</code>對象將消息正文保留在<code>msg.payload</code>屬性中。</p>
|
||
<p>該函數一般會返回一個消息對象（或多個消息對象），但也可以爲了停止流程而什麽都不返回。</p>
|
||
<h3>詳細</h3>
|
||
<p>請參見<a target="_blank" href="https://nodered.org/docs/writing-functions.html">在線文檔</a>來獲得更多有關編寫函數的信息。</p>
|
||
<h4>傳送消息</h4>
|
||
<p>要將消息傳遞到流程中的下一個節點，請返回消息或調用<code>node.send(messages)</code>。</p>
|
||
<p>它將返回/send:</p>
|
||
<ul>
|
||
<li>單個消息對象 - 傳遞給連接到第一個輸出的節點</li>
|
||
<li>消息對象數組，傳遞給連接到相應輸出的節點</li>
|
||
</ul>
|
||
<p>如果數組元素是數組，則將多個消息發送到相應的輸出。</p>
|
||
<p>無論return方法是單個值還是數組元素，如果返回值爲null，則不會發送任何消息。</p>
|
||
<h4>日志輸出和錯誤處理</h4>
|
||
<p>使用以下功能輸出日志信息和輸出錯誤：</p>
|
||
<ul>
|
||
<li><code>node.log("Log message")</code></li>
|
||
<li><code>node.warn("Warning")</code></li>
|
||
<li><code>node.error("Error")</code></li>
|
||
</ul>
|
||
</p>
|
||
<p>使用catch節點可以進行錯誤處理。 要由catch節點處理，請將<code>msg</code>作爲<code>node.error</code>的第二個參數傳遞：</p>
|
||
<pre>node.error("Error",msg);</pre>
|
||
<h4>訪問節點信息</h4>
|
||
<p>您可以使用以下屬性來在代碼中引用節點ID和名稱：</p>
|
||
<ul>
|
||
<li><code>node.id</code> - 節點的ID</li>
|
||
<li><code>node.name</code> - 節點的名稱</li>
|
||
</ul>
|
||
<h4>使用環境變量</h4>
|
||
<p>環境變量可以通過<code>env.get("MY_ENV_VAR")</code>來進行訪問。</p>
|
||
</script>
|