https://github.com/waldbaer/node-red-persistent-values
Nodes for user-friendly use of the Node-RED context stores.
https://github.com/waldbaer/node-red-persistent-values
node-red persistency persistent persistent-storage
Last synced: 2 months ago
JSON representation
Nodes for user-friendly use of the Node-RED context stores.
- Host: GitHub
- URL: https://github.com/waldbaer/node-red-persistent-values
- Owner: waldbaer
- License: mit
- Created: 2023-01-09T21:14:52.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2025-11-02T11:26:27.000Z (5 months ago)
- Last Synced: 2025-11-02T13:13:24.698Z (5 months ago)
- Topics: node-red, persistency, persistent, persistent-storage
- Language: JavaScript
- Homepage:
- Size: 558 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Nodes for user-friendly use of the Node-RED context stores.
[](https://nodered.org)
[](https://badge.fury.io/js/@waldbaer%2Fnode-red-persistent-values)
[](https://opensource.org/licenses/MIT)
[](https://github.com/waldbaer/node-red-persistent-values/issues)
[](https://github.com/waldbaer/node-red-persistent-values/actions/workflows/test.yml)
[](https://coveralls.io/github/waldbaer/node-red-persistent-values?branch=master)
A user-friendly abstraction of the Node-RED context stores.
The idea behind persistent values is the user-friendly abstraction of the Node-RED core
[context functionality](https://nodered.org/docs/user-guide/context).
Instead of using a string name to access the context storage a central configuration node with
all known persistent values is used.
The persistent values itself can then be comfortably accessed with nodes just referencing the central
configuration and the persistent value to be accessed.
Persistent values are typically states, configuration options etc. which shall survive a restart of Node-RED.
# Features
- Central configuration of all known persistent values (states, config options, ...).
- Dataypes: Bool, Number, String, JSON
- Default value
- Scope and Storage type
- Optional description
- Node to read, write or reset a concrete persistent value referenced via the config.
- Configurable `msg` property for input of new persistent value or output of the current value.
- Configurable `msg` property for output of previous persisted value.
- Append the current persistent value as object attribute to an configurable `msg` property.
- Block further flow processing (no output) if the current value matches with a configured rule.
- Dynamic override of configured command and value with `msg` properties.
# Installation
You can install the nodes using the Node-RED 'Manage palette' in the side bar.
Or run the following command in the root directory of your Node-RED installation
```
npm install @waldbaer/node-red-persistent-values
```
[](https://www.npmjs.com/package/@waldbaer/node-red-persistent-values)
# Changelog
Changes can be followed [here](/CHANGELOG.md).
# Usage
## Introduction
1) Add all necessary values to be persisted (states, config options, ...) to one or multiple configuration nodes.
2) Select the desired configuration and value for read / write operations.
3) Read, write or collect the persistet values in your flows!
## Examples
Import into Node-RED instance via Node-RED -> Import -> Examples.
# Development
## Setup environment
```
npm install --save-dev
```
### Format / Linter / Tests
```
# Check linter
npm run lint
# Run all tests incl. coverage check
npm run coverage
# Run subset of tests
npm run test -- -g ""
# Node-RED package verification
npm run node-red-dev-validate
```
### Update dependencies to latest versions
```
# Show outdated dependencies
npm outdated
```