@wordpress/data/src/utils/emitter.ts

Data module for WordPress.

export interface DataEmitter {
	emit: VoidFunction;
	subscribe: ( listener: VoidFunction ) => VoidFunction;
	pause: VoidFunction;
	resume: VoidFunction;
	isPaused: boolean;
}

/**
 * Create an event emitter.
 *
 * @return The event emitter.
 */
export function createEmitter(): DataEmitter {
	let isPaused = false;
	let isPending = false;
	const listeners = new Set< VoidFunction >();
	const notifyListeners = () =>
		// We use Array.from to clone the listeners Set
		// This ensures that we don't run a listener
		// that was added as a response to another listener.
		Array.from( listeners ).forEach( ( listener ) => listener() );

	return {
		get isPaused() {
			return isPaused;
		},

		subscribe( listener ) {
			listeners.add( listener );
			return () => listeners.delete( listener );
		},

		pause() {
			isPaused = true;
		},

		resume() {
			isPaused = false;
			if ( isPending ) {
				isPending = false;
				notifyListeners();
			}
		},

		emit() {
			if ( isPaused ) {
				isPending = true;
				return;
			}
			notifyListeners();
		},
	};
}