创建节点

Node-RED 的主要扩展方式是在其面板中添加新节点。

节点可以作为 npm 模块发布到公共 npm 仓库,并添加到Node-RED 流程库中,以便社区使用。

自 Node-RED 1.3 起

一般指导

创建新节点时应遵循一些通用原则。这些原则反映了核心节点所采用的方法,并有助于提供一致的用户体验。

节点应

  • 明确其用途。

    一个暴露 API 所有可能选项的节点,其作用可能不如一组各司其职的节点。

  • 简单易用,无论底层功能如何。

    隐藏复杂性,避免使用行话或领域特定知识。

  • 对它接受的消息属性类型具有包容性。

    消息属性可以是字符串、数字、布尔值、Buffer、对象、数组或 null。节点在遇到这些情况时应该做“正确的事”。

  • 发送内容保持一致。

    节点应记录它们添加到消息中的属性,并且它们的行为应保持一致和可预测。

  • 位于流程的开始、中间或结束——而不是同时处于所有位置。

  • 捕获错误。

    如果节点抛出未捕获的错误,Node-RED 将停止整个流程,因为系统状态不再可知。

    在任何可能的情况下,节点必须捕获错误或为其进行的所有异步调用注册错误处理程序。