Promise.prototype.catch()

catch()メソッドはPromiseを返します。失敗した場合のみ扱います。Promise.prototype.then(undefined, onRejected)が呼ばれたときと同様に振る舞います。

構文

p.catch(onRejected);

p.catch(function(reason) {
   // rejection
});

引数

onRejected

Promiseが失敗した時に呼ばれるFunction。この関数は一つの引数、reasonを持ちます。

説明

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) {
  console.log(e); // "oh, no!"
}).then(function(){
  console.log('after a catch the chain is restored');
}, function () {
  console.log('Not fired due to the catch');
});

// 以下は、上記と同様に動作します
p1.then(function(value) {
  console.log(value); // "Success!"
  return Promise.reject('oh, no!');
}).catch(function(e) {
  console.log(e); // "oh, no!"
}).then(function(){
  console.log('after a catch the chain is restored');
}, function () {
  console.log('Not fired due to the catch');
});

仕様

ブラウザ実装状況

関連情報

• Promise
• Promise.prototype.then()