defer()

defer<Args>(func, ...args): Timeout

Defers invoking the function until the current call stack has cleared.

DEPRECATED

Use setTimeout(fn, 0) directly instead.

---

Type Parameters

Args: Args extends unknown[]

---

Parameters

func: (...args) => void

The function to defer.

args: ...Args

The arguments to invoke the function with.

---

Returns: Timeout

The timer id.

---

See Also

setTimeout() - MDN

---

Since

2.0.0

---

Also known as

defer (Lodash, es-toolkit) · ❌ (Remeda, Radashi, Ramda, Effect, Modern Dash, Antfu)

---

Example

// ❌ Deprecated approach
defer(console.log, 'deferred');

// ✅ Recommended approach
setTimeout(() => console.log('deferred'), 0);

---

How it works?

Defers invoking func until the current call stack clears. Deprecated: Use setTimeout(fn, 0) or queueMicrotask() directly.

Native Equivalent

// ❌ defer(fn)
// ✅ setTimeout(fn, 0)
// ✅ queueMicrotask(fn)

---

Use Cases

Defer execution 📌

Execute function after current call stack.

#defer#async#next tick#delay

queueMicrotask(() => {
  console.log("Deferred");
});

Defer to next tick

Schedule for next event loop iteration.

#defer#next#tick#async

setTimeout(() => {
  updateUI();
}, 0);

Non-blocking operation

Allow current execution to complete first.

#non-blocking#async#schedule

Promise.resolve().then(() => {
  heavyComputation();
});