Promise.reject()

概述

Promise.reject(reason)方法返回一个带有拒绝原因reason参数的Promise对象。

语法

Promise.reject(reason);

Parameters

reason
表示Promise被拒绝的原因。

Return value

一个给定原因了的被拒绝的 Promise。

描述

静态函数Promise.reject返回一个被拒绝的Promise对象。通过使用Error的实例获取错误原因reason对调试和选择性错误捕捉很有帮助。

示例

使用静态Promise.reject()方法

Promise.reject("Testing static reject").then(function(reason) {
  // 未被调用
}, function(reason) {
  console.log(reason); // "Testing static reject"
});

Promise.reject(new Error("fail")).then(function(result) {
  // 未被调用
}, function(error) {
  console.log(error); // stacktrace
});

规范

规范 状态 备注
ECMAScript 2015 (6th Edition, ECMA-262)
Promise.reject		 Standard ECMA规范的首次定义
ECMAScript Latest Draft (ECMA-262)
Promise.reject		 Draft  

浏览器兼容性

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 32 24.0 (24.0) as Future
25.0 (25.0) as Promise behind a flag[1]
29.0 (29.0) by default		 未实现 19 7.1
Feature Android Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support 未实现 24.0 (24.0) as Future
25.0 (25.0) as Promise behind a flag[1]
29.0 (29.0) by default		 未实现 未实现 iOS 8 32

[1] Gecko 24实验性地实施了Promise类，它最初被命名为Future，在Gecko 25被重新命名为现在的名字， 但在dom.promise.enabled设置中被默认禁用。 Bug 918806 Gecko 29开始默认启用Promise。

参见

相关主题
  1. JavaScript 标准库
  2. Promise
  3. 属性
    1. Promise.prototype
  4. 方法
    1. Promise.all()
    2. Promise.prototype.allSettled()
    3. Promise.prototype.catch()
    4. Promise.prototype.finally()
    5. Promise.prototype.then()
    6. Promise.race()
    7. Promise.reject()
    8. Promise.resolve()
  5. 继承
  6. Function
  7. 属性
    1. Function.arguments
    2. Function.arity
    3. Function.caller
    4. Function.displayName
    5. Function.length
    6. Function.prototype
    7. Function.name
  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()