diff --git a/doc/api/events.md b/doc/api/events.md index 6f009d6bc7d4cd..f5a17224693360 100644 --- a/doc/api/events.md +++ b/doc/api/events.md @@ -1266,6 +1266,58 @@ const { getEventListeners, EventEmitter } = require('node:events'); } ``` +## `events.getMaxListeners(emitterOrTarget)` + + + +* `emitterOrTarget` {EventEmitter|EventTarget} +* Returns: {number} + +Returns the currently set max amount of listeners. + +For `EventEmitter`s this behaves exactly the same as calling `.getMaxListeners` on +the emitter. + +For `EventTarget`s this is the only way to get the max event listeners for the +event target. If the number of event handlers on a single EventTarget exceeds +the max set, the EventTarget will print a warning. + +```mjs +import { getMaxListeners, setMaxListeners, EventEmitter } from 'node:events'; + +{ + const ee = new EventEmitter(); + console.log(getMaxListeners(ee)); // 10 + setMaxListeners(11, ee); + console.log(getMaxListeners(ee)); // 11 +} +{ + const et = new EventTarget(); + console.log(getMaxListeners(et)); // 10 + setMaxListeners(11, et); + console.log(getMaxListeners(et)); // 11 +} +``` + +```cjs +const { getMaxListeners, setMaxListeners, EventEmitter } = require('node:events'); + +{ + const ee = new EventEmitter(); + console.log(getMaxListeners(ee)); // 10 + setMaxListeners(11, ee); + console.log(getMaxListeners(ee)); // 11 +} +{ + const et = new EventTarget(); + console.log(getMaxListeners(et)); // 10 + setMaxListeners(11, et); + console.log(getMaxListeners(et)); // 11 +} +``` + ## `events.once(emitter, name[, options])`