From 802e6be4c7e2bfd08224fb6769fbe7b2d8ed0239 Mon Sep 17 00:00:00 2001
From: Anna Henningsen <anna@addaleax.net>
Date: Sat, 27 Aug 2016 10:45:34 +0200
Subject: [PATCH 1/2] events: make memory leak warning more accessible
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This makes the famous `EventEmitter memory leak` warnings occurring
when the listener count for a given event exceeds a specified number
more programatically accessible, by giving them properties referring
to the event emitter instance and the event itself.

This can be useful for debugging the origins of such a warning when
the stack itself doesn’t reveal enough information about the event
emitter instance itself, e.g. when manual inspection of the
already-registered listeners is expected to be useful.
---
 doc/api/events.md                             |  6 ++++++
 lib/events.js                                 |  7 ++++++-
 ...est-event-emitter-max-listeners-warning.js | 21 +++++++++++++++++++
 3 files changed, 33 insertions(+), 1 deletion(-)
 create mode 100644 test/parallel/test-event-emitter-max-listeners-warning.js

diff --git a/doc/api/events.md b/doc/api/events.md
index eab0bef17ed199..92b7bbd38c2162 100644
--- a/doc/api/events.md
+++ b/doc/api/events.md
@@ -278,6 +278,11 @@ emitter.once('event', () => {
 });
 ```
 
+The emitted warning can be inspected with [`process.on('warning')`][] and will
+have the additional `emitter`, `type` and `count` properties, referring to
+the event emitter instance, the event’s name and the number of attached
+listeners, respectively.
+
 ### emitter.addListener(eventName, listener)
 <!-- YAML
 added: v0.1.26
@@ -562,4 +567,5 @@ Returns a reference to the `EventEmitter`, so that calls can be chained.
 [`emitter.listenerCount()`]: #events_emitter_listenercount_eventname
 [`domain`]: domain.html
 [`process` object's `uncaughtException` event]: process.html#process_event_uncaughtexception
+[`process.on('warning')`]: process.html#process_event_warning
 [stream]: stream.html
diff --git a/lib/events.js b/lib/events.js
index 171f4868a66dac..162833b785c3da 100644
--- a/lib/events.js
+++ b/lib/events.js
@@ -256,9 +256,14 @@ function _addListener(target, type, listener, prepend) {
       m = $getMaxListeners(target);
       if (m && m > 0 && existing.length > m) {
         existing.warned = true;
-        process.emitWarning('Possible EventEmitter memory leak detected. ' +
+        const w = new Error('Possible EventEmitter memory leak detected. ' +
                             `${existing.length} ${type} listeners added. ` +
                             'Use emitter.setMaxListeners() to increase limit');
+        w.name = 'Warning';
+        w.emitter = target;
+        w.type = type;
+        w.count = existing.length;
+        process.emitWarning(w);
       }
     }
   }
diff --git a/test/parallel/test-event-emitter-max-listeners-warning.js b/test/parallel/test-event-emitter-max-listeners-warning.js
new file mode 100644
index 00000000000000..bcbb583265805c
--- /dev/null
+++ b/test/parallel/test-event-emitter-max-listeners-warning.js
@@ -0,0 +1,21 @@
+// Flags: --no-warnings
+// The flag suppresses stderr output but the warning event will still emit
+'use strict';
+
+const common = require('../common');
+const events = require('events');
+const assert = require('assert');
+
+const e = new events.EventEmitter();
+e.setMaxListeners(1);
+
+process.on('warning', common.mustCall((warning) => {
+  assert.ok(warning instanceof Error);
+  assert.strictEqual(warning.name, 'Warning');
+  assert.strictEqual(warning.emitter, e);
+  assert.strictEqual(warning.count, 2);
+  assert.strictEqual(warning.type, 'event-type');
+}));
+
+e.on('event-type', function() {});
+e.on('event-type', function() {});

From 473c38d9269bb5a088336a0abda903e4c8508887 Mon Sep 17 00:00:00 2001
From: Anna Henningsen <anna@addaleax.net>
Date: Sat, 27 Aug 2016 15:16:47 +0200
Subject: [PATCH 2/2] [squash] add note about `--trace-warnings` to docs

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

diff --git a/doc/api/events.md b/doc/api/events.md
index 92b7bbd38c2162..6b19287881c132 100644
--- a/doc/api/events.md
+++ b/doc/api/events.md
@@ -278,6 +278,9 @@ emitter.once('event', () => {
 });
 ```
 
+The [`--trace-warnings`][] command line flag can be used to display the
+stack trace for such warnings.
+
 The emitted warning can be inspected with [`process.on('warning')`][] and will
 have the additional `emitter`, `type` and `count` properties, referring to
 the event emitter instance, the event’s name and the number of attached
@@ -569,3 +572,4 @@ Returns a reference to the `EventEmitter`, so that calls can be chained.
 [`process` object's `uncaughtException` event]: process.html#process_event_uncaughtexception
 [`process.on('warning')`]: process.html#process_event_warning
 [stream]: stream.html
+[`--trace-warnings`]: cli.html#cli_trace_warnings