La méthode catch() renvoie un objet Promise et ne traite que des cas où la promesse initiale est rejetée. Elle a le même effet qu'un appel à Promise.prototype.then(undefined, siRejetée) (c'est en fait ce qui se passe dans le moteur,  obj.catch(onRejected) est traduit en obj.then(undefined, onRejected)). Cela signifie qu'il est nécessaire de fournir une fonction onRejected, même si on souhaite avoir une valeur de secours qui est undefined (par exemple avec obj.catch(() => {}).

Syntaxe

p.catch(siRejetée);

p.catch(function(raison) {
   // rejet
});

Paramètres

siRejetée
Une fonction à appeler si la Promise est rejetée (i.e. n'est pas tenue). Cette fonction possède un argument :
raison
Une chaîne de caractères qui indique pourquoi la promesse n'est pas tenue.

La promesse renvoyée par la méthode catch() est rompue si siRejetée lève une erreur ou si elle renvoie une promesse rompue. Dans les autres cas, elle est tenue.

Valeur de retour

Une promesse (Promise).

Description

La méthode catch est utile pour gérer les cas d'erreur en cas de compositions de plusieurs promesses.

Exemples

Utilisation de la méthode catch

var p1 = new Promise(function(resolve, reject) {
  resolve("Succès");
});

p1.then(function(value) {
  console.log(value); // "Succès!"
  throw "zut !";
}).catch(function(e) {
  console.log(e); // "zut !"
}).then(function(e) {
   console.log('après le catch, la chaîne est restaurée');
});

// Le code qui suit est équivalent :
p1.then(function(value) {
  console.log(value); // "Succès!"
  return Promise.reject('zut !');
}).catch(function(e) {
  console.log(e); // "zut !"
}).then(function(e){
  console.log('après le catch, la chaîne est restaurée');
});

Les promesses n'interceptent pas les exceptions levées de façon asynchrone

var p1 = new Promise(function(resolve, reject) {
  throw 'Oh oh!';
});

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

var p2 = new Promise(function(resolve, reject) {
  setTimeout(function() {
    throw 'Exception invisible !';
  }, 1000);
});

p2.catch(function(e) {
  console.log(e); // Cela n'est jamais appelé
});

Démonstration de l'appel interne à then

// On surcharge Promise.prototype.then/catch 
// pour y ajouter des logs
(function(Promise){
    var originalThen = Promise.prototype.then;
    var originalCatch = Promise.prototype.catch;
    
    Promise.prototype.then = function(){
        console.log('> > > > > > appel de .then sur %o avec les arguments: %o', this, arguments);
        return originalThen.apply(this, arguments);
    };
    Promise.prototype.catch = function(){
        console.log('> > > > > > appel de .catch sur %o avec les arguments: %o', this, arguments);
        return originalCatch.apply(this, arguments);
    };

})(this.Promise);



// On appelle catch sur une promesse déjà résolue
Promise.resolve().catch(function XXX(){});

// Dans la console, on aura :
// > > > > > > appel de .catch sur Promise{} avec les arguments: Arguments{1} [0: function XXX()]
// > > > > > > appel de .then sur Promise{} avec les arguments: Arguments{2} [0: undefined, 1: function XXX()]

Spécifications

Spécification État Commentaires
ECMAScript 2015 (6th Edition, ECMA-262)
La définition de 'Promise.prototype.catch' dans cette spécification.
Standard Définition initiale au sein d'un standard ECMA.
ECMAScript Latest Draft (ECMA-262)
La définition de 'Promise.prototype.catch' dans cette spécification.
Projet  

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobileServeur
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidEdge MobileFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung InternetNode.js
Support simpleChrome Support complet 32Edge Support complet OuiFirefox Support complet 29IE Aucun support NonOpera Support complet 19Safari Support complet 8WebView Android Support complet 4.4.3Chrome Android Support complet 32Edge Mobile Support complet OuiFirefox Android Support complet 29Opera Android Support complet OuiSafari iOS Support complet 8Samsung Internet Android Support complet Ouinodejs Support complet 0.12

Légende

Support complet  
Support complet
Aucun support  
Aucun support

Voir aussi

Étiquettes et contributeurs liés au document

Contributeurs à cette page : SphinxKnight, LaurentBarbareau, axel_chalon
Dernière mise à jour par : SphinxKnight,