The defer() method of DisposableStack instances takes a callback function to be called when the stack is disposed.
Syntax
defer(onDispose)
Parameters
onDispose- : A function that will be called when the stack is disposed. The function receives no arguments.
Return value
None (undefined).
Exceptions
- TypeError
- : Thrown if
onDisposeis not a function.
- : Thrown if
- ReferenceError
- : Thrown if the stack is already disposed.
Description
The primary purpose of defer() is to register a cleanup callback that's not specific to the disposal of a particular resource. If the callback is specific to a resource, you should use DisposableStack/use or DisposableStack/adopt instead. You can also use defer when the resource is not claimed within your code:
function consumeReader(reader) {
using disposer = new DisposableStack();
disposer.defer(() => reader.releaseLock());
// Do something with reader
}
Examples
Using defer()
This function sets a simple lock to prevent multiple async operations from running at the same time. The lock is released when the function completes.
let isLocked = false;
async function requestWithLock(url, options) {
if (isLocked) {
return undefined;
}
using disposer = new DisposableStack();
isLocked = true;
disposer.defer(() => (isLocked = false));
const data = await fetch(url, options).then((res) => res.json());
return data;
}
Specifications
Browser compatibility
See also
- Polyfill of
DisposableStack.prototype.deferincore-js - JavaScript resource management
- DisposableStack
- DisposableStack.prototype.adopt()
- DisposableStack.prototype.use()
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
