Aucun.

Une nouvelle promesse ({{JSxRef("Promise")}}) qui se résout avec `undefined` lorsque tous les libérateurs enregistrés ont terminé leur exécution en séquence.

`disposeAsync()` ne lève jamais d'erreur de façon synchrone. La promesse retournée peut être rejetée avec l'une des erreurs suivantes :

- {{JSxRef("SuppressedError")}}

- : Levée si plusieurs libérateurs dans la pile ont levé une erreur. Si une seule erreur est levée, elle est relancée telle quelle. Sinon, pour chaque erreur supplémentaire, une nouvelle {{JSxRef("SuppressedError")}} est créée, avec l'erreur initiale dans la propriété `suppressed` et la nouvelle erreur dans la propriété `error`.

Ici, on ajoute trois libérateurs à la pile, en utilisant les méthodes {{JSxRef("AsyncDisposableStack/use", "use()")}}, {{JSxRef("AsyncDisposableStack/adopt", "adopt()")}} et {{JSxRef("AsyncDisposableStack/defer", "defer()")}}. Lorsque `disposeAsync()` est appelée, les libérateurs sont appelés dans l'ordre inverse de leur enregistrement.

Notez qu'en général, il n'est pas nécessaire d'appeler `disposeAsync()` manuellement. Déclarez la pile avec {{JSxRef("Statements/await_using", "await using")}} et sa méthode [`[Symbol.asyncDispose]()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/Symbol.asyncDispose) sera automatiquement appelée lorsque la pile sortira de la portée.

class Ressource {

#liberation() {

// Imaginez ici une logique de libération plus significative

return new Promise((resolve) => {

setTimeout(resolve, 1000);

});

}

async liberer() {

await this.#liberation();

console.log("Ressource libérée");

}

async [Symbol.asyncDispose]() {

await this.#liberation();

console.log("Ressource libérée via Symbol.asyncDispose");

}

}

async function faireQuelqueChose() {

const gestionnaire = new AsyncDisposableStack();

const ressource = gestionnaire.use(new Ressource());

const ressource2 = gestionnaire.adopt(new Ressource(), (ressource) =>

ressource.liberer(),

);

gestionnaire.defer(() => console.log("Libérateur différé"));

gestionnaire.disposeAsync();

// Affiche dans l'ordre :

// Libérateur différé

// Ressource libérée

// Ressource libérée via Symbol.dispose

}

faireQuelqueChose();

{{Specifications}}

{{Compat}}

- [Gestion des ressources en JavaScript](/fr/docs/Web/JavaScript/Guide/Resource_management)

- L'objet natif {{JSxRef("AsyncDisposableStack")}}

- La méthode {{JSxRef("AsyncDisposableStack.prototype.adopt()")}}

- La méthode {{JSxRef("AsyncDisposableStack.prototype.defer()")}}

- La méthode {{JSxRef("AsyncDisposableStack.prototype.use()")}}

- La méthode [`AsyncDisposableStack.prototype[Symbol.asyncDispose]()`](/fr/docs/Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack/Symbol.asyncDispose)