@augment-vir/common/dist/augments/function/call-asynchronously.d.ts

A collection of augments, helpers types, functions, and classes for any JavaScript environment.

import { type MaybePromise } from '@augment-vir/core';
/**
 * Call a function asynchronously without interrupting current synchronous execution, even if the
 * function was originally synchronous.
 *
 * @category Function
 * @category Package : @augment-vir/common
 * @example
 *
 * ```ts
 * import {callAsynchronously} from '@augment-vir/common';
 *
 * console.info('1');
 * const later = callAsynchronously(() => {
 *     console.info('3');
 * });
 * console.info('2');
 * await later;
 *
 * // logs 1,2,3 in numeric order
 * ```
 *
 * @package [`@augment-vir/common`](https://www.npmjs.com/package/@augment-vir/common)
 */
export declare function callAsynchronously<T>(callback: () => MaybePromise<T>): Promise<T>;