Aller au contenu

node:events

EventEmitter compatible Node et utilitaires d'événements.

Sur cette page
import { EventEmitter } from "node:events";

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

Le comportement pris en charge comprend les appels synchrones et ordonnés des écouteurs, les écouteurs à usage unique, la suppression d’écouteurs, les notifications newListener et removeListener, les avertissements sur le nombre maximal d’écouteurs et la levée d’un événement error non géré.

Le module comprend :

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

La fonction exportée once(emitter, name, { signal }) rejette avec AbortError lorsque le signal est interrompu, y compris après la création de la Promise.

Avec l’option de constructeur captureRejections, une Promise rejetée par un écouteur asynchrone est redirigée vers l’événement error de l’émetteur.

Consultez la documentation events de Node.js pour les signatures de méthodes standard.

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.

Cette page vous a-t-elle aidé ?