files/en-us/web/javascript/reference/global_objects/asyncdisposablestack/index.md

metadata

title: AsyncDisposableStack
slug: Web/JavaScript/Reference/Global_Objects/AsyncDisposableStack
page-type: javascript-class
browser-compat: javascript.builtins.AsyncDisposableStack
sidebar: jsref

The AsyncDisposableStack object represents a stack of async disposers to run when the stack itself is disposed. Disposer functions are executed in reverse order of registration, with strong error handling guarantees. Calling its move() method will transfer responsibility for calling the current registered disposers to a new AsyncDisposableStack and prevent registering any additional disposers.

See {{jsxref("DisposableStack")}} for general information about using disposable stacks.

Constructor

• {{jsxref("AsyncDisposableStack/AsyncDisposableStack", "AsyncDisposableStack()")}}
  • : Creates a new AsyncDisposableStack object.

Instance properties

These properties are defined on AsyncDisposableStack.prototype and shared by all AsyncDisposableStack instances.

• {{jsxref("Object/constructor", "AsyncDisposableStack.prototype.constructor")}}
  • : The constructor function that created the instance object. For AsyncDisposableStack instances, the initial value is the {{jsxref("AsyncDisposableStack/AsyncDisposableStack", "AsyncDisposableStack")}} constructor.
• {{jsxref("AsyncDisposableStack.prototype.disposed")}}
  • : Read-only. Returns true if the AsyncDisposableStack has been disposed, or false if not.
• AsyncDisposableStack.prototype[Symbol.toStringTag]
  • : The initial value of the [Symbol.toStringTag] property is the string "AsyncDisposableStack". This property is used in {{jsxref("Object.prototype.toString()")}}.

Instance methods

• {{jsxref("AsyncDisposableStack.prototype.adopt()")}}
  • : Registers a value that doesn't implement the async disposable protocol to the stack by providing a custom disposer function.
• {{jsxref("AsyncDisposableStack.prototype.disposeAsync()")}}
  • : Disposes this stack by calling all disposers registered to it in reverse order of registration.
• {{jsxref("AsyncDisposableStack.prototype.defer()")}}
  • : Takes a callback function to be called when the stack is disposed.
• {{jsxref("AsyncDisposableStack.prototype.move()")}}
  • : Creates a new AsyncDisposableStack instance that contains the same disposers as this stack, and then marks this stack as disposed, without calling any disposers.
• {{jsxref("AsyncDisposableStack.prototype.use()")}}
  • : Registers a value that implements the async disposable protocol to the stack.
• AsyncDisposableStack.prototype[Symbol.asyncDispose]
  • : An alias for the disposeAsync() method.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• Polyfill of AsyncDisposableStack in core-js
• JavaScript resource management
• {{jsxref("Symbol.asyncDispose")}}
• {{jsxref("Statements/await_using", "await using")}}
• {{jsxref("DisposableStack")}}