Promise.reject()

Метод Promise.reject(reason) возвращает объект Promise, который был отклонен по указанной причине.

Синтаксис

Promise.reject(reason);

Параметры

reason
Причина по которой Promise был отклонен.

Возвращаемое значение

Отклоненный с указаной причиной Promise.

Описание

Promise.reject возвращает Promise который был отклонен. В целях отладки и выборочного отлова ошибок, удобно использовать в качестве причины объекты Error.

Примеры

Использование статического метода Promise.reject()

Promise.reject(new Error("провал")).then(function(success) {
  // не вызывается
}, function(error) {
  console.log(error); // печатает "провал" + Stacktrace
  throw error; // повторно выбрасываем ошибку, вызывая новый reject
});

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

Спецификация Статус Комментарий
ECMAScript 2015 (6th Edition, ECMA-262)
Определение 'Promise.reject' в этой спецификации.		 Стандарт Исходное определение в стандарте ECMA.
ECMAScript Latest Draft (ECMA-262)
Определение 'Promise.reject' в этой спецификации.		 Черновик  

Совместимость с браузерами

Update compatibility data on GitHub
КомпьютерыМобильныеServer
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome для AndroidFirefox для AndroidOpera для AndroidSafari on iOSSamsung InternetNode.js
reject()Chrome Полная поддержка 32Edge Полная поддержка 12Firefox Полная поддержка 29IE Нет поддержки НетOpera Полная поддержка 19Safari Полная поддержка 8WebView Android Полная поддержка 4.4.3Chrome Android Полная поддержка 32Firefox Android Полная поддержка 29Opera Android Полная поддержка ДаSafari iOS Полная поддержка 8Samsung Internet Android Полная поддержка 2.0nodejs Полная поддержка 0.12

Легенда

Полная поддержка  
Полная поддержка
Нет поддержки  
Нет поддержки

 

Смотрите также

Связанные темы
  1. Стандартные встроенные объекты
  2. Promise
  3. Свойства
    1. Promise.prototype
  4. Методы
    1. Promise.all()
    2. Promise.allSettled()
    3. Promise.any() [Перевести]
    4. Promise.prototype.catch()
    5. Promise.prototype.finally()
    6. Promise.prototype.then()
    7. Promise.race()
    8. Promise.reject()
    9. Promise.resolve()
  5. Наследование:
  6. Function
  7. Свойства
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.name
    7. Function.prototype
  8. Методы
    1. Function.prototype.apply()
    2. Function.prototype.bind()
    3. Function.prototype.call()
    4. Function.prototype.isGenerator()
    5. Function.prototype.toSource()
    6. Function.prototype.toString()
  9. Object
  10. Свойства
    1. Object.prototype.__count__
    2. Object.prototype.__noSuchMethod__
    3. Object.prototype.__parent__
    4. Object.prototype.__proto__
    5. Object.prototype.constructor
  11. Методы
    1. Object.prototype.__defineGetter__()
    2. Object.prototype.__defineSetter__()
    3. Object.prototype.__lookupGetter__()
    4. Object.prototype.__lookupSetter__()
    5. Object.prototype.hasOwnProperty()
    6. Object.prototype.isPrototypeOf()
    7. Object.prototype.propertyIsEnumerable()
    8. Object.prototype.toLocaleString()
    9. Object.prototype.toSource()
    10. Object.prototype.toString()
    11. Object.prototype.unwatch()
    12. Object.prototype.valueOf()
    13. Object.prototype.watch()
    14. Object.setPrototypeOf()