الدالة Promise.reject()‎ في JavaScript

الدالة Promise.reject(reason)‎ تُعيد كائن Promise الذي رُفِضَ للسبب المعطي.

function resolved(result) {
  console.log('Resolved');
}

function rejected(result) {
  console.log(result);
}

Promise.reject(new Error('fail')).then(resolved, rejected);
// Error: fail

البنية العامة

Promise.reject(reason);

المعاملات

resason

السبب وراء رفض الوعد Promise.

القيمة المعادة

وعد Promise مرفوض، مع تبيان سبب الرفض.

الوصف

الدالة الساكنة ()Promise.reject تُعيد وعدًا Promise مرفوضًا. ولأغراض التنقيح ولالتقاط الاستثناءات، فمن المفيد أن يكون سبب الرفض reason هو نسخةٌ من (instanceof) الكائن Error.

أمثلة

استخدام الدالة الساكنة Promise.reject()‎:

Promise.reject(new Error('fail')).then(function() {
  // لن تستدع
}, function(error) {
  console.log(error); // Stacktrace
});

المصادر

• صفحة Promise​.reject()‎ في توثيق MDN الرسمي.