emitValuev1

emitValuev1 is a function in the ValueEvent library designed to dispatch a value to registered listeners. It represents the first release in the library's emitValue API family and is intended for straightforward value propagation in event-driven code.

When invoked, emitValuev1 sends the supplied value to all active subscribers that have registered with the emitter. It accepts a required value parameter and an optional options object. The value may be any serializable data; options can include a timestamp, a tag, and a flag to perform asynchronous emission. The call returns an emission result object that reports success and the number of listeners notified.

Usage examples: emitValuev1({ key: 'color', value: 'blue' }, { timestamp: Date.now() }); If no listeners are present, the function resolves to a result indicating zero notified listeners. Error handling follows the library’s standard patterns and does not throw unless a misconfigured emitter is detected.

The function is designed to be lightweight and dependency free, suitable for inclusion in browser or server environments. It emphasizes immutability of the emitted value and predictable timing of notifications.

See also: onValue, subscribe, emitValue (future versions).