Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / JavaScript

Promise.resolve — normaliser une valeur en promesse

Promise.resolve(value) permet de traiter une valeur ordinaire, une promesse ou un thenable comme une promesse. La méthode peut renvoyer une promesse existante sans la modifier ; resolved ne signifie ni que le résultat est déjà disponible ni que l’opération réussira.

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.resolve(value)

Promise.resolve(value) est une méthode statique qui normalise une valeur en promesse. Si l’argument est omis, sa valeur est undefined. Lorsque la méthode crée une nouvelle promesse, celle-ci est tenue avec l’argument comme valeur si c’est une primitive ou un objet dont la propriété then peut être lue sans exception et renvoie une valeur non appelable. Si la lecture de then lève une exception, la nouvelle promesse est rejetée avec cette exception comme motif.

Si p est une véritable promesse, Promise.resolve(p) lit sa propriété constructor. Si cette lecture renvoie Promise, la méthode renvoie exactement p. Si l’accesseur en lecture de constructor lève une exception, la méthode la propage de manière synchrone avant de créer une nouvelle promesse, même si l’évaluation de l’argument p lui-même réussit. La méthode crée une nouvelle promesse si l’argument n’est pas une véritable promesse ou si la lecture de sa propriété constructor renvoie une valeur autre que Promise. Un thenable, c’est-à-dire un objet doté d’un then appelable, est assimilé, et le résultat suit son règlement, y compris à travers d’autres thenables. Un rejet reste un rejet ; resolved ne signifie pas fulfilled.

Les fonctions de rappel passées à .then() s’exécutent de manière asynchrone, même si la promesse est déjà tenue. La méthode n’intercepte pas les erreurs survenant lors de l’évaluation de son argument : si fn() lève une exception dans Promise.resolve(fn()), l’appel lève cette exception de manière synchrone. Pour différer l’appel et transformer une telle exception en rejet, utilisez Promise.resolve().then(() => fn()).

Exemples

const p = Promise.resolve(7);
console.log(Promise.resolve(p) === p);

const thenable = { then(resolve) { resolve(42); } };
Promise.resolve(thenable).then(value => console.log(value));
console.log("sync");

Résultat

true
sync
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.

Sources