Шаблон:Node-RED/Создание нод

Создание нод

Главный способ расширения возможностей Node-RED – добавление в его «палитру» новых нод.

• Создание первой ноды
• JavaScript-файл
• HTML-файл
• Контекст ноды
• Свойства ноды
• Учетные данные
• Внешний вид ноды
• Статус ноды
• Конфигурационные ноды
• Руководство по созданию текста-справки
• Упаковка
• Локализация

Ниже – несколько общих принципов, которым мы рекомендуем следовать при создании новых нод. Эти отражают подход, который использовался при создании базовых нод, а также помогают сделать ноды такими, чтобы их использование было максимально понятным и логичным.

• У нод должна быть четкая цель. Одна нода, в которой задействованы почти все опции API, потенциально менее полезна, чем несколько нод, служащих каждая своей цели.
• Ноды должны быть такими, чтобы ими было легко пользоваться (независимо от функционала). Спрячьте сложность, старайтесь не загружать пользователя сленгом и специфическими знаниями из разных областей.
• Пускай ноды будут не слишком требовательными к типу данных, хранящихся в свойствах входящих сообщений. Значения в свойствах сообщения могут быть строками, числами, булевыми значениями, буферами, объектами, массивами и значениями «null». Столкнувшись с любым из этих типов данных, нода должна обработать с максимальным удобством для пользователя.
• Ноды должны быть постоянны в том, что они отправляют. Ноды должны документировать, какие свойства они добавляют в сообщения. Кроме того, их поведение должно быть понятным и предсказуемым.
• Нода должна стоять в начале, середине или конце потока – но не всюду сразу.
• Ноды должны уметь ловить ошибки. Если нода выдаст необработанную ошибку, Node-RED остановит работу всего потока, т.к. это ставит под вопрос состояние всей системы. Ноды должны ловить ошибки и регистрировать обработчики ошибок для любых генерируемых ими асинхронных вызовов везде, где это возможно.