在此页

• 句法
• 描述
• 范例
• 规范
• 浏览器兼容性
• 另请参阅
• 相关话题

Promise.reject() method returns a Promise object that is rejected with a given reason.

The source for this interactive example is stored in a GitHub repository. If you'd like to contribute to the interactive examples project, please clone https://github.com/mdn/interactive-examples and send us a pull request.

句法

Promise.reject(reason);
					

参数

reason

Reason why this Promise rejected.

返回值

A Promise that is rejected with the given reason.

描述

静态 Promise.reject function returns a Promise that is rejected. For debugging purposes and selective error catching, it is useful to make reason an instanceof Error .

范例

Using the static Promise.reject() method

Promise.reject(new Error('fail')).then(function() {
  // not called
}, function(error) {
  console.error(error); // Stacktrace
});
					

规范

规范
ECMAScript (ECMA-262) The definition of 'Promise.reject' in that specification.

浏览器兼容性

To contribute to this compatibility data, please write a pull request against this repository: https://github.com/mdn/browser-compat-data .

更新 GitHub 上的兼容性数据

	Desktop						Mobile						Server
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet	Node.js
reject()	Chrome 32	Edge 12	Firefox 29	IE No	Opera 19	Safari 8	WebView Android 4.4.3	Chrome Android 32	Firefox Android 29	Opera Android 19	Safari iOS 8	Samsung Internet Android 2.0	nodejs 0.12

图例

完整支持

完整支持

不支持

不支持

另请参阅

• Promise

元数据

• 最后修改： 2020 年 1 月 22 日

相关话题

1. 标准内置对象
2. Promise
3. 方法
   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()
4. 继承：
5. Function
6. 特性
   1. Function.arguments
   2. Function.caller
   3. Function.displayName
   4. Function.length
   5. Function.name
7. 方法
   1. Function.prototype.apply()
   2. Function.prototype.bind()
   3. Function.prototype.call()
   4. Function.prototype.toSource()
   5. Function.prototype.toString()
8. Object
9. 特性
   1. Object.prototype.__proto__
   2. Object.prototype.constructor
10. 方法
    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.valueOf()
    12. Object.setPrototypeOf()