Czym jest Promise i jakie stany posiada?

Question

Accepted Answer

**Promise** to obiekt reprezentujący wartość, która może być niedostępna — ostateczny wynik operacji asynchronicznej. Posiada trzy stany:

- **pending** — stan początkowy, jeszcze nieustalony.
- **fulfilled** — ukończony pomyślnie (ma wartość).
- **rejected** — nie powiódł się (ma powód/błąd).

Kiedy się ustali (fulfilled lub rejected) jest **immutable** — nie może się już zmienić.

```js
fetch("/api/user")
  .then(res => res.json())     // runs on fulfillment; return value flows down
  .then(user => render(user))
  .catch(err => showError(err)) // runs on ANY rejection in the chain
  .finally(() => hideSpinner()); // always runs
```

## Chaining flattens nested async

Zwrócenie promise'a wewnątrz `.then` czeka na niego przed kontynuacją, dzięki czemu unikasz głębokich zagnieżdżonych callbacków ("callback hell"):

```js
getUser(id)
  .then(user => getPosts(user.id)) // returns a promise → chain waits for it
  .then(posts => console.log(posts));
```

## Combinators for multiple promises

```js
Promise.all([a, b, c]);     // wait for ALL; rejects fast if any fails
Promise.allSettled([a, b]); // wait for all, get each result/error
Promise.race([a, b]);       // settles with the FIRST to settle
Promise.any([a, b]);        // first to FULFILL (ignores rejections)
```

## Dlaczego to ważne

Promise'y są podstawą asynchronicznego JS — zastąpiły zagnieżdżanie callbacków, zapewniają ujednoliconą obsługę błędów poprzez `.catch`, a `async/await` to apenas lepsza składnia na ich bazie.

Zapomnienie `.catch` (nieobsłużona odmowa) to częsty błąd.