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 von Promises (beispielsweise ein Array). 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

Eine Promise, die:

• 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 einer Promise im iterable. Die Reihenfolge entspricht der Reihenfolge der übergebenen Promises, unabhängig davon, wann sie abgeschlossen werden. Jedes Ergebnisobjekt hat die folgenden Eigenschaften:

  status

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

  value

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

  reason

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

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

Beschreibung

Die Methode Promise.allSettled() gehört zu den Methoden für die Promise-Konkurrenz. Promise.allSettled() wird üblicherweise verwendet, wenn mehrere asynchrone Aufgaben unabhängig voneinander erfolgreich abgeschlossen werden können oder wenn Sie das Ergebnis jeder Promise in jedem Fall erfahren möchten.

Im Vergleich dazu ist die von Promise.all() zurückgegebene Promise möglicherweise besser geeignet, wenn die Aufgaben voneinander abhängen oder wenn die zurückgegebene Promise sofort zurückgewiesen werden soll, sobald eine 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, um für jedes Ergebnis eine eigene Variable zu 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 jeder Eingabe und Ausgabe 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()