events: Add use/useOnce methods to EventEmitter

[jasnell]

Marking this draft as I'm not 100% sure it's something we want. Looking for feedback and opinions.

This adds new use(...) and useOnce(...) methods to EventEmitter that returns a disposable object that will unregister the event listeners when disposed, along with two changes that use the new apis to demonstrate how it can be used to simplify some cleanup.

const ee = new EventEmitter();
{
  using ds = new DisposableStack();
  ds.use(ee.use('foo', () => {});
  ds.use(ee.use('bar', () => {});
  if (something) ds.use(ee.use('baz', () => {});
}
// The event listeners will all be removed automatically when ds is disposed.
// We don't need to separately remember to call removeListener/off to cleanup the event listeners

[nodejs-github-bot]

Review requested:

• @nodejs/streams
• @nodejs/test_runner

[LiviaMedeiros]

Opened #58454 to address this.

[LiviaMedeiros]

A lot of different things can extend EventEmitter class. The name use() is too generic and might also collide with existing userspace code, I think useEventListener() (or addDisposableEventListener(), onUse(), scopedOn(), etc., it's quite bikesheddable...) would be better.

[jasnell]

Yeah I kind of picked use here intentionally because of that ;-) ... wanted to prompt a discussion about it.

[jasnell]

Relevant to advancing on this: #58526