Class WebPlugin

core/src/web-plugin.ts:9–136

 * Base class web plugins should extend.
 */
export class WebPlugin implements Plugin {
  protected listeners: { [eventName: string]: ListenerCallback[] } = {};
  protected retainedEventArguments: { [eventName: string]: any[] } = {};
  protected windowListeners: { [eventName: string]: WindowListenerHandle } = {};

  addListener(eventName: string, listenerFunc: ListenerCallback): Promise<PluginListenerHandle> {
    let firstListener = false;

    const listeners = this.listeners[eventName];
    if (!listeners) {
      this.listeners[eventName] = [];
      firstListener = true;
    }

    this.listeners[eventName].push(listenerFunc);

    // If we haven't added a window listener for this event and it requires one,
    // go ahead and add it
    const windowListener = this.windowListeners[eventName];
    if (windowListener && !windowListener.registered) {
      this.addWindowListener(windowListener);
    }

    if (firstListener) {
      this.sendRetainedArgumentsForEvent(eventName);
    }

    const remove = async () => this.removeListener(eventName, listenerFunc);

    const p: any = Promise.resolve({ remove });

    return p;
  }

  async removeAllListeners(): Promise<void> {
    this.listeners = {};
    for (const listener in this.windowListeners) {
      this.removeWindowListener(this.windowListeners[listener]);
    }
    this.windowListeners = {};
  }

  protected notifyListeners(eventName: string, data: any, retainUntilConsumed?: boolean): void {
    const listeners = this.listeners[eventName];
    if (!listeners) {
      if (retainUntilConsumed) {
        let args = this.retainedEventArguments[eventName];
        if (!args) {
          args = [];
        }

        args.push(data);

        this.retainedEventArguments[eventName] = args;
      }

      return;
    }