Class EventHostImpl<EventMap>

An object that may dispatch events and have handlers for those events. Similar to the DOM's EventTarget, this is a basic event system based on event naming.

Some of the advantages of EventHost over EventTarget:

  • Not all supported platforms support EventTarget construction or extension.
  • EventTarget is designed for the DOM, with bubble and capture phases not necessary in Vinyl.
  • Event types are strict.
  • Events can be plain objects, no need to extend CustomEvent.
  • Easier unsubscription and disposal; reduces the risk of memory leaks.

EventHost supports concurrent modification, that is, handlers may be added or removed during the execution of another handler.

Type Parameters

  • EventMap

Hierarchy (view full)

Implements

Constructors

constructor

Properties

logPrefix

Accessors

[toStringTag]

Methods

dispatch dispose hasAnyListeners hasListeners on

Constructors

constructor

Properties

ReadonlylogPrefix

logPrefix: string = ...

A string prefix for all log statements made by this target.

Accessors

[toStringTag]

  • get [toStringTag](): string

  • Returns string

Methods

dispatch

  • dispatch<K>(type, event): void

  • Dispatches an event.

    Type Parameters

    • K extends string | number | symbol

    Parameters

    • type: K

      The key of the event within EventMap

    • event: EventMap[K]

      If the passed event is read-only, then it may be re-used/cached. Otherwise, it should be a new event object every dispatch. If no target property is set on the event, the target will be set to this host.

    Returns void

dispose

  • dispose(): void

  • Returns void

hasAnyListeners

  • hasAnyListeners(): boolean

  • Returns true if the event host has any listeners.

    Returns boolean

hasListeners

  • hasListeners(type): boolean

  • Returns true if the event host has any listeners for the given type.

    Parameters

    Returns boolean

on

  • on<K>(type, handler, options?): Unsubscribe

  • Adds an event handler for the given typed event.

    Type Parameters

    • K extends string | number | symbol

    Parameters

    • type: K

      The key representing the event type to listen for.

    • handler: EventHandler<EventMap[K]>

      A callback to invoke when the event with the given type is dispatched.

    • Optionaloptions: SignalOptions

      Options for changing listening behavior.

    Returns Unsubscribe

    Returns a method, when invoked, removes the handler.

Settings

Member Visibility

On This Page

Constructors
Properties
Accessors
Methods