Class PromiseEx<T, V>

Readonly[toStringTag]

Static Readonly[species]

catch

• catch<TResult>(onrejected?): Promise<T | TResult>

• Attaches a callback for only the rejection of the Promise.

  Type Parameters

  • TResult = never

  Parameters

  • Optionalonrejected: null | ((reason: any) => TResult | PromiseLike<TResult>)

    The callback to execute when the Promise is rejected.

  Returns Promise<T | TResult>

  A Promise for the completion of the callback.

finally

• finally(onfinally?): Promise<T>

• Attaches a callback that is invoked when the Promise is settled (fulfilled or rejected). The resolved value cannot be modified from the callback.

  Parameters

  • Optionalonfinally: null | (() => void)

    The callback to execute when the Promise is settled (fulfilled or rejected).

  Returns Promise<T>

  A Promise for the completion of the callback.

Staticall

• all<T>(values): Promise<Awaited<T>[]>

• Creates a Promise that is resolved with an array of results when all of the provided Promises resolve, or rejected when any Promise is rejected.

  Type Parameters

  • T

  Parameters

  • values: Iterable<T | PromiseLike<T>, any, any>

    An iterable of Promises.

  Returns Promise<Awaited<T>[]>

  A new Promise.
• all<T>(values): Promise<{
      -readonly [P in string | number | symbol]: Awaited<T[P<P>]>
  }>

• Creates a Promise that is resolved with an array of results when all of the provided Promises resolve, or rejected when any Promise is rejected.

  Type Parameters

  • T extends readonly unknown[] | []

  Parameters

  • values: T

    An array of Promises.

  Returns Promise<{
      -readonly [P in string | number | symbol]: Awaited<T[P<P>]>
  }>

  A new Promise.

StaticallSettled

• allSettled<T>(values): Promise<{
      -readonly [P in string | number | symbol]: PromiseSettledResult<Awaited<T[P<P>]>>
  }>

• Creates a Promise that is resolved with an array of results when all of the provided Promises resolve or reject.

  Type Parameters

  • T extends readonly unknown[] | []

  Parameters

  • values: T

    An array of Promises.

  Returns Promise<{
      -readonly [P in string | number | symbol]: PromiseSettledResult<Awaited<T[P<P>]>>
  }>

  A new Promise.
• allSettled<T>(values): Promise<PromiseSettledResult<Awaited<T>>[]>

• Creates a Promise that is resolved with an array of results when all of the provided Promises resolve or reject.

  Type Parameters

  • T

  Parameters

  • values: Iterable<T | PromiseLike<T>, any, any>

    An array of Promises.

  Returns Promise<PromiseSettledResult<Awaited<T>>[]>

  A new Promise.

Staticany

• any<T>(values): Promise<Awaited<T[number]>>

• The any function returns a promise that is fulfilled by the first given promise to be fulfilled, or rejected with an AggregateError containing an array of rejection reasons if all of the given promises are rejected. It resolves all elements of the passed iterable to promises as it runs this algorithm.

  Type Parameters

  • T extends readonly unknown[] | []

  Parameters

  • values: T

    An array or iterable of Promises.

  Returns Promise<Awaited<T[number]>>

  A new Promise.
• any<T>(values): Promise<Awaited<T>>

• The any function returns a promise that is fulfilled by the first given promise to be fulfilled, or rejected with an AggregateError containing an array of rejection reasons if all of the given promises are rejected. It resolves all elements of the passed iterable to promises as it runs this algorithm.

  Type Parameters

  • T

  Parameters

  • values: Iterable<T | PromiseLike<T>, any, any>

    An array or iterable of Promises.

  Returns Promise<Awaited<T>>

  A new Promise.

Staticrace

• race<T>(values): Promise<Awaited<T>>

• Creates a Promise that is resolved or rejected when any of the provided Promises are resolved or rejected.

  Type Parameters

  • T

  Parameters

  • values: Iterable<T | PromiseLike<T>, any, any>

    An iterable of Promises.

  Returns Promise<Awaited<T>>

  A new Promise.
• race<T>(values): Promise<Awaited<T[number]>>

• Creates a Promise that is resolved or rejected when any of the provided Promises are resolved or rejected.

  Type Parameters

  • T extends readonly unknown[] | []

  Parameters

  • values: T

    An array of Promises.

  Returns Promise<Awaited<T[number]>>

  A new Promise.

Staticreject

• reject<T>(reason?): Promise<T>

• Creates a new rejected promise for the provided reason.

  Type Parameters

  • T = never

  Parameters

  • Optionalreason: any

    The reason the promise was rejected.

  Returns Promise<T>

  A new rejected Promise.

Staticresolve

• resolve(): Promise<void>

• Creates a new resolved promise.

  Returns Promise<void>

  A resolved promise.
• resolve<T>(value): Promise<Awaited<T>>

• Creates a new resolved promise for the provided value.

  Type Parameters

  • T

  Parameters

  • value: T

    A promise.

  Returns Promise<Awaited<T>>

  A promise whose internal state matches the provided promise.
• resolve<T>(value): Promise<Awaited<T>>

• Creates a new resolved promise for the provided value.

  Type Parameters

  • T

  Parameters

  • value: T | PromiseLike<T>

    A promise.

  Returns Promise<Awaited<T>>

  A promise whose internal state matches the provided promise.

StaticwithResolvers

• withResolvers<T>(): PromiseWithResolvers<T>

• Creates a new Promise and returns it in an object, along with its resolve and reject functions.

  Type Parameters

  • T

  Returns PromiseWithResolvers<T>

  An object with the properties promise, resolve, and reject.

  const { promise, resolve, reject } = Promise.withResolvers<T>();
  Copy