JavaScript LinuxWindowsmacOS

JavaScript — Uncaught (in promise) — необработанная ошибка в async-коде

  • Обновлено
  • Чтение ≈ 1 минута

Краткий ответ

Ошибка в Promise без catch попадает в консоль как Uncaught (in promise). Оборачивайте await в try/catch и добавляйте .catch().

В этой статье
  1. Что означает ошибка
  2. Причины и признаки
  3. Пошаговое решение
  4. Если проблема осталась

#Что означает ошибка

Сообщение
Uncaught (in promise)

Ошибка в Promise без catch попадает в консоль как Uncaught (in promise). Оборачивайте await в try/catch и добавляйте .catch().

#Причины и признаки

Возможная причинаКак узнатьЧто делать
Нет catchPromise отвергается без catch.Добавьте обработку в точку вызова.
Забыт awaitВызов Promise не ожидается и теряется.Возвращайте/ожидайте результат асинхронной функции.
Ошибка сетиЗапрос к сети отклоняется.Обработайте сеть и отдельно response.ok.
Ошибка в thenИсключение возникает внутри then.Перехватите отказ в цепочке и сохраните стек.

#Пошаговое решение

  1. Найдите отвергнутый PromiseОткройте F12 → «Консоль» и найдите Uncaught (in promise), затем перейдите к строке кода по ссылке стека. В Node.js посмотрите причину и файл в выводе терминала. Запишите текст исходного исключения — само сообщение о необработанном Promise не раскрывает его причину.
  2. Добавьте обработку там, где ожидается ошибкаЕсли используется await, поместите операцию в try/catch и выведите безопасное сообщение с причиной; если .then(), добавьте .catch(err => ...). Не оставляйте пустой catch {}: исключение должно быть показано пользователю или зафиксировано в журнале без паролей.
  3. Проверьте асинхронные вызовы и возвратыУбедитесь, что функция, возвращающая Promise, действительно ожидается через await или возвращается вызывающему коду. При fetch отдельно проверьте response.ok: HTTP 404/500 сам по себе не отклоняет Promise fetch. Для Promise.all предусмотрите обработку отказа любой из задач.
  4. Проверьте положительный и отрицательный сценарииПовторите действие при исправном сервере и при контролируемой ошибке сети; приложение должно показать понятное уведомление, а консоль — не содержать необработанных отказов. Не используйте глобальный обработчик unhandledrejection как замену исправлению конкретного вызова.

#Если проблема осталась

Если «JavaScript — Uncaught (in promise) — необработанная ошибка в async-коде» повторяется, сохраните время, состояние подключения и точный текст ошибки. Не меняйте сразу несколько настроек — иначе станет трудно понять, какое действие повлияло на результат.

Так эту ошибку тоже называют

JavaScript — TypeError: Cannot read properties of undefined — причины и решение Проверяйте значение на undefined и используйте optional chaining. Программирование и базы данных JavaScript LinuxWindowsmacOS JavaScript — TypeError: x is not a function — причины и решение Ошибка означает вызов значения, не являющегося функцией: опечатка в имени, перезаписанная переменная или неверный объект. Проверьте тип значения через typeof и порядок п… Программирование и базы данных JavaScript LinuxWindowsmacOS Ошибка CORS в браузере: blocked by CORS policy — причины и решение Браузер блокирует запрос к другому источнику, если сервер не разрешил его заголовками CORS. Ниже — причины и порядок действий от простого к сложному. Программирование и базы данных JavaScript WindowsLinux JavaScript — TypeError: Failed to fetch — причины и решение «TypeError: Failed to fetch» значит, что браузер вообще не получил ответ: запрос заблокирован политикой CORS, расширением, смешанным содержимым или не дошёл до сервера. … Программирование и базы данных JavaScript LinuxWindowsmacOS Ошибка SyntaxError в JavaScript — Unexpected token при разборе JSON — причины и решение Ошибка означает, что вместо JSON сервер вернул HTML (чаще всего страницу ошибки или авторизации). Ниже — причины и порядок действий от простого к сложному. Программирование и базы данных JavaScript WindowsLinux

Источники и обновления

Последнее обновление статьи: 2 ноября 2026. Версии программ и интерфейсы меняются — если шаги не совпадают с вашей версией, сверяйтесь с документацией производителя.