--- title: Promise.prototype.catch() slug: Web/JavaScript/Reference/Global_Objects/Promise/catch tags: - ECMAScript6 - JavaScript - Prototype - Обещание - метод translation_of: Web/JavaScript/Reference/Global_Objects/Promise/catch ---
{{JSRef}}

Метод catch() возвращает Promise(обещание) и работает только в случае отклонения обещания. Ведет себя аналогично вызову {{jsxref("Promise.then", "Promise.prototype.then(undefined, onRejected)")}}.

Syntax

p.catch(onRejected);

p.catch(function(reason) {
   // отказ
});

Параметры

onRejected
{{jsxref("Function")}} вызывается когда обещание отклонено. У этой функции один аргумент:
reason
Причина отказа.

Promise( Обещание ), возвращенное catch (), отклоняется, если onRejected выдает ошибку(throw) или возвращает Promise, который был отклонен; В противном случае Promise, возвращаемый catch () имеет статус  выполнено  (fulfilled)

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

{{jsxref("Promise")}}.

Описание

Метод catch может быть полезен для обработки ошибок в вашей структуре обещаний.

Примеры

Использование метода catch

var p1 = new Promise(function(resolve, reject) {
  resolve('Success');
});

p1.then(function(value) {
  console.log(value); // "Success!"
  throw 'oh, no!';
}).catch(function(e) {
  // Функция не перевыбросила исключение 'e'
  // в результате произойдёт resolve(undefined)
  // для Promise, возвращённого функцией catch
  console.log(e); // "oh, no!"
}).then(function(){
  console.log('after a catch the chain is restored');
}, function () {
  // Функция не перевыбросила исключение 'e'
  // в результате произойдёт resolve(undefined)
  // для Promise, возвращённого функцией catch
  console.log('Not fired due to the catch');
});

// Следующий код ведет себя также, как вышенаписанный
p1.then(function(value) {
  console.log(value); // "Success!"
  return Promise.reject('oh, no!');
}).catch(function(e) {
  // Функция не перевыбросила исключение 'e'
  // в результате произойдёт resolve(undefined)
  // для Promise, возвращённого функцией catch
  console.log(e); // "oh, no!"
}).then(function(){
  console.log('after a catch the chain is restored');
}, function () {
  // Функция не перевыбросила исключение 'e'
  // в результате произойдёт resolve(undefined)
  // для Promise, возвращённого функцией catch
  console.log('Not fired due to the catch');
});

Ловим выброшеные исключения

// Выкидываемая ошибка вызовет метод catch
var p1 = new Promise(function(resolve, reject) {
  throw 'Uh-oh!';
});

p1.catch(function(e) {
  console.log(e); // "Uh-oh!"
});

// Ошибки выброшеные из асинхронных функций не будут пойманы методом catch
var p2 = new Promise(function(resolve, reject) {
  setTimeout(function() {
    throw 'Uncaught Exception!';
  }, 1000);
});

p2.catch(function(e) {
  console.log(e); // Никогда не вызовется
});

// Ошибки выброшеные после выполнения обещания будут проигнорированны
var p3 = new Promise(function(resolve, reject) {
  resolve();
  throw 'Silenced Exception!';
});

p3.catch(function(e) {
   console.log(e); // Никогда не вызовется
});

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

Specification Status Comment
{{SpecName('ES6', '#sec-promise.prototype.catch', 'Promise.prototype.catch')}} {{Spec2('ES6')}} Initial definition in an ECMA standard.
{{SpecName('ESDraft', '#sec-promise.prototype.catch', 'Promise.prototype.catch')}} {{Spec2('ESDraft')}}  

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

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

Смотри также