allSettled

allSettled sends multiple requests in a single fetch.

Type definition

export type BatchedPromise<T extends readonly IntegroPromise<unknown>[] | []> =
  IntegroPromise<{ -readonly [P in keyof T]: PromiseSettledResult<Awaited<T[P]>>; }>
  & [...{ -readonly [P in keyof T]: IntegroPromise<Awaited<T[P]>>; }, () => BatchedPromise<T>];

const allSettled: <T extends readonly IntegroPromise<unknown>[] | []>(values: T) => BatchedPromise<T>;

allSettled is typed the same as Promise.allSettled. Batch results are typed as PromiseSettledResult:

/// lib.es2020.promise.d.ts

interface PromiseFulfilledResult<T> {
    status: "fulfilled";
    value: T;
}

interface PromiseRejectedResult {
    status: "rejected";
    reason: any;
}

type PromiseSettledResult<T> = PromiseFulfilledResult<T> | PromiseRejectedResult;

Usage

const [res1, res2, res3] = await allSettled([
  api.artists.findById(validId1),
  api.artists.findById(validId2),
  api.artists.findById(invalidId),
]);

console.log(res1); // -> { status: 'fulfilled', value: { ... } }
console.log(res2); // -> { status: 'fulfilled', value: { ... } }
console.log(res3); // -> { status: 'rejected', reason: { ... } }

Parameters

promises

Type: IntegroPromise[]
Required: true

The API promises to allSettled together.