@webreflection/signal
![build status](https://github.com/WebReflection/signal/actions/workflows/node.js.yml/badge.svg)
Social Media Photo by Louis Reed on Unsplash
A minimalistic signals implementation, derived from the post Signals: the nitty-gritty, which size, once minified and brotlied, is 528 bytes.
- no automatic effect disposal except when an outer effect has inner effects and the outer effect
dispose()
is invoked - computed are lazily initialied but updated per each signal change they depend on, unless a
batch
operation is updating all inner signals at once - no fancy features from other libraries
For anything more complex please check usignal out.
exports
signal(value)
to create a new signal with a reactive .value
computed(fn[, initialValue])
to create a computed signal with a read-only .value
effect(fn)
to create an effect and return a dispose functionbatch(fn)
to update multiple signals at once and invoke related effects onceuntracked(fn)
to make a callback that can read some signals without subscription to themSignal
to compare via instanceof Signal
instancesComputed
to compare via instanceof Computed
instances
Computed accepts an initial value to pass to the callback. The callback will keep receiving the previous value on each new invoke.
example
import {signal, effect} from '@webreflection/signal';
const single = signal(1);
const double = signal(10);
const triple = signal(100);
const dispose1 = effect(() => {
console.log(`
#1 effect
single: ${single}
double: ${double}
`);
});
const dispose2 = effect(() => {
console.log(`
#2 effect
double: ${double}
triple: ${triple}
`);
});
++double.value;
dispose2();
++double.value;