@types/events.d.ts

   1 import type { AsyncResource, AsyncResourceOptions } from 'node:async_hooks'
   2 import { EventEmitter } from 'node:events'
   3
   4 declare module 'events' {
   5   interface EventEmitterOptions {
   6     /**
   7      * Enables automatic capturing of promise rejection.
   8      */
   9     captureRejections?: boolean | undefined
  10   }
  11
  12   interface EventEmitterAsyncResourceOptions
  13     extends AsyncResourceOptions,
  14     EventEmitterOptions {
  15     /**
  16      * The type of async event.
  17      * @default new.target.name
  18      */
  19     name?: string
  20   }
  21
  22   /**
  23    * Integrates `EventEmitter` with `AsyncResource` for `EventEmitter`s that require
  24    * manual async tracking. Specifically, all events emitted by instances of
  25    * `EventEmitterAsyncResource` will run within its async context.
  26    *
  27    * The EventEmitterAsyncResource class has the same methods and takes the
  28    * same options as EventEmitter and AsyncResource themselves.
  29    * @throws if `options.name` is not provided when instantiated directly.
  30    * @since v17.4.0, v16.14.0
  31    */
  32   export class EventEmitterAsyncResource extends EventEmitter {
  33     constructor (options?: EventEmitterAsyncResourceOptions)
  34     /**
  35      * Call all `destroy` hooks. This should only ever be called once. An error will
  36      * be thrown if it is called more than once. This **must** be manually called. If
  37      * the resource is left to be collected by the GC then the `destroy` hooks will
  38      * never be called.
  39      */
  40     emitDestroy (): void
  41     /** The unique asyncId assigned to the resource. */
  42     readonly asyncId: number
  43     /** The same triggerAsyncId that is passed to the AsyncResource constructor. */
  44     readonly triggerAsyncId: number
  45     /** The underlying AsyncResource */
  46     readonly asyncResource: AsyncResource & {
  47       readonly eventEmitter: EventEmitterAsyncResource
  48     }
  49   }
  50 }