node-red-contrib-clamp 1.0.0
Node-RED clamp node - limits values to a min/max range
node-red-contrib-clamp
Node-RED Clamp Node - limits values to a min/max range.
Features
- Limits values to configured min/max range
- Values below min are clipped to min
- Values above max are clipped to max
- Runtime overrides via msg properties
- Configurable decimal places (0-10)
Behavior
- Input < min → Output = min
- Input > max → Output = max
- Input in range → Output = input unchanged
Examples
min=0, max=100:
Input 120 → Output 100 (clamped)
Input -5 → Output 0 (clamped)
Input 42 → Output 42 (passthrough)
min=-10, max=10:
Input 15 → Output 10 (clamped)
Input -15 → Output -10 (clamped)
Input 0 → Output 0 (passthrough)
Configuration
| Property | Description | Default |
|---|---|---|
| Min | Lower bound | 0 |
| Max | Upper bound | 100 |
| Decimals | Number of decimal places | 2 |
Input
msg.payload- Numeric value to clamp
Runtime Overrides
| Property | Description |
|---|---|
msg.min |
Override minimum |
msg.max |
Override maximum |
Output
{
"payload": 100,
"clamp": {
"input": 120,
"output": 100,
"min": 0,
"max": 100,
"clamped": true,
"clampedAt": "max"
}
}
Use Cases
| Application | Description |
|---|---|
| Sensor | Limit sensor readings to valid range |
| Control | Constrain output to safe limits |
| UI | Ensure slider values stay within bounds |
| Safety | Prevent out-of-range values |
Node Status
- 42 (in range) - Value passed through
- 100 (clamped, was 120) - Value was clamped at max
- 0 (clamped, was -5) - Value was clamped at min
- Invalid range - min >= max
Author
sr.rpo
License
MIT