Node-RED:Создание нод
Материал из Онлайн справочника
Перевод: Максим Кузьмин
Проверка/Оформление/Редактирование: Мякишев Е.А.
Создание нод [1]
Главный способ расширения возможностей Node-RED – добавление в его «палитру» новых нод.
- Создание первой ноды
- JavaScript-файл
- HTML-файл
- Контекст ноды
- Свойства ноды
- Учетные данные
- Внешний вид ноды
- Статус ноды
- Конфигурационные ноды
- Руководство по созданию текста-справки
- Упаковка
- Локализация
Ниже – несколько общих принципов, которым мы рекомендуем следовать при создании новых нод. Эти отражают подход, который использовался при создании базовых нод, а также помогают сделать ноды такими, чтобы их использование было максимально понятным и логичным.
- У нод должна быть четкая цель. Одна нода, в которой задействованы почти все опции API, потенциально менее полезна, чем несколько нод, служащих каждая своей цели.
- Ноды должны быть такими, чтобы ими было легко пользоваться (независимо от функционала). Спрячьте сложность, старайтесь не загружать пользователя сленгом и специфическими знаниями из разных областей.
- Пускай ноды будут не слишком требовательными к типу данных, хранящихся в свойствах входящих сообщений. Значения в свойствах сообщения могут быть строками, числами, булевыми значениями, буферами, объектами, массивами и значениями «null». Столкнувшись с любым из этих типов данных, нода должна обработать с максимальным удобством для пользователя.
- Ноды должны быть постоянны в том, что они отправляют. Ноды должны документировать, какие свойства они добавляют в сообщения. Кроме того, их поведение должно быть понятным и предсказуемым.
- Нода должна стоять в начале, середине или конце потока – но не всюду сразу.
- Ноды должны уметь ловить ошибки. Если нода выдаст необработанную ошибку, Node-RED остановит работу всего потока, т.к. это ставит под вопрос состояние всей системы. Ноды должны ловить ошибки и регистрировать обработчики ошибок для любых генерируемых ими асинхронных вызовов везде, где это возможно.
