Promise.allSettled()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2020 browserübergreifend verfügbar.

Die statische Methode Promise.allSettled() nimmt ein Iterable von Promises als Eingabe entgegen und gibt ein einzelnes Promise zurück. Dieses zurückgegebene Promise wird erfüllt, wenn alle Promises der Eingabe abgeschlossen sind (einschließlich wenn ein leeres Iterable übergeben wird), mit einem Array von Objekten, die das Ergebnis jedes einzelnen Promises beschreiben.

In diesem Artikel

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

Rückgabewert

Ein Promise, das:

Bereits erfüllt ist, wenn das übergebene iterable leer ist.
Asynchron erfüllt ist, wenn alle Promises im gegebenen iterable abgeschlossen sind (entweder erfüllt oder abgelehnt). Der Erfüllungswert ist ein Array von Objekten, von denen jedes das Ergebnis eines Promises im iterable beschreibt, in der Reihenfolge der übergebenen Promises, unabhängig von der Reihenfolge des Abschlusses. Jedes Ergebnisobjekt hat die folgenden Eigenschaften:
status
Ein String, entweder "fulfilled" oder "rejected", der den endgültigen Zustand des Promises angibt.
value
Nur vorhanden, wenn status "fulfilled" ist. Der Wert, mit dem das Promise erfüllt wurde.
reason
Nur vorhanden, wenn status "rejected" ist. Der Grund, aus dem das Promise abgelehnt wurde.

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

Beschreibung

Die Promise.allSettled() Methode ist eine der Methoden für Promise-Konkurrenz. Promise.allSettled() wird typischerweise verwendet, wenn Sie mehrere asynchrone Aufgaben haben, die nicht voneinander abhängig sind, um erfolgreich abgeschlossen zu werden, oder wenn Sie das Ergebnis jedes Promises wissen möchten.

Im Vergleich dazu könnte das von Promise.all() zurückgegebene Promise geeigneter sein, wenn die Aufgaben voneinander abhängig sind, oder wenn Sie bei einer Ablehnung einer davon sofort ablehnen möchten.

Beispiele

Verwendung von Promise.allSettled()

js
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 }
// ]

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Eingebaute Standardobjekte
Promise
Konstruktor
1. Promise()
Statische Methoden
Statische Eigenschaften
1. [Symbol.species]
Instanzmethoden
Vererbung
Object/Function
Statische Methoden
Statische Eigenschaften
Instanzmethoden
Instanzeigenschaften
1. __proto__
2. constructor