mirror of
				https://github.com/node-red/node-red.git
				synced 2025-03-01 10:36:34 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			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>
 |