Promise.allSettled()

Probieren Sie es aus

const promise1 = Promise.resolve(3);
const promise2 = new Promise((resolve, reject) =>
  setTimeout(reject, 100, "foo"),
);
const promises = [promise1, promise2];

Promise.allSettled(promises).then((results) =>
  results.forEach((result) => console.log(result.status)),
);

// Expected output:
// "fulfilled"
// "rejected"

Syntax

Promise.allSettled(iterable)

Parameter

iterable

Ein Iterable (beispielsweise ein Array) von Promises. Auf diese Werte wird mit await gewartet. Daher werden auch andere Thenables aufgelöst, während Werte, die keine Thenables sind, unverändert zurückgegeben werden.

Rückgabewert

Ein Promise, das:

• bereits erfüllt ist, wenn das übergebene iterable leer ist.

• asynchron erfüllt wird, sobald alle Promises im übergebenen iterable abgeschlossen sind (entweder erfüllt oder zurückgewiesen). Der Erfüllungswert ist ein Array von Objekten. Jedes Objekt beschreibt das Ergebnis eines Promise aus dem iterable. Die Reihenfolge entspricht der Reihenfolge der übergebenen Promises, unabhängig davon, wann sie abgeschlossen wurden. Jedes Ergebnisobjekt hat die folgenden Eigenschaften:

  status

  Ein String, entweder "fulfilled" oder "rejected", der den endgültigen Zustand des Promise angibt.

  value

  Nur vorhanden, wenn status den Wert "fulfilled" hat. Der Wert, mit dem das Promise erfüllt wurde.

  reason

  Nur vorhanden, wenn status den Wert "rejected" hat. Der Grund, aus dem das Promise zurückgewiesen wurde.

  Wenn das übergebene iterable nicht leer ist, aber keine ausstehenden Promises enthält, wird das zurückgegebene Promise dennoch asynchron (und nicht synchron) erfüllt.

Beschreibung

Die Methode Promise.allSettled() gehört zu den Methoden für die nebenläufige Verarbeitung von Promises. Promise.allSettled() wird typischerweise verwendet, wenn mehrere asynchrone Aufgaben unabhängig voneinander erfolgreich abgeschlossen werden können oder wenn Sie in jedem Fall das Ergebnis jedes Promise erfahren möchten.

Im Vergleich dazu kann das von Promise.all() zurückgegebene Promise besser geeignet sein, wenn die Aufgaben voneinander abhängen oder wenn das zurückgegebene Promise sofort zurückgewiesen werden soll, sobald eines der übergebenen Promises zurückgewiesen wird.

Beispiele

Promise.allSettled() verwenden

Promise.allSettled([
  Promise.resolve(33),
  new Promise((resolve) => setTimeout(() => resolve(66), 0)),
  99,
  Promise.reject(new Error("an error")),
]).then((values) => console.log(values));

// [
//   { status: 'fulfilled', value: 33 },
//   { status: 'fulfilled', value: 66 },
//   { status: 'fulfilled', value: 99 },
//   { status: 'rejected', reason: Error: an error }
// ]

Sie können die Ergebnisse auch destrukturieren, sodass Sie für jedes Ergebnis eine eigene Variable erhalten.

const [status1, status2] = await Promise.allSettled([
  Promise.resolve(33),
  new Promise((resolve) => setTimeout(() => resolve(66), 0)),
]);

// status1 = { status: 'fulfilled', value: 33 }
// status2 = { status: 'fulfilled', value: 66 }

Wenn Sie das Ergebnis destrukturieren, müssen die Ergebnisvariablen in derselben Reihenfolge stehen wie die übergebenen Promises. Eine abweichende Reihenfolge kann schwer erkennbare Fehler verursachen. Die Methode Promise.allSettledKeyed() vermeidet dieses Problem, indem sie jedem Eingabe- und Ausgabewert einen Schlüssel zuordnet.

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill für Promise.allSettled in core-js
• Polyfill für Promise.allSettled von es-shims
• Promises verwenden – Leitfaden
• Robuste asynchrone Programmierung mit Promises
• Promise
• Promise.all()
• Promise.allSettledKeyed()
• Promise.any()
• Promise.race()