vovchisko / a-signal

declarative alternative for event emitters

"Russian Warship - Go Fuck yourself." 🇺🇦

Oh, hi!

Nice to see you here!

My name is Volodymyr Ishchenko. I'm a Full-stack Developer, UI/UX designer from Ukraine. Love JavaScript, NodeJs, and Vue. Programming for fun and living.

🔗 Home LinkedIn Stackoverflow GitHub NPM Twitter Instagram Discord ArtStation Dribble

---

🌊 DigitalOcean Referral

a-signal's Issues

Signal.all() - waiting for n-signals or one of signals

Let's say we have an entity with multiple signals: A, B, C. After init, we call connect and expect one of the signals fired. Once it fired - all other binds should be removed. (works only with .once())

The possible syntax could be:

const thing = {
   onA: new Sig(),
   onB: new Sig(),
   onC: new Sig(),
   // ...
}

const bindA = thing.onA.once(...)
const bindB = thing.onB.once(...)
const bindC = thing.onC.once(...)

bindA.onlyOne([bindB, bindC]) // now if any of this binds fires (A,B or C) all other binds are off.

Could be achieved with:

await Promise.all([
   thing.onA.wait(),
   thing.onB.wait(),
   thing.onC.wait(),
])

Or, It could be sugared with some helper:

import Signal from 'a-signal'

await Signal.all(thing.onA, thing.onB, thing.onC)
// or
await Signal.any(thing.onA, thing.onB, thing.onC)

signal.wait fires in reverse order

Stacked signals should fire in the natural order.

Async "await once" sugar

More async sugar. 🍬

const sig = new Signal()

setTimeout(() => {
     sig.emit()
}, 1000)

// sweet way of .once()
await sig.wait()

await sig.wait(200) // will throw error
// or
await sig.wait(5000) // fits

Clear memory on memorable signals

Currently, there is no way to clear args/called from the last emit without accessing Signal.args and Signal.emited.

Let's add Signal.flush() to clear emited flag (and args).

More extracted methods

a.loaded = sig.getEmitter() 
a.whenLoaded = sig.getSubscriber() 
a.onceLoaded = sig.getSubscriberOnce() 

a.loaded(()=>console.log('loaded')) // the same as sig.on(<cb>)
a.emit() // the same as sig.emit()
e.onceLoaded()

TBD