@ayonli/jsext/types/augment/promise.d.ts

A JavaScript extension package for building strong and modern applications.

declare global {
    interface PromiseConstructor {
        /** Try to resolve a promise with a timeout limit. */
        timeout<T>(value: PromiseLike<T>, ms: number): Promise<T>;
        /** Resolves a promise only after the given duration. */
        after<T>(value: PromiseLike<T>, ms: number): Promise<T>;
        /** Blocks the context for a given duration. */
        sleep(ms: number): Promise<void>;
        /**
         * Blocks the context until the test returns a truthy value, which is not `false`,
         * `null` or `undefined`. If the test throws an error, it will be treated as a
         * falsy value and the loop continues.
         *
         * This functions returns the same result as the test function when passed.
         */
        until<T>(test: () => T | PromiseLike<T>): Promise<T extends false | null | undefined ? never : T>;
        /**
         * Runs multiple tasks concurrently and returns the result of the first task that
         * completes. The rest of the tasks will be aborted.
         */
        select<T>(tasks: (PromiseLike<T> | ((signal: AbortSignal) => PromiseLike<T>))[], signal?: AbortSignal | undefined): Promise<T>;
    }
}
export {};