Skip to content

AsyncEvents<EventMap>

A class that extends AsyncEventsBase and provides public methods for triggering events.

This class exists as parity with obsidian#Events. But exposing publicly trigger() methods violates encapsulation.

Avoid using it in favor of AsyncEventsBase.

Import:

import { AsyncEvents } from 'obsidian-dev-utils/async-events';

Signature:

export class AsyncEvents<EventMap extends EventMapConstraint<EventMap> = EventMapBase> extends AsyncEventsBase<EventMap>

Extends: AsyncEventsBase<EventMap>

Properties

PropertyTypeDescription
[ASYNC_EVENT_MAP]?EventMapPhantom marker that makes EventMap inferable from an AsyncEventSource (e.g. via Source extends AsyncEventSource<infer EventMap>). Never present at runtime.
(Inherited from AsyncEventsBase)
eventRefsMapMap<string, AsyncEventRef[]>The registry mapping each event name to its list of registered listener references.
(Inherited from AsyncEventsBase)

Methods

MethodReturnsDescription
off(name, callback)voidRemove an event listener.
(Inherited from AsyncEventsBase)
offref(eventRef)voidRemove an event listener by reference.
(Inherited from AsyncEventsBase)
on(name, callback, thisArg?)AsyncEventRefAdd an event listener.
(Inherited from AsyncEventsBase)
once(name, callback, thisArg?)AsyncEventRefAdd an event listener that will be triggered only once.
(Inherited from AsyncEventsBase)
trigger(name, args?)voidTrigger an event, executing all the listeners in order even if some of them throw an error.
triggerAsync(name, args?)Promise<void>Trigger an event asynchronously, executing all the listeners in order even if some of them throw an error.
tryTrigger(eventRef, args)voidTry to trigger an event, executing all the listeners in order even if some of them throw an error.
tryTriggerAsync(eventRef, args)Promise<void>Try to trigger an event asynchronously, executing all the listeners in order even if some of them throw an error.