util: add util.disposer helper to wrap a dispose function

[legendecas]

Add util.disposer and util.asyncDisposer to conveniently wrap a
function to be a disposable, and allow it to be used with using
declaration.

[Renegade334]

Is this not the same functionality that DisposableStack.prototype.defer already provides natively?

[legendecas]

Is this not the same functionality that DisposableStack.prototype.defer already provides natively?

It is. This is a helper function if you just want to wrap a function, without the need to create a DisposableStack/AsyncDisposableStack, or define an object with Symbol.dispose/Symbol.asyncDispose.

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 90.20%. Comparing base (7ffa029) to head (c1f1080).
Report is 41 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main   #58585      +/-   ##
==========================================
- Coverage   90.24%   90.20%   -0.05%     
==========================================
  Files         635      636       +1     
  Lines      187633   187580      -53     
  Branches    36853    36852       -1     
==========================================
- Hits       169336   169213     -123     
- Misses      11082    11153      +71     
+ Partials     7215     7214       -1     

Files with missing lines	Coverage Δ
lib/internal/util/disposer.js	100.00% <100.00%> (ø)
lib/util.js	97.79% <100.00%> (+0.02%)	⬆️

... and 64 files with indirect coverage changes

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
• 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

[atlowChemi]

Suggested change

	await using _ = util.disposer(async function disposer() {
	await using _ = util.asyncDisposer(async function disposer() {

[atlowChemi]

Disposer and AsyncDisposer are not actually exported?

[jasnell]

Given that DisposableStack.defer(...) exists I'm not super convinced that this is needed or all that useful.

{
  using ds = new DisposableStack();
  ds.defer(onDispose);
}