O que é uma Promise e quais são seus estados?

Question

Accepted Answer

Uma **Promise** é um objeto que representa um valor que pode não estar disponível ainda — o resultado eventual de uma operação assíncrona. Ela tem três estados:

- **pending** — inicial, ainda não resolvida.
- **fulfilled** — completada com sucesso (tem um valor).
- **rejected** — falhou (tem uma razão/erro).

Quando se resolve (fulfilled ou rejected) é **imutável** — não pode mudar novamente.

```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

Retornar uma promise dentro de `.then` aguarda por ela antes de continuar, então você evita callbacks profundamente aninhados ("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)
```

## Por que isso importa

Promises são a base do JS assíncrono — elas substituíram o aninhamento de callbacks, fornecem tratamento unificado de erros via `.catch`, e `async/await` é apenas uma sintaxe mais bonita em cima delas.

Esquecer `.catch` (uma rejeição não tratada) é um bug comum.