Saltar al contenido

node:events

EventEmitter y auxiliares de eventos compatibles con Node.

En esta página
Open in ChatGPTOpen in Claude
import { EventEmitter } from "node:events";

const events = new EventEmitter();
events.once("ready", (value) => console.log(value));
events.emit("ready", 42);

El comportamiento admitido incluye llamadas síncronas y ordenadas a los listeners, listeners de un solo uso, eliminación de listeners, notificaciones newListener y removeListener, advertencias por número máximo de listeners y el lanzamiento de un evento error no gestionado.

El módulo incluye:

  • EventEmitter, once, on y listenerCount
  • getEventListeners, getMaxListeners y setMaxListeners
  • addAbortListener, errorMonitor y captureRejectionSymbol
  • EventEmitterAsyncResource

La función exportada once(emitter, name, { signal }) se rechaza con AbortError cuando la señal se aborta, incluso después de crearse la Promise.

Con la opción de constructor captureRejections, una Promise rechazada de un listener asíncrono se redirige al evento error del emisor.

Consulte la documentación de events de Node.js para ver las firmas estándar de los métodos.

Reference

Status: Full · 34 of 38 suite tests pass (89.5%) · since 1.1.0

Exports

ExportKindStatusNotes
EventEmitterclassFulladdListener(), on(), once(), prependListener(), prependOnceListener(), removeListener(), off(), removeAllListeners(), emit(), listenerCount(), listeners(), rawListeners(), eventNames(), setMaxListeners(), getMaxListeners(), EventEmitter.defaultMaxListeners, EventEmitter.once(), EventEmitter.listenerCount()

Tests: node-api node:events: 34 pass, 3 fail, 1 error, 6 skipped. Failing: test-event-capture-rejections.js, test-eventemitter-asyncresource.js, test-events-once.js, test-eventsource.js.

¿Te resultó útil esta página?