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

CKTIS / JavaScript

Promise.withResolvers() : une promesse avec des fonctions de résolution accessibles

Promise.withResolvers() renvoie une nouvelle promesse ainsi que les fonctions resolve et reject qui lui sont associées. Cette méthode sépare la création de la promesse de la fourniture de son résultat, par exemple pour adapter une interface fondée sur des callbacks.

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

const { promise, resolve, reject } = Promise.withResolvers();

Promise.withResolvers() est une méthode statique d’ECMAScript 2024, et non une API Web. Elle ne prend aucun argument et renvoie un objet ordinaire doté des propriétés promise, resolve et reject. Avec Promise.withResolvers(), la promesse est initialement en attente d’un résultat ; contrairement à new Promise(executor), vous ne fournissez pas de fonction d’exécution.

resolve(value) accepte une valeur ou adopte le résultat futur d’une promesse ou d’un thenable. Appeler resolve ne signifie donc pas toujours que la promesse est immédiatement tenue. reject(reason) rejette la promesse. Seul le premier appel à l’une de ces fonctions compte ; les appels suivants sont ignorés, même si le résultat adopté est encore inconnu.

Les gestionnaires enregistrés avec .then() s’exécutent de manière asynchrone. L’exemple affiche d’abord sync, puis fulfilled: 42 ; l’appel à reject est ignoré. N’exposez les fonctions de résolution qu’au code qui doit contrôler le résultat.

Vérifiez la disponibilité avec typeof Promise.withResolvers === "function". La spécification seule ne permet pas d’établir la prise en charge dans un navigateur donné ; Node 24 dans le dépôt ne l’établit pas non plus.

Exemples

const { promise, resolve, reject } = Promise.withResolvers();

promise.then(
  value => console.log(`fulfilled: ${value}`),
  reason => console.log(`rejected: ${reason}`)
);

resolve(42);
reject("ignored");
console.log("sync");

Résultat

sync
fulfilled: 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