---
title: "`.then()`"
description: "Обрабатываем ситуацию, когда пообещали значение — и выполнили обещание."
url: "https://doka.guide/js/promise-then/"
section: "JavaScript"
createdAt: "2021-07-02"
updatedAt: "2026-11-20"
baseline: [{"group":"promise","features":["javascript.builtins.Promise.then"]}]
authors: ["nlopin"]
related: ["tools/api", "js/async-in-js", "tools/nodejs"]
source: "https://github.com/doka-guide/content/blob/main/js/promise-then/index.md"
license: "CC BY-NC-SA 4.0"
---

# `.then()`

<aside>

💡 Эта статья связана с понятием [Promise](/js/promise/).

</aside>

## Кратко

Метод `then()` используют, чтобы выполнить код после изменения состояния промиса.

Метод _принимает_ два аргумента:

- `onFulfill` — функция-колбэк, которая вызывается при переходе промиса в состояние «успех» `fulfilled`. Функция имеет один параметр, в который передаётся результат выполнения операции.
- `onReject` — функция-колбэк, которая вызывается при переходе промиса в состояние «ошибка» `rejected`. У функции один параметр, в который передаётся информация об ошибке.

Всегда _возвращает_ новый промис.

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

```js
// Асинхронная функция, которая возвращает промис
getPasswords().then(
  function (result) {
    // Что-то делаем с результатом операции
    console.log('Все пароли:' + result)
  },
  function (err) {
    // Обрабатываем ошибку
    console.error(err.message)
  }
)
```

## Как понять

Обработка асинхронных операций через промис и `then()` очень похожа на работу с колбэками.

Так как `then()` всегда возвращает новый промис, его удобно использовать для построения последовательностей асинхронных операций. Например, мы запрашиваем через API список домов из «Игры престолов», запускаем асинхронную операцию парсинга JSON из ответа сервера и дополнительно запрашиваем сюзерена дома.

```js
// Запрос списка; `fetch` возвращает промис
fetch('https://www.anapioficeandfire.com/api/houses')
  .then(function (response) {
    // Выполнится, когда придёт ответ

    // Парсим JSON из ответа сервера.
    // Возвращаем промис из обработчика; потом добавим `then`
    return response.json()
  })
  .then(function (houses) {
    // Выполнится, когда JSON распарсится.
    // Запрашиваем дополнительные данные
    return fetch(houses[0].overlord)
  })
  .then(function (response) {
    // Выполнится, когда придёт ответ
    return response.json()
  })
  .then(function (overlord) {
    console.log(overlord.name)
  })
```

В коде каждый вызов `then()` привязан к результату предыдущей операции. Такой код читается почти как синхронный.

## На практике: Николай Лопин

🛠 `then()` используют только для обработки успешного завершения операции, в варианте с одним аргументом:

```js
getPasswords().then(function (result) {
  // Что-то делаем с результатом операции
  console.log(`Все пароли: ${result}`)
})
```

Для обработки ошибок используют метод [`catch()`](/js/promise-catch/). Такие цепочки читаются лучше:

```js
getPasswords()
  .then(function (result) {
    console.log(`Все пароли: ${result}`)
  })
  .catch(function (error) {
      console.log(`Ошибка: ${error.message}`)
  })
```

