import {PartialObserver, Subject, Subscription} from 'rxjs'; /** * Use in components with the `@Output` directive to emit custom events * synchronously or asynchronously, and register handlers for those events * by subscribing to an instance. * * @usageNotes * * Extends * [RxJS `Subject`](https://rxjs.dev/api/index/class/Subject) * for Angular by adding the `emit()` method. * * In the following example, a component defines two output properties * that create event emitters. When the title is clicked, the emitter * emits an open or close event to toggle the current visibility state. * * ```html * @Component({ * selector: 'zippy', * template: ` *
*
Toggle
*
* *
*
`}) * export class Zippy { * visible: boolean = true; * @Output() open: EventEmitter = new EventEmitter(); * @Output() close: EventEmitter = new EventEmitter(); * * toggle() { * this.visible = !this.visible; * if (this.visible) { * this.open.emit(null); * } else { * this.close.emit(null); * } * } * } * ``` * * Access the event object with the `$event` argument passed to the output event * handler: * * ```html * * ``` * * @see [Observables in Angular](guide/observables-in-angular) * @publicApi */ export interface EventEmitter extends Subject { /** * @internal */ __isAsync: boolean; /** * Creates an instance of this class that can * deliver events synchronously or asynchronously. * * @param [isAsync=false] When true, deliver events asynchronously. * */ new(isAsync?: boolean): EventEmitter; /** * Emits an event containing a given value. * @param value The value to emit. */ emit(value?: T): void; /** * Registers handlers for events emitted by this instance. * @param next When supplied, a custom handler for emitted events. * @param error When supplied, a custom handler for an error notification from this emitter. * @param complete When supplied, a custom handler for a completion notification from this * emitter. */ subscribe(next?: (value: T) => void, error?: (error: any) => void, complete?: () => void): Subscription; /** * Registers handlers for events emitted by this instance. * @param observerOrNext When supplied, a custom handler for emitted events, or an observer * object. * @param error When supplied, a custom handler for an error notification from this emitter. * @param complete When supplied, a custom handler for a completion notification from this * emitter. */ subscribe(observerOrNext?: any, error?: any, complete?: any): Subscription; } class EventEmitter_ extends Subject { __isAsync: boolean; // tslint:disable-line constructor(isAsync: boolean = false) { super(); this.__isAsync = isAsync; } emit(value?: any) { super.next(value); } override subscribe(observerOrNext?: any, error?: any, complete?: any): Subscription { let nextFn = observerOrNext; let errorFn = error || (() => null); let completeFn = complete; if (observerOrNext && typeof observerOrNext === 'object') { const observer = observerOrNext as PartialObserver; nextFn = observer.next?.bind(observer); errorFn = observer.error?.bind(observer); completeFn = observer.complete?.bind(observer); } if (this.__isAsync) { errorFn = _wrapInTimeout(errorFn); if (nextFn) { nextFn = _wrapInTimeout(nextFn); } if (completeFn) { completeFn = _wrapInTimeout(completeFn); } } const sink = super.subscribe({next: nextFn, error: errorFn, complete: completeFn}); if (observerOrNext instanceof Subscription) { observerOrNext.add(sink); } return sink; } } function _wrapInTimeout(fn: (value: unknown) => any) { return (value: unknown) => { setTimeout(fn, undefined, value); }; } /** * @publicApi */ export const EventEmitter: { new (isAsync?: boolean): EventEmitter; new(isAsync?: boolean): EventEmitter; readonly prototype: EventEmitter; } = EventEmitter_ as any;