Function emit

Extension/src/Utility/Eventing/dispatcher.ts:406–426

(name: string, ...variableArgs: any[])

export async function emit<TResult>(name: string, text: string, data: ArbitraryObject): Promise<TResult | EventStatus>;
export async function emit<TResult>(name: string): Promise<TResult | EventStatus>;
export async function emit<TResult>(name: string, ...variableArgs: any[]): Promise<TResult | EventStatus> {
    // quickly check if there are any possible handlers for this event
    if (isSubscribed(name)) {
        const descriptors = variableArgs[0] instanceof Descriptors ? variableArgs.shift() : Descriptors.none;

        // create a promise that will be resolved when the event is dispatched
        const result = new ManualPromise<TResult | EventStatus>();

        // add the event to the queue
        queue.push(expandVariableArgs(variableArgs, { name, variableArgs, descriptors, completed: result }));

        // if the queue was empty, start it draining the queue
        if (DispatcherBusy.isCompleted) {
            void drain(); // don't wait for the queue to finish draining
        }

        // return the promise
        return result;
    }
    return Continue;
}

/** immediately dispatches an event */
export async function emitNow<TResult>(name: string, descriptors: Descriptors, text: string): Promise<TResult | EventStatus>;