Запропонувати правку

Покращити цю статтю

Допрацюйте відповідь до «Promise.allSettled() у JavaScript». Ваші зміни проходять модерацію перед публікацією.

Потрібне підтвердження

Контент

Що ви змінюєте

Заголовок (UA)

Коротка відповідь (UA)

Показується над повною відповіддю для швидкого нагадування.

Відповідь (UA)

**`Promise.allSettled()` це статичний метод, який приймає масив (або інший ітерований об'єкт) промісів і повертає новий проміс, що виконується, коли всі передані проміси завершаться.** Не має значення, чи завершились вони успішно (`fulfilled`), чи з помилкою (`rejected`): метод чекає на *усі результати*, а не лише на успішні.

## Теорія

### TL;DR
- `Promise.allSettled(iterable)` чекає, поки **всі** проміси завершаться будь-яким чином.
- Повернений проміс **завжди** переходить у стан `fulfilled`, він не відхиляється ніколи.
- Значення це масив об'єктів `{status, value}` або `{status, reason}` у порядку входу.
- `Promise.all()` натомість відхиляється на першому ж `reject` і губить решту результатів.
- Типове застосування: масове завантаження даних, паралельна валідація, пакетне надсилання запитів.

### Швидкий приклад
```javascript
const p1 = Promise.resolve('Успішно');
const p2 = Promise.reject('Помилка');
const p3 = Promise.resolve('Ще одне');

Promise.allSettled([p1, p2, p3])
  .then(results => console.log(results));
```

Вивід:

```javascript
[
  { status: "fulfilled", value: "Успішно" },
  { status: "rejected", reason: "Помилка" },
  { status: "fulfilled", value: "Ще одне" }
]
```

Усі проміси завершились, метод не «впав», а повернув повне зведення: хто виконався, а хто впав.

Синтаксис:

```javascript
Promise.allSettled(iterable)
```

Повертає новий проміс, який **завжди** переходить у стан `fulfilled` і віддає **масив об'єктів** з результатами.

### Структура результату
Кожен елемент масиву це об'єкт з однаковим набором полів:

| Поле | Коли з'являється | Значення |
| --- | --- | --- |
| `status` | завжди | `"fulfilled"` або `"rejected"` |
| `value` | якщо `fulfilled` | результат проміса |
| `reason` | якщо `rejected` | причина помилки |

Порядок елементів відповідає порядку вхідних промісів, тому результат легко зіставити з початковим списком за індексом.

### Коли використовувати Promise.allSettled()
- Коли важливо **дочекатися завершення всіх операцій**, навіть якщо частина з них завершиться з помилкою.
- Коли потрібно зібрати **всі результати та помилки разом**, в одному звіті.
- Наприклад, при **масовому завантаженні даних**, **паралельній валідації**, **пакетному надсиланні запитів**, **очищенні даних** тощо.

### Відмінність від Promise.all()

| Характеристика | `Promise.all()` | `Promise.allSettled()` |
| --- | --- | --- |
| Коли завершиться | Тільки якщо **всі проміси успішні** | Коли **всі проміси завершаться** (з будь-яким результатом) |
| Що повертає | Масив значень `value` | Масив об'єктів `{status, value/reason}` |
| Поведінка при помилці | «Падає» на першому ж `reject` | Не падає, чекає на всіх |
| Стан поверненого проміса | Може бути `fulfilled` або `rejected` | Завжди `fulfilled` |
| Для чого використовують | Коли важливо, щоб усе пройшло успішно | Коли важливо отримати звіт про всі результати |

Приклад порівняння:

```javascript
const a = Promise.resolve('A');
const b = Promise.reject('Помилка');
const c = Promise.resolve('C');

// Promise.all
Promise.all([a, b, c])
  .then(console.log)
  .catch(err => console.error('Promise.all:', err));

// Promise.allSettled
Promise.allSettled([a, b, c])
  .then(console.log);
```

Вивід:

```javascript
Promise.all: Помилка
[
  { status: 'fulfilled', value: 'A' },
  { status: 'rejected', reason: 'Помилка' },
  { status: 'fulfilled', value: 'C' }
]
```

`Promise.all()` зупинився на помилці, а `Promise.allSettled()` дочекався всіх і повернув повний звіт.

### Практичний приклад
Уявіть, що потрібно завантажити дані з кількох джерел, і навіть якщо одне недоступне, решта все одно потрібні:

```javascript
const urls = ['/user', '/posts', '/comments'];

const requests = urls.map(url => fetch(url));

Promise.allSettled(requests)
  .then(results => {
    results.forEach((res, i) => {
      if (res.status === 'fulfilled') {
        console.log(`${urls[i]}: OK`);
      } else {
        console.warn(`${urls[i]}: помилка`);
      }
    });
  });
```

Так ви отримуєте **підсумок по всіх запитах**, навіть якщо один із них «впав».

Проста аналогія:

> Уявіть, що ви замовили три доставки:
>
> - `Promise.all()`: якщо хоча б одна доставка не дійшла, ви **одразу засмучуєтесь** і не чекаєте на решту.
> - `Promise.allSettled()`: ви **чекаєте на всіх кур'єрів**, навіть якщо хтось прийшов без посилки, щоб знати, **що сталося з кожною доставкою**.

Підсумкова таблиця:

| Метод | Поведінка при помилці | Що повертає | Коли завершиться |
| --- | --- | --- | --- |
| `Promise.all()` | «Падає» на першому `reject` | Масив успішних значень | Коли **всі успішні** |
| `Promise.allSettled()` | Не «падає» ніколи | Масив `{status, value/reason}` | Коли **всі завершені** |

### Типові помилки
- **Чіпляти `.catch()` і чекати, що він спрацює.** Проміс від `allSettled()` не відхиляється, тому помилки треба шукати в елементах масиву зі `status === 'rejected'`, інакше збій пройде непоміченим.
- **Плутати `value` і `reason`.** У відхиленого елемента немає `value`, у виконаного немає `reason`: спершу перевіряйте `status`.
- **Думати, що `allSettled()` робить код стійкішим сам собою.** Він лише збирає звіт, а логіку повторів чи деградації ви пишете самі.
- **Забувати про HTTP помилки у `fetch`.** `fetch` відхиляється лише на мережевій помилці, тому відповідь зі статусом 500 потрапить у `fulfilled`, і `res.ok` треба перевіряти окремо.
- **Брати `allSettled()` там, де потрібен fail-fast.** Якщо перший збій робить решту роботи безглуздою, `Promise.all()` завершиться швидше і заощадить ресурси.

Markdown · перетягуйте зображення · ⌘B / ⌘I шорткати760 слів

Для рев’юера

Примітка для модератора (необов’язково)

Бачить лише модератор. Прискорює рев’ю.