Skip to content

Commit

Permalink
Дополняет и уточняет
Browse files Browse the repository at this point in the history
  • Loading branch information
vitya-ne committed Nov 21, 2024
1 parent 5db96c1 commit 949b118
Showing 1 changed file with 43 additions and 5 deletions.
48 changes: 43 additions & 5 deletions js/promise-race/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,8 @@ title: "`Promise.race()`"
description: "Запускаем несколько промисов и дожидаемся того, который выполнится быстрее."
authors:
- agarkov
contributors:
- vitya-ne
related:
- tools/api
- js/async-in-js
Expand All @@ -19,13 +21,13 @@ tags:

## Кратко

Метод `race()` — это один из статических методов объекта `Promise`. Его используют, чтобы запустить несколько промисов и дождаться того, который выполнится быстрее.
Метод `race()` — это один из статических методов объекта `Promise`. Его используют, чтобы запустить несколько промисов и получить результат того, который выполнится быстрее.

## Как пишется

`Promise.race()` принимает итерируемую коллекцию промисов, чаще всего — [массив](/js/arrays/). Потом метод возвращает новый промис.
`Promise.race()` принимает итерируемую коллекцию промисов, чаще всего — [массив](/js/arrays/).

Метод завершится, когда завершится самый быстрый из всех переданных. Остальные промисы будут проигнорированы.
Метод возвращает новый промис, который завершится, когда будет получен первый результат или ошибка от переданных промисов. Результаты или ошибки остальных промисов будут проигнорированы.

## Как понять

Expand Down Expand Up @@ -99,11 +101,47 @@ Promise.race([])
})
```

### Непромисы в массиве промисов

Создадим массив, где `theFastest`- завершенный промис, а `3` - элемент, не являющийся промисом.

```js
const slow = new Promise(
resolve => setTimeout(() => resolve(1), 6000)
)
const theFastest = Promise.resolve(2)

const promises = [slow, theFastest, 3]
```

Передадим массив из созданных промисов в `Promise.race()`:

```js
Promise.race(promises)
.then((value) => {
console.log(value)
// 2
})
```
В консоль запишется результат выполнения `theFastest`, так как в массиве он был первым не являющимся незавершённым промисом.

Если поменять порядок элементов результат изменится

```js
const promises = [slow, 3, theFastest]

Promise.race(promises)
.then((value) => {
console.log(value)
// 3
})
```

### Отличие от `Promise.any()`

Как мы уже знаем, `Promise.race()` завершится, когда завершится самый быстрый из всех переданных промисов. Даже если он завершается _с ошибкой_.
Как мы уже знаем, `Promise.race()` вернёт промис, который завершится, когда получен первый (самый быстрый) результат или _ошибка_ из всех переданных промисов.

[`Promise.any()`](/js/promise-any/) завершится, когда _без ошибки_ завершится самый быстрый из всех переданных промисов.
[`Promise.any()`](/js/promise-any/) вернёт промис, который завершится, когда получен первый (самый быстрый) результат (_без ошибки_) из всех переданных промисов.

Создадим ещё раз несколько промисов, где `theFastest` завершается с ошибкой:

Expand Down

0 comments on commit 949b118

Please sign in to comment.