CKTIS / JavaScript
Rekordy wyników Promise.allSettled()
Metoda `Promise.allSettled()` zwraca obietnicę, która po zakończeniu wszystkich obietnic wejściowych spełnia się tablicą wyników w kolejności wejścia. Pole `status` wskazuje, czy odczytać `value`, czy `reason`.
Wersja: ECMAScript 2024 and the current web platform; runtime support varies
Składnia
Promise.allSettled(iterable)
// Each element of the array that the returned promise fulfills with:
// { status: "fulfilled", value: … }
// { status: "rejected", reason: … }Promise.allSettled(iterable) to statyczna metoda Promise, która przyjmuje synchroniczny obiekt iterowalny, na przykład tablicę. Każdy element jest przetwarzany jak przez Promise.resolve(): uwzględniane jest zachowanie obiektów typu thenable, a zwykła wartość staje się wartością spełnienia. Gdy wszystkie obietnice zostaną spełnione lub odrzucone, zwrócona obietnica spełnia się tablicą zawierającą po jednym wyniku na element, w kolejności iteracji, a nie zakończenia.
Każdy rekord wyniku to zwykły obiekt JavaScript. Rekord ze status: "fulfilled" ma własną właściwość value, ale nie ma własnej właściwości reason. Rekord ze status: "rejected" ma własną właściwość reason, ale nie ma własnej właściwości value. Najpierw sprawdź status: wartość 0 lub undefined może być prawidłową wartością spełnienia, a powód odrzucenia nie musi być obiektem Error i również może być undefined.
W przeciwieństwie do Promise.all() odrzucenie pojedynczej obietnicy jest zapisywane w tablicy i samo nie powoduje odrzucenia obietnicy zbiorczej. To przydatne, gdy chcesz zachować udane wyniki niezależnych zadań i osobno obsłużyć niepowodzenia. Błąd podczas odczytu obiektu iterowalnego nadal może odrzucić obietnicę zbiorczą, zamiast utworzyć rekord wyniku.
Dla pustego wejścia metoda zwraca obietnicę już spełnioną wartością [], ale funkcja przekazana do .then() nadal wykonuje się asynchronicznie. Dla niepustego wejścia, przy standardowym działaniu metod obietnic, obietnica zbiorcza pozostaje w stanie oczekiwania w chwili zwrotu, nawet jeśli żadna obietnica wejściowa już nie oczekuje. Obietnica zbiorcza może jednak być spełniona już w chwili zwrotu, jeśli jedynym elementem wejścia jest natywna obietnica, którą Promise.resolve() zwraca bez zmian i której własna metoda then synchronicznie wywołuje funkcję obsługującą spełnienie.
Przykłady
{
let finishFirst;
const first = new Promise((resolve) => { finishFirst = resolve; });
const second = Promise.reject("offline");
const batch = Promise.allSettled([first, second, 0]);
finishFirst("profile");
batch.then((results) => {
console.log(JSON.stringify(results));
for (const result of results) {
if (result.status === "fulfilled") {
console.log(`value: ${result.value}`);
} else {
console.log(`reason: ${result.reason}`);
}
}
});
}Wynik
[{"status":"fulfilled","value":"profile"},{"status":"rejected","reason":"offline"},{"status":"fulfilled","value":0}]
value: profile
reason: offline
value: 0Druga obietnica zostaje odrzucona przed spełnieniem pierwszej, ale jej rekord nadal znajduje się na drugiej pozycji. Zwykła wartość `0` daje rekord ze statusem `"fulfilled"`.
Powiązane lekcje
- JavaScript · Lekcja 15 · Średniozaawansowany · Wersja: 3