EventEmitter | Workers 한국어

Note

For compatibility dates of 2026-08-04 or later, Workers enables both nodejs_compat and nodejs_compat_v2 by default. These flags are not used for these compatibility dates. Existing projects do not need to remove them when updating their compatibility date. For earlier dates, add nodejs_compat to your Wrangler configuration file to opt in. For instructions to turn off Node.js compatibility, refer to the Node.js compatibility flag.

An EventEmitter is an object that emits named events that cause listeners to be called.

import { EventEmitter } from "node:events";

const emitter = new EventEmitter();
emitter.on("hello", (...args) => {
	console.log(...args); // 1 2 3
});

emitter.emit("hello", 1, 2, 3);

The implementation in the Workers runtime supports the entire Node.js EventEmitter API. This includes the captureRejections option that allows improved handling of async functions as event handlers:

const emitter = new EventEmitter({ captureRejections: true });
emitter.on("hello", async (...args) => {
	throw new Error("boom");
});
emitter.on("error", (err) => {
	// the async promise rejection is emitted here!
});

Like Node.js, when an 'error' event is emitted on an EventEmitter and there is no listener for it, the error will be immediately thrown. However, in Node.js it is possible to add a handler on the process object for the 'uncaughtException' event to catch globally uncaught exceptions. The 'uncaughtException' event, however, is currently not implemented in the Workers runtime. It is strongly recommended to always add an 'error' listener to any EventEmitter instance.

Refer to the Node.js documentation for EventEmitter for more information.