DisposableStack : méthode dispose()

Syntaxe

dispose()

Paramètres

Aucun.

Valeur de retour

Aucune (undefined).

Exceptions

SuppressedError

Levée si plusieurs gestionnaires de libération 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 SuppressedError est créée, avec l'erreur originale dans la propriété suppressed et la nouvelle erreur dans la propriété error.

Exemples

Libérer une pile

Ici, nous ajoutons trois gestionnaires de libération à la pile, en utilisant les méthodes use(), adopt() et defer(). Lorsque dispose() est appelée, les gestionnaires sont appelés dans l'ordre inverse de leur enregistrement.

Notez que généralement, vous n'avez pas besoin d'appeler dispose() manuellement. Déclarez la pile avec using, et sa méthode [Symbol.dispose]() sera automatiquement appelée lorsque la pile sort de la portée.

class Resource {
  dispose() {
    console.log("Ressource libérée");
  }
  [Symbol.dispose]() {
    console.log("Ressource libérée par Symbol.dispose");
  }
}

{
  const disposer = new DisposableStack();
  const resource = disposer.use(new Resource());
  const resource2 = disposer.adopt(new Resource(), (resource) =>
    resource.dispose(),
  );
  disposer.defer(() => console.log("Libération différée"));
  disposer.dispose();
  // Affiche dans l'ordre :
  // Libération différée
  // Ressource libérée
  // Ressource libérée par Symbol.dispose
}

Spécifications

Compatibilité des navigateurs

Voir aussi

• Gestion des ressources JavaScript
• L'objet DisposableStack
• La méthode DisposableStack.prototype.adopt()
• La méthode DisposableStack.prototype.defer()
• La méthode DisposableStack.prototype.use()
• La méthode DisposableStack.prototype[Symbol.dispose]()