Upload folder using huggingface_hub

780c9fe verified 3 months ago

2.14 kB

title: DisposableStack.prototype.defer()
short-title: defer()
slug: Web/JavaScript/Reference/Global_Objects/DisposableStack/defer
page-type: javascript-instance-method
browser-compat: javascript.builtins.DisposableStack.defer
sidebar: jsref

The defer() method of {{jsxref("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 ({{jsxref("undefined")}}).

Exceptions

{{jsxref("TypeError")}}
- : Thrown if onDispose is not a function.
{{jsxref("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 {{jsxref("DisposableStack/use", "use()")}} or {{jsxref("DisposableStack/adopt", "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;
}

AbdulElahGwaith
/

content