--- title: Promise.reject() slug: Web/JavaScript/Reference/Global_Objects/Promise/відхилено tags: - ECMAScript 2015 - JavaScript - Promise - метод translation_of: Web/JavaScript/Reference/Global_Objects/Promise/reject ---
{{JSRef}}

Метод Promise.reject() повертає об'єкт Promise, відхилений з наданою причиною.

{{EmbedInteractiveExample("pages/js/promise-reject.html")}}

Синтаксис

Promise.reject(reason);

Параметри

reason
Причина, чому даний проміс був відхилений.

Значення, яке повертається

Об'єкт {{jsxref("Promise")}}, відхилений з наданою причиною.

Опис

Статичний метод Promise.reject повертає відхилений об'єкт Promise. З метою відлагодження, а також вибіркового перехоплення помилок зручно використовувати reason як instanceof {{jsxref("Error")}}.

Приклади

Використання статичного методу Promise.reject()

Promise.reject(new Error('fail')).then(function(error) {
  // не викликається
}, function(error) {
  console.error(error); // стек викликів
});

Специфікації

Специфікація
{{SpecName('ESDraft', '#sec-promise.reject', 'Promise.reject')}}

Сумісність з веб-переглядачами

{{Compat("javascript.builtins.Promise.reject")}}

Дивіться також