CKTIS / JavaScript
Promise — résultats d’opération et fonctions resolve/reject
Un Promise représente un résultat futur ou une cause d’échec. Découvrez l’exécution synchrone de son executor, le rôle de resolve et reject, ainsi que le traitement asynchrone du résultat avec then et catch.
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
new Promise((resolve, reject) => { /* report completion */ });
promise.then(onFulfilled, onRejected);
promise.catch(onRejected);Promise représente le résultat d’une opération qui peut se terminer plus tard. Son état est pending, fulfilled ou rejected ; les deux derniers sont définitifs. Créer une promesse ne déplace pas à lui seul le travail vers un autre thread.
new Promise(executor) appelle l’executor de façon synchrone en lui fournissant les fonctions resolve et reject. resolve(value) accomplit la promesse avec une valeur ordinaire ou adopte le résultat d’une promesse ou d’un thenable, c’est-à-dire un objet doté d’une méthode then appelable. reject(reason) rejette la promesse ; privilégiez un Error comme motif. Le premier appel à l’une de ces fonctions bloque les appels suivants, même si le résultat adopté est encore pending. Résoudre ne signifie donc pas toujours que la promesse est immédiatement accomplie.
La valeur renvoyée par l’executor est ignorée. Une exception synchrone levée dans celui-ci rejette la promesse, sauf si resolve ou reject a déjà été appelé. Les gestionnaires enregistrés avec then s’exécutent de façon asynchrone, après la fin de l’exécution en cours. then renvoie une nouvelle promesse : une valeur renvoyée détermine son résultat, tandis qu’une exception levée la rejette. catch traite les rejets.
Dans l’exemple, l’executor affiche executor, et le code synchrone affiche sync avant result: 42. L’appel à reject après resolve(21) n’a aucun effet. L’exemple nécessite un environnement d’exécution avec Promise et console ; il ne suppose ni API Web supplémentaires ni version particulière d’un navigateur.
Exemples
const promise = new Promise((resolve, reject) => {
console.log("executor");
resolve(21);
reject(new Error("ignored"));
});
promise
.then(value => value * 2)
.then(value => console.log(`result: ${value}`))
.catch(error => console.log(error.message));
console.log("sync");Résultat
executor sync result: 42
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.