CKTIS / JavaScript
Promise.prototype.then — enchaîner des opérations asynchrones
Promise.prototype.then enregistre des gestionnaires de résolution ou de rejet et renvoie une nouvelle promesse. Le résultat du gestionnaire détermine la suite de la chaîne.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
promise.then(onFulfilled, onRejected)Promise.prototype.then accepte les gestionnaires facultatifs onFulfilled et onRejected. Le premier reçoit la valeur de résolution, le second la raison du rejet. L’appel renvoie une nouvelle promesse. Les gestionnaires s’exécutent de façon asynchrone, après la fin du code synchrone en cours, même si la promesse d’origine est déjà réglée.
Renvoyer une valeur ordinaire résout la nouvelle promesse, tandis que lancer une exception la rejette. Renvoyer une promesse ou un objet doté d’une méthode then appelable fait adopter à la nouvelle promesse son résultat final. En l’absence de return, le résultat est undefined. Renvoyez les opérations asynchrones pour que la chaîne les attende.
Les arguments non appelables sont considérés comme des gestionnaires absents : la valeur de résolution ou la raison du rejet est transmise. onRejected n’intercepte pas une exception lancée par onFulfilled dans le même appel à then ; traitez-la dans un maillon ultérieur. Un retour normal de onRejected peut rétablir un état de résolution.
Il s’agit d’un mécanisme ECMAScript, et non d’une API Web. La méthode exige une véritable promesse comme this ; la simple présence d’une méthode then ne suffit pas. L’exemple montre le traitement différé, la transformation d’une valeur et la récupération après une erreur.
Exemples
console.log('start');
Promise.resolve(3)
.then(value => value * 2)
.then(value => {
console.log(value);
throw new Error('boom');
})
.then(undefined, error => {
console.log(error.message);
return 9;
})
.then(value => console.log(value));
console.log('end');Résultat
start end 6 boom 9
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.