From a120cfc494abb358ebf1e916268b345d057768ff Mon Sep 17 00:00:00 2001
From: Khafra <42794878+KhafraDev@users.noreply.github.com>
Date: Fri, 10 Mar 2023 19:33:08 -0500
Subject: [PATCH 1/4] events: add getMaxListeners method

---
 doc/api/events.md                            | 51 ++++++++++++++++++++
 lib/events.js                                | 18 +++++++
 test/parallel/test-events-getmaxlisteners.js | 19 ++++++++
 3 files changed, 88 insertions(+)
 create mode 100644 test/parallel/test-events-getmaxlisteners.js

diff --git a/doc/api/events.md b/doc/api/events.md
index f1ee1de01121a1..cc72b4e35e8780 100644
--- a/doc/api/events.md
+++ b/doc/api/events.md
@@ -1266,6 +1266,57 @@ const { getEventListeners, EventEmitter } = require('node:events');
 }
 ```
 
+## `events.getMaxListeners(emitterOrTarget)`
+
+<!-- YAML
+added: REPLACEME
+-->
+
+* `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.
+
+```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])`
 
 <!-- YAML
diff --git a/lib/events.js b/lib/events.js
index 89f13ac37be120..ed707b5300be61 100644
--- a/lib/events.js
+++ b/lib/events.js
@@ -220,6 +220,7 @@ module.exports = EventEmitter;
 module.exports.once = once;
 module.exports.on = on;
 module.exports.getEventListeners = getEventListeners;
+module.exports.getMaxListeners = getMaxListeners;
 // Backwards-compat with node 0.10.x
 EventEmitter.EventEmitter = EventEmitter;
 
@@ -930,6 +931,23 @@ function getEventListeners(emitterOrTarget, type) {
                                  emitterOrTarget);
 }
 
+/**
+ * Returns the max listeners set.
+ * @param {EventEmitter | EventTarget} emitterOrTarget
+ * @returns {number}
+ */
+function getMaxListeners(emitterOrTarget) {
+  if (typeof emitterOrTarget?.getMaxListeners === 'function') {
+    return _getMaxListeners(emitterOrTarget);
+  } else if (emitterOrTarget?.[kMaxEventTargetListeners]) {
+    return emitterOrTarget[kMaxEventTargetListeners];
+  }
+
+  throw new ERR_INVALID_ARG_TYPE('emitter',
+                                 ['EventEmitter', 'EventTarget'],
+                                 emitterOrTarget);
+}
+
 /**
  * Creates a `Promise` that is fulfilled when the emitter
  * emits the given event.
diff --git a/test/parallel/test-events-getmaxlisteners.js b/test/parallel/test-events-getmaxlisteners.js
new file mode 100644
index 00000000000000..4f013e2e3c4ba3
--- /dev/null
+++ b/test/parallel/test-events-getmaxlisteners.js
@@ -0,0 +1,19 @@
+'use strict';
+
+require('../common');
+const assert = require('node:assert');
+const { getMaxListeners, EventEmitter, defaultMaxListeners, setMaxListeners } = require('node:events');
+
+{
+  const ee = new EventEmitter();
+  assert.strictEqual(getMaxListeners(ee), defaultMaxListeners);
+  setMaxListeners(101, ee);
+  assert.strictEqual(getMaxListeners(ee), 101);
+}
+
+{
+  const et = new EventTarget();
+  assert.strictEqual(getMaxListeners(et), defaultMaxListeners);
+  setMaxListeners(101, et);
+  assert.strictEqual(getMaxListeners(et), 101);
+}

From 8dba19d93c7b7c49850bb9078d887b86a3a42bd9 Mon Sep 17 00:00:00 2001
From: Khafra <42794878+KhafraDev@users.noreply.github.com>
Date: Fri, 10 Mar 2023 19:52:01 -0500
Subject: [PATCH 2/4] fix line breaks

---
 test/parallel/test-events-getmaxlisteners.js | 38 ++++++++++----------
 1 file changed, 19 insertions(+), 19 deletions(-)

diff --git a/test/parallel/test-events-getmaxlisteners.js b/test/parallel/test-events-getmaxlisteners.js
index 4f013e2e3c4ba3..05b4e75b7218fb 100644
--- a/test/parallel/test-events-getmaxlisteners.js
+++ b/test/parallel/test-events-getmaxlisteners.js
@@ -1,19 +1,19 @@
-'use strict';
-
-require('../common');
-const assert = require('node:assert');
-const { getMaxListeners, EventEmitter, defaultMaxListeners, setMaxListeners } = require('node:events');
-
-{
-  const ee = new EventEmitter();
-  assert.strictEqual(getMaxListeners(ee), defaultMaxListeners);
-  setMaxListeners(101, ee);
-  assert.strictEqual(getMaxListeners(ee), 101);
-}
-
-{
-  const et = new EventTarget();
-  assert.strictEqual(getMaxListeners(et), defaultMaxListeners);
-  setMaxListeners(101, et);
-  assert.strictEqual(getMaxListeners(et), 101);
-}
+'use strict';
+
+require('../common');
+const assert = require('node:assert');
+const { getMaxListeners, EventEmitter, defaultMaxListeners, setMaxListeners } = require('node:events');
+
+{
+  const ee = new EventEmitter();
+  assert.strictEqual(getMaxListeners(ee), defaultMaxListeners);
+  setMaxListeners(101, ee);
+  assert.strictEqual(getMaxListeners(ee), 101);
+}
+
+{
+  const et = new EventTarget();
+  assert.strictEqual(getMaxListeners(et), defaultMaxListeners);
+  setMaxListeners(101, et);
+  assert.strictEqual(getMaxListeners(et), 101);
+}

From a216477d501a4e0f98a994fcc31d4129916e2e30 Mon Sep 17 00:00:00 2001
From: Khafra <42794878+KhafraDev@users.noreply.github.com>
Date: Tue, 14 Mar 2023 22:35:42 -0400
Subject: [PATCH 3/4] docs: add note about warning

---
 doc/api/events.md | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/doc/api/events.md b/doc/api/events.md
index cc72b4e35e8780..40f90e3c2847c8 100644
--- a/doc/api/events.md
+++ b/doc/api/events.md
@@ -1281,7 +1281,8 @@ For `EventEmitter`s this behaves exactly the same as calling `.getMaxListeners`
 the emitter.
 
 For `EventTarget`s this is the only way to get the max event listeners for the
-event target.
+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';

From d84881f6fb58e407161ec39ed4404452ca914f68 Mon Sep 17 00:00:00 2001
From: Khafra <42794878+KhafraDev@users.noreply.github.com>
Date: Thu, 16 Mar 2023 10:00:47 -0400
Subject: [PATCH 4/4] fix: lint

---
 doc/api/events.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/doc/api/events.md b/doc/api/events.md
index 40f90e3c2847c8..b57a875c67b28e 100644
--- a/doc/api/events.md
+++ b/doc/api/events.md
@@ -1281,8 +1281,8 @@ For `EventEmitter`s this behaves exactly the same as calling `.getMaxListeners`
 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.
+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';