Promise.allSettledKeyed()
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die statische Methode Promise.allSettledKeyed() ähnelt Promise.allSettled(), verwendet jedoch Objekte anstelle von Arrays/Iterables als Eingabe/Ausgabe. Sie nimmt ein Objekt entgegen, bei dem jeder eigene Schlüssel einem Promise zugeordnet ist, und gibt ein einzelnes Promise zurück. Dieses zurückgegebene Promise wird erfüllt, wenn alle Promises der Eingabe abgeschlossen sind, und zwar mit einem Objekt, dessen gleiche Schlüssel Objekten zugeordnet sind, die das Ergebnis des entsprechenden Promise beschreiben.
Im Vergleich zu Promise.allSettled() ermöglicht Promise.allSettledKeyed(), Ergebnisse semantisch aussagekräftigen Schlüsseln zuzuordnen, statt einer beliebigen Array-Reihenfolge, die schwer zu pflegen sein kann.
Syntax
Promise.allSettledKeyed(object)
Parameter
object-
Ein Objekt. Alle seine eigenen aufzählbaren Eigenschaften, unabhängig davon, ob der Schlüssel ein String oder ein Symbol ist, sollten
Promise-Werte haben. Diese Werte werden abgewartet, sodass auch andere Thenables aufgelöst werden, während Nicht-Thenables unverändert zurückgegeben werden.
Rückgabewert
Ein Promise, das:
-
Bereits erfüllt ist, wenn das übergebene
objectkeine eigenen aufzählbaren Eigenschaften hat. -
Asynchron erfüllt wird, wenn alle Promises im angegebenen
objectabgeschlossen sind (entweder erfüllt oder abgelehnt). Der Erfüllungswert ist ein Objekt mit denselben Schlüsseln in derselben Reihenfolge wie das angegebeneobject. Der Wert jeder Eigenschaft ist ein Objekt, das das Ergebnis des entsprechenden Promise inobjectbeschreibt, unabhängig von der Abschlussreihenfolge. 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"fulfilled"ist. Der Wert, mit dem das Promise erfüllt wurde. reason-
Nur vorhanden, wenn
status"rejected"ist. Der Grund, mit dem das Promise abgelehnt wurde.
Wenn das übergebene
objectnicht leer ist, aber keine ausstehenden Promises enthält, wird das zurückgegebene Promise dennoch asynchron (statt synchron) erfüllt.
Beschreibung
Die Methode Promise.allSettledKeyed() ist eine der Methoden für Promise-Nebenläufigkeit. Sie führt dieselbe Art von Aufgabe wie Promise.allSettled() aus. Promise.allSettledKeyed() wird bevorzugt, wenn Sie nicht bereits über ein Array von Promises verfügen und/oder die Ergebnisse sofort destrukturieren; weitere Informationen finden Sie unter Promise.allKeyed().
Beispiele
Verwendung von Promise.allSettledKeyed()
Die Methode Promise.allSettledKeyed() nimmt ein Objekt entgegen und verarbeitet alle seine eigenen aufzählbaren Eigenschaften.
function delayed(value, timeout) {
return new Promise((res) => setTimeout(() => res(value), timeout));
}
const sym = Symbol();
const promises = {
a: delayed("a", 500),
// Symbol properties are processed
[sym]: delayed("symbol", 300),
// Nested properties are not processed; this whole object is treated as
// an already-resolved value and returned as-is
nested: {
b: delayed("b", 100),
},
};
const result = await Promise.allSettledKeyed(promises);
console.log(result);
// {
// a: { status: "fulfilled", value: "a" },
// [sym]: { status: "fulfilled", value: "symbol" },
// nested: { status: "fulfilled", value: { b: <Promise> } },
// }
Weitere Beispiele zum Nebenläufigkeitsverhalten, das Promise.allSettled() und Promise.allSettledKeyed() gemeinsam haben, finden Sie unter Promise.allSettled().
Spezifikationen
| Spezifikation |
|---|
| Await Dictionary # sec-promise.allsettledkeyed |