Zum Inhalt springen

node:events

Node-kompatibler EventEmitter und Ereignis-Hilfsfunktionen.

Auf dieser Seite
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);

Unterstützt werden unter anderem geordnete synchrone Listener-Aufrufe, einmalige Listener, das Entfernen von Listenern, Benachrichtigungen über newListener und removeListener, Warnungen bei Überschreitung der maximalen Listener-Anzahl und das Werfen eines unbehandelten Ereignisses error.

Das Modul enthält:

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

Das exportierte once(emitter, name, { signal }) wird mit AbortError abgelehnt, wenn das Signal abbricht, auch nachdem das Promise erstellt wurde.

Mit der Konstruktoroption captureRejections wird ein abgelehntes Promise eines asynchronen Listeners an das Ereignis error des Emitters umgeleitet.

Die üblichen Methodensignaturen finden Sie in der Node.js-Dokumentation zu events.

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.

War diese Seite hilfreich?