events: optimize once() and removeListener() - #64373

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener
Jul 13, 2026
Merged

events: optimize once() and removeListener()#64373
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener

Conversation

@mcollina

Copy link
Copy Markdown
Member

Optimize the EventEmitter hot paths:

  • rewrite the once() wrapper as a closure instead of bind() + a state object
  • keep the _events object shape in removeListener(): store undefined instead of delete-ing keys or reallocating the object (eventNames() now filters, matching Stream.prototype.eventNames); removes the now-unused kShapeMode
  • outline the unhandled error path from emit() (439 → 278 bytecodes) and the max-listeners warning from _addListener() (405 → 288) so both fit within the V8 inlining budgets

benchmark/compare.js --runs 30 before/after all changes:

events
 confidence improvement accuracy (*) (**) (***)
events/ee-add-remove.js n=1000000 removeListener=0 newListener=0 *** 12.59 % ±1.59% ±2.11% ±2.76%
events/ee-add-remove.js n=1000000 removeListener=0 newListener=1 * 2.37 % ±1.92% ±2.58% ±3.40%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=0 *** 15.12 % ±1.14% ±1.52% ±1.99%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=1 *** 21.82 % ±2.24% ±3.01% ±3.97%
events/ee-emit.js listeners=1 argc=0 n=2000000 0.89 % ±3.72% ±4.95% ±6.47%
events/ee-emit.js listeners=1 argc=10 n=2000000 -0.85 % ±2.46% ±3.28% ±4.28%
events/ee-emit.js listeners=1 argc=2 n=2000000 1.25 % ±3.73% ±4.97% ±6.50%
events/ee-emit.js listeners=1 argc=4 n=2000000 -0.11 % ±2.91% ±3.87% ±5.04%
events/ee-emit.js listeners=10 argc=0 n=2000000 0.99 % ±1.95% ±2.60% ±3.38%
events/ee-emit.js listeners=10 argc=10 n=2000000 -0.24 % ±1.64% ±2.18% ±2.84%
events/ee-emit.js listeners=10 argc=2 n=2000000 0.05 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=10 argc=4 n=2000000 ** 2.22 % ±1.60% ±2.13% ±2.77%
events/ee-emit.js listeners=5 argc=0 n=2000000 1.82 % ±2.04% ±2.72% ±3.54%
events/ee-emit.js listeners=5 argc=10 n=2000000 -0.26 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=5 argc=2 n=2000000 * -2.25 % ±1.96% ±2.61% ±3.39%
events/ee-emit.js listeners=5 argc=4 n=2000000 0.64 % ±2.11% ±2.81% ±3.66%
events/ee-listen-unique.js n=1000000 events=1 *** 14.85 % ±0.80% ±1.06% ±1.39%
events/ee-listen-unique.js n=1000000 events=10 *** 8.46 % ±1.28% ±1.71% ±2.23%
events/ee-listen-unique.js n=1000000 events=2 *** 14.09 % ±0.88% ±1.18% ±1.54%
events/ee-listen-unique.js n=1000000 events=20 *** 7.53 % ±1.38% ±1.84% ±2.40%
events/ee-listen-unique.js n=1000000 events=3 *** 9.24 % ±1.83% ±2.44% ±3.20%
events/ee-listen-unique.js n=1000000 events=5 *** 13.22 % ±1.39% ±1.86% ±2.45%
events/ee-listener-count-on-prototype.js n=50000000 0.14 % ±0.82% ±1.09% ±1.41%
events/ee-listeners.js raw='false' listeners=5 n=5000000 *** -3.03 % ±1.73% ±2.31% ±3.03%
events/ee-listeners.js raw='false' listeners=50 n=5000000 -0.00 % ±0.54% ±0.72% ±0.94%
events/ee-listeners.js raw='true' listeners=5 n=5000000 *** 5.87 % ±2.69% ±3.59% ±4.68%
events/ee-listeners.js raw='true' listeners=50 n=5000000 -0.14 % ±1.05% ±1.40% ±1.83%
events/ee-once.js argc=0 n=20000000 *** 25.71 % ±1.08% ±1.43% ±1.87%
events/ee-once.js argc=1 n=20000000 *** 24.94 % ±0.77% ±1.02% ±1.33%
events/ee-once.js argc=4 n=20000000 *** 25.14 % ±0.92% ±1.23% ±1.61%
events/ee-once.js argc=5 n=20000000 *** 25.63 % ±0.90% ±1.21% ±1.58%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 31 comparisons, you can thus expect the following amount of false-positive results:
1.55 false positives, when considering a 5% risk acceptance (*, **, ***),
0.31 false positives, when considering a 1% risk acceptance (**, ***),
0.03 false positives, when considering a 0.1% risk acceptance (***)
streams
 confidence improvement accuracy (*) (**) (***)
streams/creation.js kind='duplex' n=50000000 *** 1.32 % ±0.61% ±0.81% ±1.05%
streams/creation.js kind='readable' n=50000000 -0.37 % ±0.61% ±0.81% ±1.06%
streams/creation.js kind='transform' n=50000000 * 3.83 % ±3.24% ±4.37% ±5.78%
streams/creation.js kind='writable' n=50000000 *** 2.83 % ±0.55% ±0.73% ±0.95%
streams/destroy.js kind='duplex' n=1000000 -0.08 % ±0.64% ±0.85% ±1.11%
streams/destroy.js kind='readable' n=1000000 *** 3.98 % ±1.82% ±2.42% ±3.16%
streams/destroy.js kind='transform' n=1000000 0.32 % ±0.54% ±0.72% ±0.94%
streams/destroy.js kind='writable' n=1000000 *** 2.57 % ±0.60% ±0.79% ±1.03%
streams/iter-creation.js n=100000 type='pair' api='classic' 1.49 % ±4.62% ±6.15% ±8.00%
streams/iter-creation.js n=100000 type='pair' api='iter' 0.02 % ±0.78% ±1.04% ±1.35%
streams/iter-creation.js n=100000 type='pair' api='webstream' -0.31 % ±1.61% ±2.14% ±2.78%
streams/iter-creation.js n=100000 type='readable' api='classic' -0.15 % ±5.01% ±6.67% ±8.69%
streams/iter-creation.js n=100000 type='readable' api='iter' 0.48 % ±2.18% ±2.90% ±3.77%
streams/iter-creation.js n=100000 type='readable' api='webstream' -0.29 % ±1.71% ±2.27% ±2.96%
streams/iter-creation.js n=100000 type='transform' api='classic' 1.97 % ±2.41% ±3.21% ±4.18%
streams/iter-creation.js n=100000 type='transform' api='webstream' 0.19 % ±0.86% ±1.14% ±1.49%
streams/iter-creation.js n=100000 type='writable' api='classic' 1.07 % ±2.10% ±2.80% ±3.64%
streams/iter-creation.js n=100000 type='writable' api='iter' 0.60 % ±1.89% ±2.51% ±3.27%
streams/iter-creation.js n=100000 type='writable' api='webstream' -0.18 % ±1.23% ±1.64% ±2.13%
streams/pipe.js n=5000000 *** 13.92 % ±1.41% ±1.88% ±2.45%
streams/readable-async-iterator.js sync='no' n=100000 * 2.45 % ±1.86% ±2.48% ±3.24%
streams/readable-async-iterator.js sync='yes' n=100000 -3.12 % ±3.85% ±5.15% ±6.76%
streams/readable-bigread.js n=1000 0.14 % ±2.98% ±3.96% ±5.16%
streams/readable-readall.js n=5000 -0.24 % ±2.49% ±3.32% ±4.33%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='no' n=100000 -0.87 % ±2.73% ±3.64% ±4.75%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='yes' n=100000 1.20 % ±4.18% ±5.57% ±7.29%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='no' n=100000 2.47 % ±5.23% ±6.98% ±9.13%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='yes' n=100000 -1.24 % ±7.14% ±9.50% ±12.36%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='no' n=100000 * 2.65 % ±2.43% ±3.23% ±4.22%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='yes' n=100000 ** 8.29 % ±5.26% ±7.00% ±9.11%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='no' n=100000 2.01 % ±4.22% ±5.62% ±7.31%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='yes' n=100000 * 5.16 % ±5.15% ±6.85% ±8.92%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='no' n=100000 2.67 % ±3.56% ±4.73% ±6.16%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='yes' n=100000 * 5.65 % ±4.82% ±6.42% ±8.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='no' n=100000 -0.76 % ±1.95% ±2.59% ±3.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='yes' n=100000 4.26 % ±8.13% ±10.81% ±14.07%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='no' n=100000 -1.57 % ±3.42% ±4.56% ±5.94%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='yes' n=100000 2.83 % ±4.44% ±5.91% ±7.69%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='no' n=100000 -0.87 % ±2.98% ±3.96% ±5.16%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='yes' n=100000 2.03 % ±5.96% ±7.93% ±10.32%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 40 comparisons, you can thus expect the following amount of false-positive results:
2.00 false positives, when considering a 5% risk acceptance (*, **, ***),
0.40 false positives, when considering a 1% risk acceptance (**, ***),
0.04 false positives, when considering a 0.1% risk acceptance (***)

Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
@nodejs-github-botnodejs-github-bot added events Issues and PRs related to EventEmitter and the events module. needs-ci PRs that need a full CI run. labels Jul 8, 2026
@codecov

codecovBot commented Jul 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.24%. Comparing base (1d87a24) to head (ce6c9ad).
⚠️ Report is 43 commits behind head on main.

Additional details and impacted files
@@ Coverage Diff @@## main #64373 +/- ##
==========================================
- Coverage 90.25% 90.24% -0.01% 
==========================================
Files 741 741 Lines 240990 241196 +206 Branches 45402 45431 +29 ==========================================
+ Hits 217502 217666 +164 - Misses 15066 15086 +20 - Partials 8422 8444 +22 
Files with missing linesCoverage Δ
lib/events.js99.59% <100.00%> (+<0.01%)⬆️

... and 48 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment threadlib/events.js
configurable: true,
});
} catch {
// Continue regardless of error.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you expand this to explain why we're ignoring the error?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this isn't new but it's always bugged me that's it's not explained :-)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the lines above we are trying to expand the stacktrace. If we can't for whatever reasons, we don't hide the original error.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasnell do you want me to update the comment?

@mcollinamcollina added the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@mcollinamcollina added commit-queue PRs queued for automated landing through the Commit Queue. author ready PRs with CI started, the required approvals, and no outstanding review comments. and removed needs-ci PRs that need a full CI run. labels Jul 13, 2026
@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Jul 13, 2026
@nodejs-github-bot
nodejs-github-bot merged commit 384d7a4 into nodejs:mainJul 13, 2026
84 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in 384d7a4

Comment threadlib/events.js
// the `events` object in the same shape and avoids both a `delete`
// (which would put the object into dictionary mode) and allocating
// a fresh object when the last listener is removed.
events[type] = undefined;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can cause memory leaks when using unstructured event names, I.e random ids etc...

@mcollina
mcollina deleted the events-optimize-once-removelistener branch July 13, 2026 16:02
mcollina added a commit to mcollina/node that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: nodejs#64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
nodejs-github-bot pushed a commit that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs with CI started, the required approvals, and no outstanding review comments.eventsIssues and PRs related to EventEmitter and the events module.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@mcollina@nodejs-github-bot@jasnell@anonrig@ronag
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Add copy buttons to all
 blocks\n(function() {\n function addCopyButtons() {\n document.querySelectorAll('pre code').forEach(function(codeBlock) {\n if (codeBlock.parentElement.hasAttribute('data-copy-added')) return;\n codeBlock.parentElement.setAttribute('data-copy-added', 'true');\n \n var btn = document.createElement('button');\n btn.textContent = 'Copy';\n btn.style.cssText = 'position:absolute;top:4px;right:4px;padding:2px 8px;font-size:11px;background:#4ecdc4;border:none;border-radius:4px;color:#1a1a2e;cursor:pointer;opacity:0.7;transition:opacity 0.2s;';\n btn.onmouseover = function() { this.style.opacity = '1'; };\n btn.onmouseout = function() { this.style.opacity = '0.7'; };\n btn.onclick = function() {\n navigator.clipboard.writeText(codeBlock.textContent).then(function() {\n btn.textContent = 'Copied!';\n setTimeout(function() { btn.textContent = 'Copy'; }, 1500);\n });\n };\n codeBlock.parentElement.style.position = 'relative';\n codeBlock.parentElement.appendChild(btn);\n });\n }\n \n addCopyButtons();\n \n // Re-run on dynamic content\n var observer = new MutationObserver(addCopyButtons);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Add Copy Buttons to Code Blocks");
}
} catch(__e) { console.warn('[Userscript:Add Copy Buttons to Code Blocks]', __e); }
})();
(function(){
try {
var __m = "github.com";
var __re = new RegExp('^' + "github\\.com" + '
Skip to content

events: optimize once() and removeListener() - #64373

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener
Jul 13, 2026
Merged

events: optimize once() and removeListener()#64373
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener

Conversation

@mcollina

Copy link
Copy Markdown
Member

Optimize the EventEmitter hot paths:

  • rewrite the once() wrapper as a closure instead of bind() + a state object
  • keep the _events object shape in removeListener(): store undefined instead of delete-ing keys or reallocating the object (eventNames() now filters, matching Stream.prototype.eventNames); removes the now-unused kShapeMode
  • outline the unhandled error path from emit() (439 → 278 bytecodes) and the max-listeners warning from _addListener() (405 → 288) so both fit within the V8 inlining budgets

benchmark/compare.js --runs 30 before/after all changes:

events
 confidence improvement accuracy (*) (**) (***)
events/ee-add-remove.js n=1000000 removeListener=0 newListener=0 *** 12.59 % ±1.59% ±2.11% ±2.76%
events/ee-add-remove.js n=1000000 removeListener=0 newListener=1 * 2.37 % ±1.92% ±2.58% ±3.40%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=0 *** 15.12 % ±1.14% ±1.52% ±1.99%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=1 *** 21.82 % ±2.24% ±3.01% ±3.97%
events/ee-emit.js listeners=1 argc=0 n=2000000 0.89 % ±3.72% ±4.95% ±6.47%
events/ee-emit.js listeners=1 argc=10 n=2000000 -0.85 % ±2.46% ±3.28% ±4.28%
events/ee-emit.js listeners=1 argc=2 n=2000000 1.25 % ±3.73% ±4.97% ±6.50%
events/ee-emit.js listeners=1 argc=4 n=2000000 -0.11 % ±2.91% ±3.87% ±5.04%
events/ee-emit.js listeners=10 argc=0 n=2000000 0.99 % ±1.95% ±2.60% ±3.38%
events/ee-emit.js listeners=10 argc=10 n=2000000 -0.24 % ±1.64% ±2.18% ±2.84%
events/ee-emit.js listeners=10 argc=2 n=2000000 0.05 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=10 argc=4 n=2000000 ** 2.22 % ±1.60% ±2.13% ±2.77%
events/ee-emit.js listeners=5 argc=0 n=2000000 1.82 % ±2.04% ±2.72% ±3.54%
events/ee-emit.js listeners=5 argc=10 n=2000000 -0.26 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=5 argc=2 n=2000000 * -2.25 % ±1.96% ±2.61% ±3.39%
events/ee-emit.js listeners=5 argc=4 n=2000000 0.64 % ±2.11% ±2.81% ±3.66%
events/ee-listen-unique.js n=1000000 events=1 *** 14.85 % ±0.80% ±1.06% ±1.39%
events/ee-listen-unique.js n=1000000 events=10 *** 8.46 % ±1.28% ±1.71% ±2.23%
events/ee-listen-unique.js n=1000000 events=2 *** 14.09 % ±0.88% ±1.18% ±1.54%
events/ee-listen-unique.js n=1000000 events=20 *** 7.53 % ±1.38% ±1.84% ±2.40%
events/ee-listen-unique.js n=1000000 events=3 *** 9.24 % ±1.83% ±2.44% ±3.20%
events/ee-listen-unique.js n=1000000 events=5 *** 13.22 % ±1.39% ±1.86% ±2.45%
events/ee-listener-count-on-prototype.js n=50000000 0.14 % ±0.82% ±1.09% ±1.41%
events/ee-listeners.js raw='false' listeners=5 n=5000000 *** -3.03 % ±1.73% ±2.31% ±3.03%
events/ee-listeners.js raw='false' listeners=50 n=5000000 -0.00 % ±0.54% ±0.72% ±0.94%
events/ee-listeners.js raw='true' listeners=5 n=5000000 *** 5.87 % ±2.69% ±3.59% ±4.68%
events/ee-listeners.js raw='true' listeners=50 n=5000000 -0.14 % ±1.05% ±1.40% ±1.83%
events/ee-once.js argc=0 n=20000000 *** 25.71 % ±1.08% ±1.43% ±1.87%
events/ee-once.js argc=1 n=20000000 *** 24.94 % ±0.77% ±1.02% ±1.33%
events/ee-once.js argc=4 n=20000000 *** 25.14 % ±0.92% ±1.23% ±1.61%
events/ee-once.js argc=5 n=20000000 *** 25.63 % ±0.90% ±1.21% ±1.58%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 31 comparisons, you can thus expect the following amount of false-positive results:
1.55 false positives, when considering a 5% risk acceptance (*, **, ***),
0.31 false positives, when considering a 1% risk acceptance (**, ***),
0.03 false positives, when considering a 0.1% risk acceptance (***)
streams
 confidence improvement accuracy (*) (**) (***)
streams/creation.js kind='duplex' n=50000000 *** 1.32 % ±0.61% ±0.81% ±1.05%
streams/creation.js kind='readable' n=50000000 -0.37 % ±0.61% ±0.81% ±1.06%
streams/creation.js kind='transform' n=50000000 * 3.83 % ±3.24% ±4.37% ±5.78%
streams/creation.js kind='writable' n=50000000 *** 2.83 % ±0.55% ±0.73% ±0.95%
streams/destroy.js kind='duplex' n=1000000 -0.08 % ±0.64% ±0.85% ±1.11%
streams/destroy.js kind='readable' n=1000000 *** 3.98 % ±1.82% ±2.42% ±3.16%
streams/destroy.js kind='transform' n=1000000 0.32 % ±0.54% ±0.72% ±0.94%
streams/destroy.js kind='writable' n=1000000 *** 2.57 % ±0.60% ±0.79% ±1.03%
streams/iter-creation.js n=100000 type='pair' api='classic' 1.49 % ±4.62% ±6.15% ±8.00%
streams/iter-creation.js n=100000 type='pair' api='iter' 0.02 % ±0.78% ±1.04% ±1.35%
streams/iter-creation.js n=100000 type='pair' api='webstream' -0.31 % ±1.61% ±2.14% ±2.78%
streams/iter-creation.js n=100000 type='readable' api='classic' -0.15 % ±5.01% ±6.67% ±8.69%
streams/iter-creation.js n=100000 type='readable' api='iter' 0.48 % ±2.18% ±2.90% ±3.77%
streams/iter-creation.js n=100000 type='readable' api='webstream' -0.29 % ±1.71% ±2.27% ±2.96%
streams/iter-creation.js n=100000 type='transform' api='classic' 1.97 % ±2.41% ±3.21% ±4.18%
streams/iter-creation.js n=100000 type='transform' api='webstream' 0.19 % ±0.86% ±1.14% ±1.49%
streams/iter-creation.js n=100000 type='writable' api='classic' 1.07 % ±2.10% ±2.80% ±3.64%
streams/iter-creation.js n=100000 type='writable' api='iter' 0.60 % ±1.89% ±2.51% ±3.27%
streams/iter-creation.js n=100000 type='writable' api='webstream' -0.18 % ±1.23% ±1.64% ±2.13%
streams/pipe.js n=5000000 *** 13.92 % ±1.41% ±1.88% ±2.45%
streams/readable-async-iterator.js sync='no' n=100000 * 2.45 % ±1.86% ±2.48% ±3.24%
streams/readable-async-iterator.js sync='yes' n=100000 -3.12 % ±3.85% ±5.15% ±6.76%
streams/readable-bigread.js n=1000 0.14 % ±2.98% ±3.96% ±5.16%
streams/readable-readall.js n=5000 -0.24 % ±2.49% ±3.32% ±4.33%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='no' n=100000 -0.87 % ±2.73% ±3.64% ±4.75%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='yes' n=100000 1.20 % ±4.18% ±5.57% ±7.29%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='no' n=100000 2.47 % ±5.23% ±6.98% ±9.13%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='yes' n=100000 -1.24 % ±7.14% ±9.50% ±12.36%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='no' n=100000 * 2.65 % ±2.43% ±3.23% ±4.22%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='yes' n=100000 ** 8.29 % ±5.26% ±7.00% ±9.11%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='no' n=100000 2.01 % ±4.22% ±5.62% ±7.31%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='yes' n=100000 * 5.16 % ±5.15% ±6.85% ±8.92%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='no' n=100000 2.67 % ±3.56% ±4.73% ±6.16%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='yes' n=100000 * 5.65 % ±4.82% ±6.42% ±8.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='no' n=100000 -0.76 % ±1.95% ±2.59% ±3.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='yes' n=100000 4.26 % ±8.13% ±10.81% ±14.07%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='no' n=100000 -1.57 % ±3.42% ±4.56% ±5.94%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='yes' n=100000 2.83 % ±4.44% ±5.91% ±7.69%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='no' n=100000 -0.87 % ±2.98% ±3.96% ±5.16%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='yes' n=100000 2.03 % ±5.96% ±7.93% ±10.32%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 40 comparisons, you can thus expect the following amount of false-positive results:
2.00 false positives, when considering a 5% risk acceptance (*, **, ***),
0.40 false positives, when considering a 1% risk acceptance (**, ***),
0.04 false positives, when considering a 0.1% risk acceptance (***)

Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
@nodejs-github-botnodejs-github-bot added events Issues and PRs related to EventEmitter and the events module. needs-ci PRs that need a full CI run. labels Jul 8, 2026
@codecov

codecovBot commented Jul 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.24%. Comparing base (1d87a24) to head (ce6c9ad).
⚠️ Report is 43 commits behind head on main.

Additional details and impacted files
@@ Coverage Diff @@## main #64373 +/- ##
==========================================
- Coverage 90.25% 90.24% -0.01% 
==========================================
Files 741 741 Lines 240990 241196 +206 Branches 45402 45431 +29 ==========================================
+ Hits 217502 217666 +164 - Misses 15066 15086 +20 - Partials 8422 8444 +22 
Files with missing linesCoverage Δ
lib/events.js99.59% <100.00%> (+<0.01%)⬆️

... and 48 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment threadlib/events.js
configurable: true,
});
} catch {
// Continue regardless of error.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you expand this to explain why we're ignoring the error?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this isn't new but it's always bugged me that's it's not explained :-)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the lines above we are trying to expand the stacktrace. If we can't for whatever reasons, we don't hide the original error.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasnell do you want me to update the comment?

@mcollinamcollina added the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@mcollinamcollina added commit-queue PRs queued for automated landing through the Commit Queue. author ready PRs with CI started, the required approvals, and no outstanding review comments. and removed needs-ci PRs that need a full CI run. labels Jul 13, 2026
@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Jul 13, 2026
@nodejs-github-bot
nodejs-github-bot merged commit 384d7a4 into nodejs:mainJul 13, 2026
84 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in 384d7a4

Comment threadlib/events.js
// the `events` object in the same shape and avoids both a `delete`
// (which would put the object into dictionary mode) and allocating
// a fresh object when the last listener is removed.
events[type] = undefined;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can cause memory leaks when using unstructured event names, I.e random ids etc...

@mcollina
mcollina deleted the events-optimize-once-removelistener branch July 13, 2026 16:02
mcollina added a commit to mcollina/node that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: nodejs#64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
nodejs-github-bot pushed a commit that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs with CI started, the required approvals, and no outstanding review comments.eventsIssues and PRs related to EventEmitter and the events module.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@mcollina@nodejs-github-bot@jasnell@anonrig@ronag
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Force GitHub README to respect dark mode\n(function() {\n var style = document.createElement('style');\n style.textContent = '\n .markdown-body {\n color-scheme: dark light;\n }\n .markdown-body pre { background: #161b22 !important; }\n .markdown-body code { background: rgba(110, 118, 129, 0.4) !important; }\n .markdown-body table th, .markdown-body table td { border-color: #30363d !important; }\n .markdown-body img { background: #0d1117; }\n .markdown-body blockquote { border-left-color: #8b949e; }\n .markdown-body hr { border-color: #30363d; }\n ';\n document.head.appendChild(style);\n})();", "GitHub Dark Mode README Fix"); } } catch(__e) { console.warn('[Userscript:GitHub Dark Mode README Fix]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

events: optimize once() and removeListener() - #64373

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener
Jul 13, 2026
Merged

events: optimize once() and removeListener()#64373
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener

Conversation

@mcollina

Copy link
Copy Markdown
Member

Optimize the EventEmitter hot paths:

  • rewrite the once() wrapper as a closure instead of bind() + a state object
  • keep the _events object shape in removeListener(): store undefined instead of delete-ing keys or reallocating the object (eventNames() now filters, matching Stream.prototype.eventNames); removes the now-unused kShapeMode
  • outline the unhandled error path from emit() (439 → 278 bytecodes) and the max-listeners warning from _addListener() (405 → 288) so both fit within the V8 inlining budgets

benchmark/compare.js --runs 30 before/after all changes:

events
 confidence improvement accuracy (*) (**) (***)
events/ee-add-remove.js n=1000000 removeListener=0 newListener=0 *** 12.59 % ±1.59% ±2.11% ±2.76%
events/ee-add-remove.js n=1000000 removeListener=0 newListener=1 * 2.37 % ±1.92% ±2.58% ±3.40%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=0 *** 15.12 % ±1.14% ±1.52% ±1.99%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=1 *** 21.82 % ±2.24% ±3.01% ±3.97%
events/ee-emit.js listeners=1 argc=0 n=2000000 0.89 % ±3.72% ±4.95% ±6.47%
events/ee-emit.js listeners=1 argc=10 n=2000000 -0.85 % ±2.46% ±3.28% ±4.28%
events/ee-emit.js listeners=1 argc=2 n=2000000 1.25 % ±3.73% ±4.97% ±6.50%
events/ee-emit.js listeners=1 argc=4 n=2000000 -0.11 % ±2.91% ±3.87% ±5.04%
events/ee-emit.js listeners=10 argc=0 n=2000000 0.99 % ±1.95% ±2.60% ±3.38%
events/ee-emit.js listeners=10 argc=10 n=2000000 -0.24 % ±1.64% ±2.18% ±2.84%
events/ee-emit.js listeners=10 argc=2 n=2000000 0.05 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=10 argc=4 n=2000000 ** 2.22 % ±1.60% ±2.13% ±2.77%
events/ee-emit.js listeners=5 argc=0 n=2000000 1.82 % ±2.04% ±2.72% ±3.54%
events/ee-emit.js listeners=5 argc=10 n=2000000 -0.26 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=5 argc=2 n=2000000 * -2.25 % ±1.96% ±2.61% ±3.39%
events/ee-emit.js listeners=5 argc=4 n=2000000 0.64 % ±2.11% ±2.81% ±3.66%
events/ee-listen-unique.js n=1000000 events=1 *** 14.85 % ±0.80% ±1.06% ±1.39%
events/ee-listen-unique.js n=1000000 events=10 *** 8.46 % ±1.28% ±1.71% ±2.23%
events/ee-listen-unique.js n=1000000 events=2 *** 14.09 % ±0.88% ±1.18% ±1.54%
events/ee-listen-unique.js n=1000000 events=20 *** 7.53 % ±1.38% ±1.84% ±2.40%
events/ee-listen-unique.js n=1000000 events=3 *** 9.24 % ±1.83% ±2.44% ±3.20%
events/ee-listen-unique.js n=1000000 events=5 *** 13.22 % ±1.39% ±1.86% ±2.45%
events/ee-listener-count-on-prototype.js n=50000000 0.14 % ±0.82% ±1.09% ±1.41%
events/ee-listeners.js raw='false' listeners=5 n=5000000 *** -3.03 % ±1.73% ±2.31% ±3.03%
events/ee-listeners.js raw='false' listeners=50 n=5000000 -0.00 % ±0.54% ±0.72% ±0.94%
events/ee-listeners.js raw='true' listeners=5 n=5000000 *** 5.87 % ±2.69% ±3.59% ±4.68%
events/ee-listeners.js raw='true' listeners=50 n=5000000 -0.14 % ±1.05% ±1.40% ±1.83%
events/ee-once.js argc=0 n=20000000 *** 25.71 % ±1.08% ±1.43% ±1.87%
events/ee-once.js argc=1 n=20000000 *** 24.94 % ±0.77% ±1.02% ±1.33%
events/ee-once.js argc=4 n=20000000 *** 25.14 % ±0.92% ±1.23% ±1.61%
events/ee-once.js argc=5 n=20000000 *** 25.63 % ±0.90% ±1.21% ±1.58%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 31 comparisons, you can thus expect the following amount of false-positive results:
1.55 false positives, when considering a 5% risk acceptance (*, **, ***),
0.31 false positives, when considering a 1% risk acceptance (**, ***),
0.03 false positives, when considering a 0.1% risk acceptance (***)
streams
 confidence improvement accuracy (*) (**) (***)
streams/creation.js kind='duplex' n=50000000 *** 1.32 % ±0.61% ±0.81% ±1.05%
streams/creation.js kind='readable' n=50000000 -0.37 % ±0.61% ±0.81% ±1.06%
streams/creation.js kind='transform' n=50000000 * 3.83 % ±3.24% ±4.37% ±5.78%
streams/creation.js kind='writable' n=50000000 *** 2.83 % ±0.55% ±0.73% ±0.95%
streams/destroy.js kind='duplex' n=1000000 -0.08 % ±0.64% ±0.85% ±1.11%
streams/destroy.js kind='readable' n=1000000 *** 3.98 % ±1.82% ±2.42% ±3.16%
streams/destroy.js kind='transform' n=1000000 0.32 % ±0.54% ±0.72% ±0.94%
streams/destroy.js kind='writable' n=1000000 *** 2.57 % ±0.60% ±0.79% ±1.03%
streams/iter-creation.js n=100000 type='pair' api='classic' 1.49 % ±4.62% ±6.15% ±8.00%
streams/iter-creation.js n=100000 type='pair' api='iter' 0.02 % ±0.78% ±1.04% ±1.35%
streams/iter-creation.js n=100000 type='pair' api='webstream' -0.31 % ±1.61% ±2.14% ±2.78%
streams/iter-creation.js n=100000 type='readable' api='classic' -0.15 % ±5.01% ±6.67% ±8.69%
streams/iter-creation.js n=100000 type='readable' api='iter' 0.48 % ±2.18% ±2.90% ±3.77%
streams/iter-creation.js n=100000 type='readable' api='webstream' -0.29 % ±1.71% ±2.27% ±2.96%
streams/iter-creation.js n=100000 type='transform' api='classic' 1.97 % ±2.41% ±3.21% ±4.18%
streams/iter-creation.js n=100000 type='transform' api='webstream' 0.19 % ±0.86% ±1.14% ±1.49%
streams/iter-creation.js n=100000 type='writable' api='classic' 1.07 % ±2.10% ±2.80% ±3.64%
streams/iter-creation.js n=100000 type='writable' api='iter' 0.60 % ±1.89% ±2.51% ±3.27%
streams/iter-creation.js n=100000 type='writable' api='webstream' -0.18 % ±1.23% ±1.64% ±2.13%
streams/pipe.js n=5000000 *** 13.92 % ±1.41% ±1.88% ±2.45%
streams/readable-async-iterator.js sync='no' n=100000 * 2.45 % ±1.86% ±2.48% ±3.24%
streams/readable-async-iterator.js sync='yes' n=100000 -3.12 % ±3.85% ±5.15% ±6.76%
streams/readable-bigread.js n=1000 0.14 % ±2.98% ±3.96% ±5.16%
streams/readable-readall.js n=5000 -0.24 % ±2.49% ±3.32% ±4.33%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='no' n=100000 -0.87 % ±2.73% ±3.64% ±4.75%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='yes' n=100000 1.20 % ±4.18% ±5.57% ±7.29%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='no' n=100000 2.47 % ±5.23% ±6.98% ±9.13%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='yes' n=100000 -1.24 % ±7.14% ±9.50% ±12.36%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='no' n=100000 * 2.65 % ±2.43% ±3.23% ±4.22%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='yes' n=100000 ** 8.29 % ±5.26% ±7.00% ±9.11%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='no' n=100000 2.01 % ±4.22% ±5.62% ±7.31%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='yes' n=100000 * 5.16 % ±5.15% ±6.85% ±8.92%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='no' n=100000 2.67 % ±3.56% ±4.73% ±6.16%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='yes' n=100000 * 5.65 % ±4.82% ±6.42% ±8.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='no' n=100000 -0.76 % ±1.95% ±2.59% ±3.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='yes' n=100000 4.26 % ±8.13% ±10.81% ±14.07%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='no' n=100000 -1.57 % ±3.42% ±4.56% ±5.94%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='yes' n=100000 2.83 % ±4.44% ±5.91% ±7.69%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='no' n=100000 -0.87 % ±2.98% ±3.96% ±5.16%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='yes' n=100000 2.03 % ±5.96% ±7.93% ±10.32%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 40 comparisons, you can thus expect the following amount of false-positive results:
2.00 false positives, when considering a 5% risk acceptance (*, **, ***),
0.40 false positives, when considering a 1% risk acceptance (**, ***),
0.04 false positives, when considering a 0.1% risk acceptance (***)

Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
@nodejs-github-botnodejs-github-bot added events Issues and PRs related to EventEmitter and the events module. needs-ci PRs that need a full CI run. labels Jul 8, 2026
@codecov

codecovBot commented Jul 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.24%. Comparing base (1d87a24) to head (ce6c9ad).
⚠️ Report is 43 commits behind head on main.

Additional details and impacted files
@@ Coverage Diff @@## main #64373 +/- ##
==========================================
- Coverage 90.25% 90.24% -0.01% 
==========================================
Files 741 741 Lines 240990 241196 +206 Branches 45402 45431 +29 ==========================================
+ Hits 217502 217666 +164 - Misses 15066 15086 +20 - Partials 8422 8444 +22 
Files with missing linesCoverage Δ
lib/events.js99.59% <100.00%> (+<0.01%)⬆️

... and 48 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment threadlib/events.js
configurable: true,
});
} catch {
// Continue regardless of error.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you expand this to explain why we're ignoring the error?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this isn't new but it's always bugged me that's it's not explained :-)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the lines above we are trying to expand the stacktrace. If we can't for whatever reasons, we don't hide the original error.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasnell do you want me to update the comment?

@mcollinamcollina added the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@mcollinamcollina added commit-queue PRs queued for automated landing through the Commit Queue. author ready PRs with CI started, the required approvals, and no outstanding review comments. and removed needs-ci PRs that need a full CI run. labels Jul 13, 2026
@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Jul 13, 2026
@nodejs-github-bot
nodejs-github-bot merged commit 384d7a4 into nodejs:mainJul 13, 2026
84 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in 384d7a4

Comment threadlib/events.js
// the `events` object in the same shape and avoids both a `delete`
// (which would put the object into dictionary mode) and allocating
// a fresh object when the last listener is removed.
events[type] = undefined;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can cause memory leaks when using unstructured event names, I.e random ids etc...

@mcollina
mcollina deleted the events-optimize-once-removelistener branch July 13, 2026 16:02
mcollina added a commit to mcollina/node that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: nodejs#64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
nodejs-github-bot pushed a commit that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs with CI started, the required approvals, and no outstanding review comments.eventsIssues and PRs related to EventEmitter and the events module.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@mcollina@nodejs-github-bot@jasnell@anonrig@ronag
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Highlight search terms from Google/DuckDuckGo/Bing referrer\n(function() {\n var ref = document.referrer;\n var terms = [];\n \n if (ref.includes('google.com') || ref.includes('duckduckgo.com') || ref.includes('bing.com')) {\n var url = new URL(ref);\n var q = url.searchParams.get('q') || url.searchParams.get('p');\n if (q) {\n terms = q.split(/\\s+/).filter(function(t) { return t.length > 2; });\n }\n }\n \n if (terms.length === 0) return;\n \n var style = document.createElement('style');\n style.textContent = '.userscript-highlight { background: #fbbf24; color: #1a1a2e; padding: 1px 3px; border-radius: 2px; }';\n document.head.appendChild(style);\n \n function highlight(node) {\n if (node.nodeType === 3) { // text node\n var text = node.textContent;\n var found = false;\n terms.forEach(function(term) {\n var regex = new RegExp('(' + term.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\') + ')', 'gi');\n if (regex.test(text)) {\n found = true;\n var frag = document.createDocumentFragment();\n var parts = text.split(regex);\n parts.forEach(function(part, i) {\n if (i % 2 === 0) {\n frag.appendChild(document.createTextNode(part));\n } else {\n var span = document.createElement('span');\n span.className = 'userscript-highlight';\n span.textContent = part;\n frag.appendChild(span);\n }\n });\n node.parentNode.replaceChild(frag, node);\n }\n });\n } else if (node.nodeType === 1 && node.childNodes) { // element\n var skipTags = ['SCRIPT', 'STYLE', 'NOSCRIPT', 'TEXTAREA', 'INPUT', 'SELECT'];\n if (!skipTags.includes(node.tagName)) {\n Array.from(node.childNodes).forEach(highlight);\n }\n }\n }\n \n highlight(document.body);\n \n // Re-highlight on dynamic content\n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1 || node.nodeType === 3) highlight(node);\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Highlight Search Terms"); } } catch(__e) { console.warn('[Userscript:Highlight Search Terms]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

events: optimize once() and removeListener() - #64373

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener
Jul 13, 2026
Merged

events: optimize once() and removeListener()#64373
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener

Conversation

@mcollina

Copy link
Copy Markdown
Member

Optimize the EventEmitter hot paths:

  • rewrite the once() wrapper as a closure instead of bind() + a state object
  • keep the _events object shape in removeListener(): store undefined instead of delete-ing keys or reallocating the object (eventNames() now filters, matching Stream.prototype.eventNames); removes the now-unused kShapeMode
  • outline the unhandled error path from emit() (439 → 278 bytecodes) and the max-listeners warning from _addListener() (405 → 288) so both fit within the V8 inlining budgets

benchmark/compare.js --runs 30 before/after all changes:

events
 confidence improvement accuracy (*) (**) (***)
events/ee-add-remove.js n=1000000 removeListener=0 newListener=0 *** 12.59 % ±1.59% ±2.11% ±2.76%
events/ee-add-remove.js n=1000000 removeListener=0 newListener=1 * 2.37 % ±1.92% ±2.58% ±3.40%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=0 *** 15.12 % ±1.14% ±1.52% ±1.99%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=1 *** 21.82 % ±2.24% ±3.01% ±3.97%
events/ee-emit.js listeners=1 argc=0 n=2000000 0.89 % ±3.72% ±4.95% ±6.47%
events/ee-emit.js listeners=1 argc=10 n=2000000 -0.85 % ±2.46% ±3.28% ±4.28%
events/ee-emit.js listeners=1 argc=2 n=2000000 1.25 % ±3.73% ±4.97% ±6.50%
events/ee-emit.js listeners=1 argc=4 n=2000000 -0.11 % ±2.91% ±3.87% ±5.04%
events/ee-emit.js listeners=10 argc=0 n=2000000 0.99 % ±1.95% ±2.60% ±3.38%
events/ee-emit.js listeners=10 argc=10 n=2000000 -0.24 % ±1.64% ±2.18% ±2.84%
events/ee-emit.js listeners=10 argc=2 n=2000000 0.05 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=10 argc=4 n=2000000 ** 2.22 % ±1.60% ±2.13% ±2.77%
events/ee-emit.js listeners=5 argc=0 n=2000000 1.82 % ±2.04% ±2.72% ±3.54%
events/ee-emit.js listeners=5 argc=10 n=2000000 -0.26 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=5 argc=2 n=2000000 * -2.25 % ±1.96% ±2.61% ±3.39%
events/ee-emit.js listeners=5 argc=4 n=2000000 0.64 % ±2.11% ±2.81% ±3.66%
events/ee-listen-unique.js n=1000000 events=1 *** 14.85 % ±0.80% ±1.06% ±1.39%
events/ee-listen-unique.js n=1000000 events=10 *** 8.46 % ±1.28% ±1.71% ±2.23%
events/ee-listen-unique.js n=1000000 events=2 *** 14.09 % ±0.88% ±1.18% ±1.54%
events/ee-listen-unique.js n=1000000 events=20 *** 7.53 % ±1.38% ±1.84% ±2.40%
events/ee-listen-unique.js n=1000000 events=3 *** 9.24 % ±1.83% ±2.44% ±3.20%
events/ee-listen-unique.js n=1000000 events=5 *** 13.22 % ±1.39% ±1.86% ±2.45%
events/ee-listener-count-on-prototype.js n=50000000 0.14 % ±0.82% ±1.09% ±1.41%
events/ee-listeners.js raw='false' listeners=5 n=5000000 *** -3.03 % ±1.73% ±2.31% ±3.03%
events/ee-listeners.js raw='false' listeners=50 n=5000000 -0.00 % ±0.54% ±0.72% ±0.94%
events/ee-listeners.js raw='true' listeners=5 n=5000000 *** 5.87 % ±2.69% ±3.59% ±4.68%
events/ee-listeners.js raw='true' listeners=50 n=5000000 -0.14 % ±1.05% ±1.40% ±1.83%
events/ee-once.js argc=0 n=20000000 *** 25.71 % ±1.08% ±1.43% ±1.87%
events/ee-once.js argc=1 n=20000000 *** 24.94 % ±0.77% ±1.02% ±1.33%
events/ee-once.js argc=4 n=20000000 *** 25.14 % ±0.92% ±1.23% ±1.61%
events/ee-once.js argc=5 n=20000000 *** 25.63 % ±0.90% ±1.21% ±1.58%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 31 comparisons, you can thus expect the following amount of false-positive results:
1.55 false positives, when considering a 5% risk acceptance (*, **, ***),
0.31 false positives, when considering a 1% risk acceptance (**, ***),
0.03 false positives, when considering a 0.1% risk acceptance (***)
streams
 confidence improvement accuracy (*) (**) (***)
streams/creation.js kind='duplex' n=50000000 *** 1.32 % ±0.61% ±0.81% ±1.05%
streams/creation.js kind='readable' n=50000000 -0.37 % ±0.61% ±0.81% ±1.06%
streams/creation.js kind='transform' n=50000000 * 3.83 % ±3.24% ±4.37% ±5.78%
streams/creation.js kind='writable' n=50000000 *** 2.83 % ±0.55% ±0.73% ±0.95%
streams/destroy.js kind='duplex' n=1000000 -0.08 % ±0.64% ±0.85% ±1.11%
streams/destroy.js kind='readable' n=1000000 *** 3.98 % ±1.82% ±2.42% ±3.16%
streams/destroy.js kind='transform' n=1000000 0.32 % ±0.54% ±0.72% ±0.94%
streams/destroy.js kind='writable' n=1000000 *** 2.57 % ±0.60% ±0.79% ±1.03%
streams/iter-creation.js n=100000 type='pair' api='classic' 1.49 % ±4.62% ±6.15% ±8.00%
streams/iter-creation.js n=100000 type='pair' api='iter' 0.02 % ±0.78% ±1.04% ±1.35%
streams/iter-creation.js n=100000 type='pair' api='webstream' -0.31 % ±1.61% ±2.14% ±2.78%
streams/iter-creation.js n=100000 type='readable' api='classic' -0.15 % ±5.01% ±6.67% ±8.69%
streams/iter-creation.js n=100000 type='readable' api='iter' 0.48 % ±2.18% ±2.90% ±3.77%
streams/iter-creation.js n=100000 type='readable' api='webstream' -0.29 % ±1.71% ±2.27% ±2.96%
streams/iter-creation.js n=100000 type='transform' api='classic' 1.97 % ±2.41% ±3.21% ±4.18%
streams/iter-creation.js n=100000 type='transform' api='webstream' 0.19 % ±0.86% ±1.14% ±1.49%
streams/iter-creation.js n=100000 type='writable' api='classic' 1.07 % ±2.10% ±2.80% ±3.64%
streams/iter-creation.js n=100000 type='writable' api='iter' 0.60 % ±1.89% ±2.51% ±3.27%
streams/iter-creation.js n=100000 type='writable' api='webstream' -0.18 % ±1.23% ±1.64% ±2.13%
streams/pipe.js n=5000000 *** 13.92 % ±1.41% ±1.88% ±2.45%
streams/readable-async-iterator.js sync='no' n=100000 * 2.45 % ±1.86% ±2.48% ±3.24%
streams/readable-async-iterator.js sync='yes' n=100000 -3.12 % ±3.85% ±5.15% ±6.76%
streams/readable-bigread.js n=1000 0.14 % ±2.98% ±3.96% ±5.16%
streams/readable-readall.js n=5000 -0.24 % ±2.49% ±3.32% ±4.33%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='no' n=100000 -0.87 % ±2.73% ±3.64% ±4.75%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='yes' n=100000 1.20 % ±4.18% ±5.57% ±7.29%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='no' n=100000 2.47 % ±5.23% ±6.98% ±9.13%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='yes' n=100000 -1.24 % ±7.14% ±9.50% ±12.36%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='no' n=100000 * 2.65 % ±2.43% ±3.23% ±4.22%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='yes' n=100000 ** 8.29 % ±5.26% ±7.00% ±9.11%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='no' n=100000 2.01 % ±4.22% ±5.62% ±7.31%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='yes' n=100000 * 5.16 % ±5.15% ±6.85% ±8.92%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='no' n=100000 2.67 % ±3.56% ±4.73% ±6.16%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='yes' n=100000 * 5.65 % ±4.82% ±6.42% ±8.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='no' n=100000 -0.76 % ±1.95% ±2.59% ±3.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='yes' n=100000 4.26 % ±8.13% ±10.81% ±14.07%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='no' n=100000 -1.57 % ±3.42% ±4.56% ±5.94%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='yes' n=100000 2.83 % ±4.44% ±5.91% ±7.69%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='no' n=100000 -0.87 % ±2.98% ±3.96% ±5.16%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='yes' n=100000 2.03 % ±5.96% ±7.93% ±10.32%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 40 comparisons, you can thus expect the following amount of false-positive results:
2.00 false positives, when considering a 5% risk acceptance (*, **, ***),
0.40 false positives, when considering a 1% risk acceptance (**, ***),
0.04 false positives, when considering a 0.1% risk acceptance (***)

Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
@nodejs-github-botnodejs-github-bot added events Issues and PRs related to EventEmitter and the events module. needs-ci PRs that need a full CI run. labels Jul 8, 2026
@codecov

codecovBot commented Jul 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.24%. Comparing base (1d87a24) to head (ce6c9ad).
⚠️ Report is 43 commits behind head on main.

Additional details and impacted files
@@ Coverage Diff @@## main #64373 +/- ##
==========================================
- Coverage 90.25% 90.24% -0.01% 
==========================================
Files 741 741 Lines 240990 241196 +206 Branches 45402 45431 +29 ==========================================
+ Hits 217502 217666 +164 - Misses 15066 15086 +20 - Partials 8422 8444 +22 
Files with missing linesCoverage Δ
lib/events.js99.59% <100.00%> (+<0.01%)⬆️

... and 48 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment threadlib/events.js
configurable: true,
});
} catch {
// Continue regardless of error.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you expand this to explain why we're ignoring the error?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this isn't new but it's always bugged me that's it's not explained :-)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the lines above we are trying to expand the stacktrace. If we can't for whatever reasons, we don't hide the original error.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasnell do you want me to update the comment?

@mcollinamcollina added the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@mcollinamcollina added commit-queue PRs queued for automated landing through the Commit Queue. author ready PRs with CI started, the required approvals, and no outstanding review comments. and removed needs-ci PRs that need a full CI run. labels Jul 13, 2026
@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Jul 13, 2026
@nodejs-github-bot
nodejs-github-bot merged commit 384d7a4 into nodejs:mainJul 13, 2026
84 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in 384d7a4

Comment threadlib/events.js
// the `events` object in the same shape and avoids both a `delete`
// (which would put the object into dictionary mode) and allocating
// a fresh object when the last listener is removed.
events[type] = undefined;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can cause memory leaks when using unstructured event names, I.e random ids etc...

@mcollina
mcollina deleted the events-optimize-once-removelistener branch July 13, 2026 16:02
mcollina added a commit to mcollina/node that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: nodejs#64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
nodejs-github-bot pushed a commit that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs with CI started, the required approvals, and no outstanding review comments.eventsIssues and PRs related to EventEmitter and the events module.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@mcollina@nodejs-github-bot@jasnell@anonrig@ronag
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Strip utm_, fbclid, gclid, etc. from all links on page\n(function() {\n var trackingParams = ['utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n 'fbclid', 'gclid', 'dclid', 'msclkid', 'yclid',\n 'ref', 'ref_src', 'source', 'medium', 'campaign'];\n \n function cleanUrl(url) {\n try {\n var u = new URL(url, window.location.origin);\n var changed = false;\n trackingParams.forEach(function(p) {\n if (u.searchParams.has(p)) {\n u.searchParams.delete(p);\n changed = true;\n }\n });\n return changed ? u.toString() : url;\n } catch (e) {\n return url;\n }\n }\n \n function cleanLinks() {\n document.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n \n cleanLinks();\n \n var observer = new MutationObserver(function(mutations) {\n mutations.forEach(function(m) {\n m.addedNodes.forEach(function(node) {\n if (node.nodeType === 1) {\n if (node.tagName === 'A') cleanLinks();\n node.querySelectorAll('a[href]').forEach(function(a) {\n var clean = cleanUrl(a.href);\n if (clean !== a.href) a.href = clean;\n });\n }\n });\n });\n });\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "Remove Tracking Parameters from Links"); } } catch(__e) { console.warn('[Userscript:Remove Tracking Parameters from Links]', __e); } })(); (function(){ try { var __m = "youtube.com"; var __re = new RegExp('^' + "youtube\\.com" + '
Skip to content

events: optimize once() and removeListener() - #64373

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener
Jul 13, 2026
Merged

events: optimize once() and removeListener()#64373
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener

Conversation

@mcollina

Copy link
Copy Markdown
Member

Optimize the EventEmitter hot paths:

  • rewrite the once() wrapper as a closure instead of bind() + a state object
  • keep the _events object shape in removeListener(): store undefined instead of delete-ing keys or reallocating the object (eventNames() now filters, matching Stream.prototype.eventNames); removes the now-unused kShapeMode
  • outline the unhandled error path from emit() (439 → 278 bytecodes) and the max-listeners warning from _addListener() (405 → 288) so both fit within the V8 inlining budgets

benchmark/compare.js --runs 30 before/after all changes:

events
 confidence improvement accuracy (*) (**) (***)
events/ee-add-remove.js n=1000000 removeListener=0 newListener=0 *** 12.59 % ±1.59% ±2.11% ±2.76%
events/ee-add-remove.js n=1000000 removeListener=0 newListener=1 * 2.37 % ±1.92% ±2.58% ±3.40%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=0 *** 15.12 % ±1.14% ±1.52% ±1.99%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=1 *** 21.82 % ±2.24% ±3.01% ±3.97%
events/ee-emit.js listeners=1 argc=0 n=2000000 0.89 % ±3.72% ±4.95% ±6.47%
events/ee-emit.js listeners=1 argc=10 n=2000000 -0.85 % ±2.46% ±3.28% ±4.28%
events/ee-emit.js listeners=1 argc=2 n=2000000 1.25 % ±3.73% ±4.97% ±6.50%
events/ee-emit.js listeners=1 argc=4 n=2000000 -0.11 % ±2.91% ±3.87% ±5.04%
events/ee-emit.js listeners=10 argc=0 n=2000000 0.99 % ±1.95% ±2.60% ±3.38%
events/ee-emit.js listeners=10 argc=10 n=2000000 -0.24 % ±1.64% ±2.18% ±2.84%
events/ee-emit.js listeners=10 argc=2 n=2000000 0.05 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=10 argc=4 n=2000000 ** 2.22 % ±1.60% ±2.13% ±2.77%
events/ee-emit.js listeners=5 argc=0 n=2000000 1.82 % ±2.04% ±2.72% ±3.54%
events/ee-emit.js listeners=5 argc=10 n=2000000 -0.26 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=5 argc=2 n=2000000 * -2.25 % ±1.96% ±2.61% ±3.39%
events/ee-emit.js listeners=5 argc=4 n=2000000 0.64 % ±2.11% ±2.81% ±3.66%
events/ee-listen-unique.js n=1000000 events=1 *** 14.85 % ±0.80% ±1.06% ±1.39%
events/ee-listen-unique.js n=1000000 events=10 *** 8.46 % ±1.28% ±1.71% ±2.23%
events/ee-listen-unique.js n=1000000 events=2 *** 14.09 % ±0.88% ±1.18% ±1.54%
events/ee-listen-unique.js n=1000000 events=20 *** 7.53 % ±1.38% ±1.84% ±2.40%
events/ee-listen-unique.js n=1000000 events=3 *** 9.24 % ±1.83% ±2.44% ±3.20%
events/ee-listen-unique.js n=1000000 events=5 *** 13.22 % ±1.39% ±1.86% ±2.45%
events/ee-listener-count-on-prototype.js n=50000000 0.14 % ±0.82% ±1.09% ±1.41%
events/ee-listeners.js raw='false' listeners=5 n=5000000 *** -3.03 % ±1.73% ±2.31% ±3.03%
events/ee-listeners.js raw='false' listeners=50 n=5000000 -0.00 % ±0.54% ±0.72% ±0.94%
events/ee-listeners.js raw='true' listeners=5 n=5000000 *** 5.87 % ±2.69% ±3.59% ±4.68%
events/ee-listeners.js raw='true' listeners=50 n=5000000 -0.14 % ±1.05% ±1.40% ±1.83%
events/ee-once.js argc=0 n=20000000 *** 25.71 % ±1.08% ±1.43% ±1.87%
events/ee-once.js argc=1 n=20000000 *** 24.94 % ±0.77% ±1.02% ±1.33%
events/ee-once.js argc=4 n=20000000 *** 25.14 % ±0.92% ±1.23% ±1.61%
events/ee-once.js argc=5 n=20000000 *** 25.63 % ±0.90% ±1.21% ±1.58%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 31 comparisons, you can thus expect the following amount of false-positive results:
1.55 false positives, when considering a 5% risk acceptance (*, **, ***),
0.31 false positives, when considering a 1% risk acceptance (**, ***),
0.03 false positives, when considering a 0.1% risk acceptance (***)
streams
 confidence improvement accuracy (*) (**) (***)
streams/creation.js kind='duplex' n=50000000 *** 1.32 % ±0.61% ±0.81% ±1.05%
streams/creation.js kind='readable' n=50000000 -0.37 % ±0.61% ±0.81% ±1.06%
streams/creation.js kind='transform' n=50000000 * 3.83 % ±3.24% ±4.37% ±5.78%
streams/creation.js kind='writable' n=50000000 *** 2.83 % ±0.55% ±0.73% ±0.95%
streams/destroy.js kind='duplex' n=1000000 -0.08 % ±0.64% ±0.85% ±1.11%
streams/destroy.js kind='readable' n=1000000 *** 3.98 % ±1.82% ±2.42% ±3.16%
streams/destroy.js kind='transform' n=1000000 0.32 % ±0.54% ±0.72% ±0.94%
streams/destroy.js kind='writable' n=1000000 *** 2.57 % ±0.60% ±0.79% ±1.03%
streams/iter-creation.js n=100000 type='pair' api='classic' 1.49 % ±4.62% ±6.15% ±8.00%
streams/iter-creation.js n=100000 type='pair' api='iter' 0.02 % ±0.78% ±1.04% ±1.35%
streams/iter-creation.js n=100000 type='pair' api='webstream' -0.31 % ±1.61% ±2.14% ±2.78%
streams/iter-creation.js n=100000 type='readable' api='classic' -0.15 % ±5.01% ±6.67% ±8.69%
streams/iter-creation.js n=100000 type='readable' api='iter' 0.48 % ±2.18% ±2.90% ±3.77%
streams/iter-creation.js n=100000 type='readable' api='webstream' -0.29 % ±1.71% ±2.27% ±2.96%
streams/iter-creation.js n=100000 type='transform' api='classic' 1.97 % ±2.41% ±3.21% ±4.18%
streams/iter-creation.js n=100000 type='transform' api='webstream' 0.19 % ±0.86% ±1.14% ±1.49%
streams/iter-creation.js n=100000 type='writable' api='classic' 1.07 % ±2.10% ±2.80% ±3.64%
streams/iter-creation.js n=100000 type='writable' api='iter' 0.60 % ±1.89% ±2.51% ±3.27%
streams/iter-creation.js n=100000 type='writable' api='webstream' -0.18 % ±1.23% ±1.64% ±2.13%
streams/pipe.js n=5000000 *** 13.92 % ±1.41% ±1.88% ±2.45%
streams/readable-async-iterator.js sync='no' n=100000 * 2.45 % ±1.86% ±2.48% ±3.24%
streams/readable-async-iterator.js sync='yes' n=100000 -3.12 % ±3.85% ±5.15% ±6.76%
streams/readable-bigread.js n=1000 0.14 % ±2.98% ±3.96% ±5.16%
streams/readable-readall.js n=5000 -0.24 % ±2.49% ±3.32% ±4.33%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='no' n=100000 -0.87 % ±2.73% ±3.64% ±4.75%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='yes' n=100000 1.20 % ±4.18% ±5.57% ±7.29%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='no' n=100000 2.47 % ±5.23% ±6.98% ±9.13%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='yes' n=100000 -1.24 % ±7.14% ±9.50% ±12.36%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='no' n=100000 * 2.65 % ±2.43% ±3.23% ±4.22%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='yes' n=100000 ** 8.29 % ±5.26% ±7.00% ±9.11%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='no' n=100000 2.01 % ±4.22% ±5.62% ±7.31%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='yes' n=100000 * 5.16 % ±5.15% ±6.85% ±8.92%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='no' n=100000 2.67 % ±3.56% ±4.73% ±6.16%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='yes' n=100000 * 5.65 % ±4.82% ±6.42% ±8.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='no' n=100000 -0.76 % ±1.95% ±2.59% ±3.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='yes' n=100000 4.26 % ±8.13% ±10.81% ±14.07%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='no' n=100000 -1.57 % ±3.42% ±4.56% ±5.94%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='yes' n=100000 2.83 % ±4.44% ±5.91% ±7.69%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='no' n=100000 -0.87 % ±2.98% ±3.96% ±5.16%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='yes' n=100000 2.03 % ±5.96% ±7.93% ±10.32%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 40 comparisons, you can thus expect the following amount of false-positive results:
2.00 false positives, when considering a 5% risk acceptance (*, **, ***),
0.40 false positives, when considering a 1% risk acceptance (**, ***),
0.04 false positives, when considering a 0.1% risk acceptance (***)

Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
@nodejs-github-botnodejs-github-bot added events Issues and PRs related to EventEmitter and the events module. needs-ci PRs that need a full CI run. labels Jul 8, 2026
@codecov

codecovBot commented Jul 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.24%. Comparing base (1d87a24) to head (ce6c9ad).
⚠️ Report is 43 commits behind head on main.

Additional details and impacted files
@@ Coverage Diff @@## main #64373 +/- ##
==========================================
- Coverage 90.25% 90.24% -0.01% 
==========================================
Files 741 741 Lines 240990 241196 +206 Branches 45402 45431 +29 ==========================================
+ Hits 217502 217666 +164 - Misses 15066 15086 +20 - Partials 8422 8444 +22 
Files with missing linesCoverage Δ
lib/events.js99.59% <100.00%> (+<0.01%)⬆️

... and 48 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment threadlib/events.js
configurable: true,
});
} catch {
// Continue regardless of error.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you expand this to explain why we're ignoring the error?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this isn't new but it's always bugged me that's it's not explained :-)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the lines above we are trying to expand the stacktrace. If we can't for whatever reasons, we don't hide the original error.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasnell do you want me to update the comment?

@mcollinamcollina added the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@mcollinamcollina added commit-queue PRs queued for automated landing through the Commit Queue. author ready PRs with CI started, the required approvals, and no outstanding review comments. and removed needs-ci PRs that need a full CI run. labels Jul 13, 2026
@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Jul 13, 2026
@nodejs-github-bot
nodejs-github-bot merged commit 384d7a4 into nodejs:mainJul 13, 2026
84 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in 384d7a4

Comment threadlib/events.js
// the `events` object in the same shape and avoids both a `delete`
// (which would put the object into dictionary mode) and allocating
// a fresh object when the last listener is removed.
events[type] = undefined;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can cause memory leaks when using unstructured event names, I.e random ids etc...

@mcollina
mcollina deleted the events-optimize-once-removelistener branch July 13, 2026 16:02
mcollina added a commit to mcollina/node that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: nodejs#64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
nodejs-github-bot pushed a commit that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs with CI started, the required approvals, and no outstanding review comments.eventsIssues and PRs related to EventEmitter and the events module.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@mcollina@nodejs-github-bot@jasnell@anonrig@ronag
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Auto-enable theater mode on YouTube\n(function() {\n function tryTheater() {\n var btn = document.querySelector('button[aria-label=\"Theater mode\"], ytd-player #player button[title=\"Theater mode\"]');\n if (btn && !btn.classList.contains('activated')) {\n btn.click();\n }\n }\n \n // Try immediately\n tryTheater();\n \n // Try after navigation (SPA)\n var lastUrl = location.href;\n setInterval(function() {\n if (location.href !== lastUrl) {\n lastUrl = location.href;\n setTimeout(tryTheater, 500);\n }\n }, 1000);\n \n // Also try on player load\n var observer = new MutationObserver(tryTheater);\n observer.observe(document.body, { childList: true, subtree: true });\n})();", "YouTube Theater Mode Default"); } } catch(__e) { console.warn('[Userscript:YouTube Theater Mode Default]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

events: optimize once() and removeListener() - #64373

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener
Jul 13, 2026
Merged

events: optimize once() and removeListener()#64373
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener

Conversation

@mcollina

Copy link
Copy Markdown
Member

Optimize the EventEmitter hot paths:

  • rewrite the once() wrapper as a closure instead of bind() + a state object
  • keep the _events object shape in removeListener(): store undefined instead of delete-ing keys or reallocating the object (eventNames() now filters, matching Stream.prototype.eventNames); removes the now-unused kShapeMode
  • outline the unhandled error path from emit() (439 → 278 bytecodes) and the max-listeners warning from _addListener() (405 → 288) so both fit within the V8 inlining budgets

benchmark/compare.js --runs 30 before/after all changes:

events
 confidence improvement accuracy (*) (**) (***)
events/ee-add-remove.js n=1000000 removeListener=0 newListener=0 *** 12.59 % ±1.59% ±2.11% ±2.76%
events/ee-add-remove.js n=1000000 removeListener=0 newListener=1 * 2.37 % ±1.92% ±2.58% ±3.40%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=0 *** 15.12 % ±1.14% ±1.52% ±1.99%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=1 *** 21.82 % ±2.24% ±3.01% ±3.97%
events/ee-emit.js listeners=1 argc=0 n=2000000 0.89 % ±3.72% ±4.95% ±6.47%
events/ee-emit.js listeners=1 argc=10 n=2000000 -0.85 % ±2.46% ±3.28% ±4.28%
events/ee-emit.js listeners=1 argc=2 n=2000000 1.25 % ±3.73% ±4.97% ±6.50%
events/ee-emit.js listeners=1 argc=4 n=2000000 -0.11 % ±2.91% ±3.87% ±5.04%
events/ee-emit.js listeners=10 argc=0 n=2000000 0.99 % ±1.95% ±2.60% ±3.38%
events/ee-emit.js listeners=10 argc=10 n=2000000 -0.24 % ±1.64% ±2.18% ±2.84%
events/ee-emit.js listeners=10 argc=2 n=2000000 0.05 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=10 argc=4 n=2000000 ** 2.22 % ±1.60% ±2.13% ±2.77%
events/ee-emit.js listeners=5 argc=0 n=2000000 1.82 % ±2.04% ±2.72% ±3.54%
events/ee-emit.js listeners=5 argc=10 n=2000000 -0.26 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=5 argc=2 n=2000000 * -2.25 % ±1.96% ±2.61% ±3.39%
events/ee-emit.js listeners=5 argc=4 n=2000000 0.64 % ±2.11% ±2.81% ±3.66%
events/ee-listen-unique.js n=1000000 events=1 *** 14.85 % ±0.80% ±1.06% ±1.39%
events/ee-listen-unique.js n=1000000 events=10 *** 8.46 % ±1.28% ±1.71% ±2.23%
events/ee-listen-unique.js n=1000000 events=2 *** 14.09 % ±0.88% ±1.18% ±1.54%
events/ee-listen-unique.js n=1000000 events=20 *** 7.53 % ±1.38% ±1.84% ±2.40%
events/ee-listen-unique.js n=1000000 events=3 *** 9.24 % ±1.83% ±2.44% ±3.20%
events/ee-listen-unique.js n=1000000 events=5 *** 13.22 % ±1.39% ±1.86% ±2.45%
events/ee-listener-count-on-prototype.js n=50000000 0.14 % ±0.82% ±1.09% ±1.41%
events/ee-listeners.js raw='false' listeners=5 n=5000000 *** -3.03 % ±1.73% ±2.31% ±3.03%
events/ee-listeners.js raw='false' listeners=50 n=5000000 -0.00 % ±0.54% ±0.72% ±0.94%
events/ee-listeners.js raw='true' listeners=5 n=5000000 *** 5.87 % ±2.69% ±3.59% ±4.68%
events/ee-listeners.js raw='true' listeners=50 n=5000000 -0.14 % ±1.05% ±1.40% ±1.83%
events/ee-once.js argc=0 n=20000000 *** 25.71 % ±1.08% ±1.43% ±1.87%
events/ee-once.js argc=1 n=20000000 *** 24.94 % ±0.77% ±1.02% ±1.33%
events/ee-once.js argc=4 n=20000000 *** 25.14 % ±0.92% ±1.23% ±1.61%
events/ee-once.js argc=5 n=20000000 *** 25.63 % ±0.90% ±1.21% ±1.58%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 31 comparisons, you can thus expect the following amount of false-positive results:
1.55 false positives, when considering a 5% risk acceptance (*, **, ***),
0.31 false positives, when considering a 1% risk acceptance (**, ***),
0.03 false positives, when considering a 0.1% risk acceptance (***)
streams
 confidence improvement accuracy (*) (**) (***)
streams/creation.js kind='duplex' n=50000000 *** 1.32 % ±0.61% ±0.81% ±1.05%
streams/creation.js kind='readable' n=50000000 -0.37 % ±0.61% ±0.81% ±1.06%
streams/creation.js kind='transform' n=50000000 * 3.83 % ±3.24% ±4.37% ±5.78%
streams/creation.js kind='writable' n=50000000 *** 2.83 % ±0.55% ±0.73% ±0.95%
streams/destroy.js kind='duplex' n=1000000 -0.08 % ±0.64% ±0.85% ±1.11%
streams/destroy.js kind='readable' n=1000000 *** 3.98 % ±1.82% ±2.42% ±3.16%
streams/destroy.js kind='transform' n=1000000 0.32 % ±0.54% ±0.72% ±0.94%
streams/destroy.js kind='writable' n=1000000 *** 2.57 % ±0.60% ±0.79% ±1.03%
streams/iter-creation.js n=100000 type='pair' api='classic' 1.49 % ±4.62% ±6.15% ±8.00%
streams/iter-creation.js n=100000 type='pair' api='iter' 0.02 % ±0.78% ±1.04% ±1.35%
streams/iter-creation.js n=100000 type='pair' api='webstream' -0.31 % ±1.61% ±2.14% ±2.78%
streams/iter-creation.js n=100000 type='readable' api='classic' -0.15 % ±5.01% ±6.67% ±8.69%
streams/iter-creation.js n=100000 type='readable' api='iter' 0.48 % ±2.18% ±2.90% ±3.77%
streams/iter-creation.js n=100000 type='readable' api='webstream' -0.29 % ±1.71% ±2.27% ±2.96%
streams/iter-creation.js n=100000 type='transform' api='classic' 1.97 % ±2.41% ±3.21% ±4.18%
streams/iter-creation.js n=100000 type='transform' api='webstream' 0.19 % ±0.86% ±1.14% ±1.49%
streams/iter-creation.js n=100000 type='writable' api='classic' 1.07 % ±2.10% ±2.80% ±3.64%
streams/iter-creation.js n=100000 type='writable' api='iter' 0.60 % ±1.89% ±2.51% ±3.27%
streams/iter-creation.js n=100000 type='writable' api='webstream' -0.18 % ±1.23% ±1.64% ±2.13%
streams/pipe.js n=5000000 *** 13.92 % ±1.41% ±1.88% ±2.45%
streams/readable-async-iterator.js sync='no' n=100000 * 2.45 % ±1.86% ±2.48% ±3.24%
streams/readable-async-iterator.js sync='yes' n=100000 -3.12 % ±3.85% ±5.15% ±6.76%
streams/readable-bigread.js n=1000 0.14 % ±2.98% ±3.96% ±5.16%
streams/readable-readall.js n=5000 -0.24 % ±2.49% ±3.32% ±4.33%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='no' n=100000 -0.87 % ±2.73% ±3.64% ±4.75%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='yes' n=100000 1.20 % ±4.18% ±5.57% ±7.29%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='no' n=100000 2.47 % ±5.23% ±6.98% ±9.13%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='yes' n=100000 -1.24 % ±7.14% ±9.50% ±12.36%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='no' n=100000 * 2.65 % ±2.43% ±3.23% ±4.22%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='yes' n=100000 ** 8.29 % ±5.26% ±7.00% ±9.11%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='no' n=100000 2.01 % ±4.22% ±5.62% ±7.31%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='yes' n=100000 * 5.16 % ±5.15% ±6.85% ±8.92%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='no' n=100000 2.67 % ±3.56% ±4.73% ±6.16%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='yes' n=100000 * 5.65 % ±4.82% ±6.42% ±8.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='no' n=100000 -0.76 % ±1.95% ±2.59% ±3.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='yes' n=100000 4.26 % ±8.13% ±10.81% ±14.07%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='no' n=100000 -1.57 % ±3.42% ±4.56% ±5.94%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='yes' n=100000 2.83 % ±4.44% ±5.91% ±7.69%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='no' n=100000 -0.87 % ±2.98% ±3.96% ±5.16%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='yes' n=100000 2.03 % ±5.96% ±7.93% ±10.32%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 40 comparisons, you can thus expect the following amount of false-positive results:
2.00 false positives, when considering a 5% risk acceptance (*, **, ***),
0.40 false positives, when considering a 1% risk acceptance (**, ***),
0.04 false positives, when considering a 0.1% risk acceptance (***)

Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
@nodejs-github-botnodejs-github-bot added events Issues and PRs related to EventEmitter and the events module. needs-ci PRs that need a full CI run. labels Jul 8, 2026
@codecov

codecovBot commented Jul 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.24%. Comparing base (1d87a24) to head (ce6c9ad).
⚠️ Report is 43 commits behind head on main.

Additional details and impacted files
@@ Coverage Diff @@## main #64373 +/- ##
==========================================
- Coverage 90.25% 90.24% -0.01% 
==========================================
Files 741 741 Lines 240990 241196 +206 Branches 45402 45431 +29 ==========================================
+ Hits 217502 217666 +164 - Misses 15066 15086 +20 - Partials 8422 8444 +22 
Files with missing linesCoverage Δ
lib/events.js99.59% <100.00%> (+<0.01%)⬆️

... and 48 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment threadlib/events.js
configurable: true,
});
} catch {
// Continue regardless of error.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you expand this to explain why we're ignoring the error?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this isn't new but it's always bugged me that's it's not explained :-)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the lines above we are trying to expand the stacktrace. If we can't for whatever reasons, we don't hide the original error.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasnell do you want me to update the comment?

@mcollinamcollina added the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@mcollinamcollina added commit-queue PRs queued for automated landing through the Commit Queue. author ready PRs with CI started, the required approvals, and no outstanding review comments. and removed needs-ci PRs that need a full CI run. labels Jul 13, 2026
@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Jul 13, 2026
@nodejs-github-bot
nodejs-github-bot merged commit 384d7a4 into nodejs:mainJul 13, 2026
84 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in 384d7a4

Comment threadlib/events.js
// the `events` object in the same shape and avoids both a `delete`
// (which would put the object into dictionary mode) and allocating
// a fresh object when the last listener is removed.
events[type] = undefined;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can cause memory leaks when using unstructured event names, I.e random ids etc...

@mcollina
mcollina deleted the events-optimize-once-removelistener branch July 13, 2026 16:02
mcollina added a commit to mcollina/node that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: nodejs#64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
nodejs-github-bot pushed a commit that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs with CI started, the required approvals, and no outstanding review comments.eventsIssues and PRs related to EventEmitter and the events module.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@mcollina@nodejs-github-bot@jasnell@anonrig@ronag
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Remove or un-stick sticky/fixed headers that block content\n(function() {\n function unstick() {\n document.querySelectorAll('header, nav, [role=\"banner\"], .header, .navbar, .sticky, .fixed-top, [style*=\"position: fixed\"], [style*=\"position:sticky\"]').forEach(function(el) {\n if (el.style.position === 'fixed' || el.style.position === 'sticky' || \n getComputedStyle(el).position === 'fixed' || getComputedStyle(el).position === 'sticky') {\n el.style.position = 'static';\n el.style.top = 'auto';\n el.style.zIndex = 'auto';\n }\n });\n }\n \n unstick();\n \n var observer = new MutationObserver(unstick);\n observer.observe(document.body, { childList: true, subtree: true, attributes: true, attributeFilter: ['style', 'class'] });\n})();", "Kill Sticky Headers"); } } catch(__e) { console.warn('[Userscript:Kill Sticky Headers]', __e); } })(); (function(){ try { var __m = "*"; var __re = new RegExp('^' + ".*" + '
Skip to content

events: optimize once() and removeListener() - #64373

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener
Jul 13, 2026
Merged

events: optimize once() and removeListener()#64373
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener

Conversation

@mcollina

Copy link
Copy Markdown
Member

Optimize the EventEmitter hot paths:

  • rewrite the once() wrapper as a closure instead of bind() + a state object
  • keep the _events object shape in removeListener(): store undefined instead of delete-ing keys or reallocating the object (eventNames() now filters, matching Stream.prototype.eventNames); removes the now-unused kShapeMode
  • outline the unhandled error path from emit() (439 → 278 bytecodes) and the max-listeners warning from _addListener() (405 → 288) so both fit within the V8 inlining budgets

benchmark/compare.js --runs 30 before/after all changes:

events
 confidence improvement accuracy (*) (**) (***)
events/ee-add-remove.js n=1000000 removeListener=0 newListener=0 *** 12.59 % ±1.59% ±2.11% ±2.76%
events/ee-add-remove.js n=1000000 removeListener=0 newListener=1 * 2.37 % ±1.92% ±2.58% ±3.40%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=0 *** 15.12 % ±1.14% ±1.52% ±1.99%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=1 *** 21.82 % ±2.24% ±3.01% ±3.97%
events/ee-emit.js listeners=1 argc=0 n=2000000 0.89 % ±3.72% ±4.95% ±6.47%
events/ee-emit.js listeners=1 argc=10 n=2000000 -0.85 % ±2.46% ±3.28% ±4.28%
events/ee-emit.js listeners=1 argc=2 n=2000000 1.25 % ±3.73% ±4.97% ±6.50%
events/ee-emit.js listeners=1 argc=4 n=2000000 -0.11 % ±2.91% ±3.87% ±5.04%
events/ee-emit.js listeners=10 argc=0 n=2000000 0.99 % ±1.95% ±2.60% ±3.38%
events/ee-emit.js listeners=10 argc=10 n=2000000 -0.24 % ±1.64% ±2.18% ±2.84%
events/ee-emit.js listeners=10 argc=2 n=2000000 0.05 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=10 argc=4 n=2000000 ** 2.22 % ±1.60% ±2.13% ±2.77%
events/ee-emit.js listeners=5 argc=0 n=2000000 1.82 % ±2.04% ±2.72% ±3.54%
events/ee-emit.js listeners=5 argc=10 n=2000000 -0.26 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=5 argc=2 n=2000000 * -2.25 % ±1.96% ±2.61% ±3.39%
events/ee-emit.js listeners=5 argc=4 n=2000000 0.64 % ±2.11% ±2.81% ±3.66%
events/ee-listen-unique.js n=1000000 events=1 *** 14.85 % ±0.80% ±1.06% ±1.39%
events/ee-listen-unique.js n=1000000 events=10 *** 8.46 % ±1.28% ±1.71% ±2.23%
events/ee-listen-unique.js n=1000000 events=2 *** 14.09 % ±0.88% ±1.18% ±1.54%
events/ee-listen-unique.js n=1000000 events=20 *** 7.53 % ±1.38% ±1.84% ±2.40%
events/ee-listen-unique.js n=1000000 events=3 *** 9.24 % ±1.83% ±2.44% ±3.20%
events/ee-listen-unique.js n=1000000 events=5 *** 13.22 % ±1.39% ±1.86% ±2.45%
events/ee-listener-count-on-prototype.js n=50000000 0.14 % ±0.82% ±1.09% ±1.41%
events/ee-listeners.js raw='false' listeners=5 n=5000000 *** -3.03 % ±1.73% ±2.31% ±3.03%
events/ee-listeners.js raw='false' listeners=50 n=5000000 -0.00 % ±0.54% ±0.72% ±0.94%
events/ee-listeners.js raw='true' listeners=5 n=5000000 *** 5.87 % ±2.69% ±3.59% ±4.68%
events/ee-listeners.js raw='true' listeners=50 n=5000000 -0.14 % ±1.05% ±1.40% ±1.83%
events/ee-once.js argc=0 n=20000000 *** 25.71 % ±1.08% ±1.43% ±1.87%
events/ee-once.js argc=1 n=20000000 *** 24.94 % ±0.77% ±1.02% ±1.33%
events/ee-once.js argc=4 n=20000000 *** 25.14 % ±0.92% ±1.23% ±1.61%
events/ee-once.js argc=5 n=20000000 *** 25.63 % ±0.90% ±1.21% ±1.58%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 31 comparisons, you can thus expect the following amount of false-positive results:
1.55 false positives, when considering a 5% risk acceptance (*, **, ***),
0.31 false positives, when considering a 1% risk acceptance (**, ***),
0.03 false positives, when considering a 0.1% risk acceptance (***)
streams
 confidence improvement accuracy (*) (**) (***)
streams/creation.js kind='duplex' n=50000000 *** 1.32 % ±0.61% ±0.81% ±1.05%
streams/creation.js kind='readable' n=50000000 -0.37 % ±0.61% ±0.81% ±1.06%
streams/creation.js kind='transform' n=50000000 * 3.83 % ±3.24% ±4.37% ±5.78%
streams/creation.js kind='writable' n=50000000 *** 2.83 % ±0.55% ±0.73% ±0.95%
streams/destroy.js kind='duplex' n=1000000 -0.08 % ±0.64% ±0.85% ±1.11%
streams/destroy.js kind='readable' n=1000000 *** 3.98 % ±1.82% ±2.42% ±3.16%
streams/destroy.js kind='transform' n=1000000 0.32 % ±0.54% ±0.72% ±0.94%
streams/destroy.js kind='writable' n=1000000 *** 2.57 % ±0.60% ±0.79% ±1.03%
streams/iter-creation.js n=100000 type='pair' api='classic' 1.49 % ±4.62% ±6.15% ±8.00%
streams/iter-creation.js n=100000 type='pair' api='iter' 0.02 % ±0.78% ±1.04% ±1.35%
streams/iter-creation.js n=100000 type='pair' api='webstream' -0.31 % ±1.61% ±2.14% ±2.78%
streams/iter-creation.js n=100000 type='readable' api='classic' -0.15 % ±5.01% ±6.67% ±8.69%
streams/iter-creation.js n=100000 type='readable' api='iter' 0.48 % ±2.18% ±2.90% ±3.77%
streams/iter-creation.js n=100000 type='readable' api='webstream' -0.29 % ±1.71% ±2.27% ±2.96%
streams/iter-creation.js n=100000 type='transform' api='classic' 1.97 % ±2.41% ±3.21% ±4.18%
streams/iter-creation.js n=100000 type='transform' api='webstream' 0.19 % ±0.86% ±1.14% ±1.49%
streams/iter-creation.js n=100000 type='writable' api='classic' 1.07 % ±2.10% ±2.80% ±3.64%
streams/iter-creation.js n=100000 type='writable' api='iter' 0.60 % ±1.89% ±2.51% ±3.27%
streams/iter-creation.js n=100000 type='writable' api='webstream' -0.18 % ±1.23% ±1.64% ±2.13%
streams/pipe.js n=5000000 *** 13.92 % ±1.41% ±1.88% ±2.45%
streams/readable-async-iterator.js sync='no' n=100000 * 2.45 % ±1.86% ±2.48% ±3.24%
streams/readable-async-iterator.js sync='yes' n=100000 -3.12 % ±3.85% ±5.15% ±6.76%
streams/readable-bigread.js n=1000 0.14 % ±2.98% ±3.96% ±5.16%
streams/readable-readall.js n=5000 -0.24 % ±2.49% ±3.32% ±4.33%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='no' n=100000 -0.87 % ±2.73% ±3.64% ±4.75%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='yes' n=100000 1.20 % ±4.18% ±5.57% ±7.29%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='no' n=100000 2.47 % ±5.23% ±6.98% ±9.13%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='yes' n=100000 -1.24 % ±7.14% ±9.50% ±12.36%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='no' n=100000 * 2.65 % ±2.43% ±3.23% ±4.22%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='yes' n=100000 ** 8.29 % ±5.26% ±7.00% ±9.11%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='no' n=100000 2.01 % ±4.22% ±5.62% ±7.31%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='yes' n=100000 * 5.16 % ±5.15% ±6.85% ±8.92%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='no' n=100000 2.67 % ±3.56% ±4.73% ±6.16%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='yes' n=100000 * 5.65 % ±4.82% ±6.42% ±8.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='no' n=100000 -0.76 % ±1.95% ±2.59% ±3.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='yes' n=100000 4.26 % ±8.13% ±10.81% ±14.07%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='no' n=100000 -1.57 % ±3.42% ±4.56% ±5.94%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='yes' n=100000 2.83 % ±4.44% ±5.91% ±7.69%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='no' n=100000 -0.87 % ±2.98% ±3.96% ±5.16%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='yes' n=100000 2.03 % ±5.96% ±7.93% ±10.32%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 40 comparisons, you can thus expect the following amount of false-positive results:
2.00 false positives, when considering a 5% risk acceptance (*, **, ***),
0.40 false positives, when considering a 1% risk acceptance (**, ***),
0.04 false positives, when considering a 0.1% risk acceptance (***)

Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
@nodejs-github-botnodejs-github-bot added events Issues and PRs related to EventEmitter and the events module. needs-ci PRs that need a full CI run. labels Jul 8, 2026
@codecov

codecovBot commented Jul 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.24%. Comparing base (1d87a24) to head (ce6c9ad).
⚠️ Report is 43 commits behind head on main.

Additional details and impacted files
@@ Coverage Diff @@## main #64373 +/- ##
==========================================
- Coverage 90.25% 90.24% -0.01% 
==========================================
Files 741 741 Lines 240990 241196 +206 Branches 45402 45431 +29 ==========================================
+ Hits 217502 217666 +164 - Misses 15066 15086 +20 - Partials 8422 8444 +22 
Files with missing linesCoverage Δ
lib/events.js99.59% <100.00%> (+<0.01%)⬆️

... and 48 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment threadlib/events.js
configurable: true,
});
} catch {
// Continue regardless of error.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you expand this to explain why we're ignoring the error?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this isn't new but it's always bugged me that's it's not explained :-)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the lines above we are trying to expand the stacktrace. If we can't for whatever reasons, we don't hide the original error.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasnell do you want me to update the comment?

@mcollinamcollina added the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@mcollinamcollina added commit-queue PRs queued for automated landing through the Commit Queue. author ready PRs with CI started, the required approvals, and no outstanding review comments. and removed needs-ci PRs that need a full CI run. labels Jul 13, 2026
@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Jul 13, 2026
@nodejs-github-bot
nodejs-github-bot merged commit 384d7a4 into nodejs:mainJul 13, 2026
84 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in 384d7a4

Comment threadlib/events.js
// the `events` object in the same shape and avoids both a `delete`
// (which would put the object into dictionary mode) and allocating
// a fresh object when the last listener is removed.
events[type] = undefined;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can cause memory leaks when using unstructured event names, I.e random ids etc...

@mcollina
mcollina deleted the events-optimize-once-removelistener branch July 13, 2026 16:02
mcollina added a commit to mcollina/node that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: nodejs#64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
nodejs-github-bot pushed a commit that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs with CI started, the required approvals, and no outstanding review comments.eventsIssues and PRs related to EventEmitter and the events module.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@mcollina@nodejs-github-bot@jasnell@anonrig@ronag
, 'i'); if (__m === '*' || __re.test(location.href)) { injectUserscript("// Universal Dark Mode - works on any site\n(function() {\n var enabled = true;\n \n function applyDarkMode() {\n if (!enabled) return;\n \n // Create style element if it doesn't exist\n var style = document.getElementById('universal-dark-mode-style');\n if (!style) {\n style = document.createElement('style');\n style.id = 'universal-dark-mode-style';\n document.head.appendChild(style);\n }\n \n // Dark mode CSS - inverts colors but preserves images/video\n style.textContent = '\n /* Invert everything except media */\n html {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #1a1a2e !important;\n }\n \n /* Restore images, videos, iframes, canvas */\n img, video, iframe, canvas, svg, picture, [style*=\"background-image\"] {\n filter: invert(1) hue-rotate(180deg) !important;\n }\n \n /* Preserve specific elements that should not be inverted */\n .no-dark-mode, .no-dark-mode *,\n [data-theme=\"light\"], [data-theme=\"light\"],\n .ace_editor, .ace_editor *,\n .CodeMirror, .CodeMirror *,\n .monaco-editor, .monaco-editor *,\n .markdown-body pre, .markdown-body pre *,\n .highlight, .highlight *,\n pre code, pre code * {\n filter: none !important;\n }\n \n /* Fix common UI elements */\n .modal, .popup, .dropdown-menu, .tooltip, .popover {\n filter: invert(1) hue-rotate(180deg) !important;\n background: #2d2d44 !important;\n border-color: #444 !important;\n }\n \n /* Scrollbars */\n ::-webkit-scrollbar { background: #1a1a2e !important; }\n ::-webkit-scrollbar-thumb { background: #444 !important; }\n ::-webkit-scrollbar-thumb:hover { background: #555 !important; }\n \n /* Selection */\n ::selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ::-moz-selection { background: #4ecdc4 !important; color: #1a1a2e !important; }\n ';\n }\n \n function removeDarkMode() {\n var style = document.getElementById('universal-dark-mode-style');\n if (style) style.remove();\n }\n \n // Toggle with Alt+Shift+D\n document.addEventListener('keydown', function(e) {\n if (e.altKey && e.shiftKey && e.key === 'D') {\n e.preventDefault();\n enabled = !enabled;\n if (enabled) {\n applyDarkMode();\n console.log('[Universal Dark Mode] Enabled');\n } else {\n removeDarkMode();\n console.log('[Universal Dark Mode] Disabled');\n }\n }\n });\n \n // Apply on load\n applyDarkMode();\n \n // Re-apply on dynamic content\n var observer = new MutationObserver(function(mutations) {\n if (enabled && !document.getElementById('universal-dark-mode-style')) {\n applyDarkMode();\n }\n });\n observer.observe(document.head, { childList: true });\n \n console.log('[Universal Dark Mode] Loaded - Press Alt+Shift+D to toggle');\n})();", "Universal Dark Mode"); } } catch(__e) { console.warn('[Userscript:Universal Dark Mode]', __e); } })(); })();
Skip to content

events: optimize once() and removeListener() - #64373

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener
Jul 13, 2026
Merged

events: optimize once() and removeListener()#64373
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
mcollina:events-optimize-once-removelistener

Conversation

@mcollina

Copy link
Copy Markdown
Member

Optimize the EventEmitter hot paths:

  • rewrite the once() wrapper as a closure instead of bind() + a state object
  • keep the _events object shape in removeListener(): store undefined instead of delete-ing keys or reallocating the object (eventNames() now filters, matching Stream.prototype.eventNames); removes the now-unused kShapeMode
  • outline the unhandled error path from emit() (439 → 278 bytecodes) and the max-listeners warning from _addListener() (405 → 288) so both fit within the V8 inlining budgets

benchmark/compare.js --runs 30 before/after all changes:

events
 confidence improvement accuracy (*) (**) (***)
events/ee-add-remove.js n=1000000 removeListener=0 newListener=0 *** 12.59 % ±1.59% ±2.11% ±2.76%
events/ee-add-remove.js n=1000000 removeListener=0 newListener=1 * 2.37 % ±1.92% ±2.58% ±3.40%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=0 *** 15.12 % ±1.14% ±1.52% ±1.99%
events/ee-add-remove.js n=1000000 removeListener=1 newListener=1 *** 21.82 % ±2.24% ±3.01% ±3.97%
events/ee-emit.js listeners=1 argc=0 n=2000000 0.89 % ±3.72% ±4.95% ±6.47%
events/ee-emit.js listeners=1 argc=10 n=2000000 -0.85 % ±2.46% ±3.28% ±4.28%
events/ee-emit.js listeners=1 argc=2 n=2000000 1.25 % ±3.73% ±4.97% ±6.50%
events/ee-emit.js listeners=1 argc=4 n=2000000 -0.11 % ±2.91% ±3.87% ±5.04%
events/ee-emit.js listeners=10 argc=0 n=2000000 0.99 % ±1.95% ±2.60% ±3.38%
events/ee-emit.js listeners=10 argc=10 n=2000000 -0.24 % ±1.64% ±2.18% ±2.84%
events/ee-emit.js listeners=10 argc=2 n=2000000 0.05 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=10 argc=4 n=2000000 ** 2.22 % ±1.60% ±2.13% ±2.77%
events/ee-emit.js listeners=5 argc=0 n=2000000 1.82 % ±2.04% ±2.72% ±3.54%
events/ee-emit.js listeners=5 argc=10 n=2000000 -0.26 % ±1.61% ±2.14% ±2.79%
events/ee-emit.js listeners=5 argc=2 n=2000000 * -2.25 % ±1.96% ±2.61% ±3.39%
events/ee-emit.js listeners=5 argc=4 n=2000000 0.64 % ±2.11% ±2.81% ±3.66%
events/ee-listen-unique.js n=1000000 events=1 *** 14.85 % ±0.80% ±1.06% ±1.39%
events/ee-listen-unique.js n=1000000 events=10 *** 8.46 % ±1.28% ±1.71% ±2.23%
events/ee-listen-unique.js n=1000000 events=2 *** 14.09 % ±0.88% ±1.18% ±1.54%
events/ee-listen-unique.js n=1000000 events=20 *** 7.53 % ±1.38% ±1.84% ±2.40%
events/ee-listen-unique.js n=1000000 events=3 *** 9.24 % ±1.83% ±2.44% ±3.20%
events/ee-listen-unique.js n=1000000 events=5 *** 13.22 % ±1.39% ±1.86% ±2.45%
events/ee-listener-count-on-prototype.js n=50000000 0.14 % ±0.82% ±1.09% ±1.41%
events/ee-listeners.js raw='false' listeners=5 n=5000000 *** -3.03 % ±1.73% ±2.31% ±3.03%
events/ee-listeners.js raw='false' listeners=50 n=5000000 -0.00 % ±0.54% ±0.72% ±0.94%
events/ee-listeners.js raw='true' listeners=5 n=5000000 *** 5.87 % ±2.69% ±3.59% ±4.68%
events/ee-listeners.js raw='true' listeners=50 n=5000000 -0.14 % ±1.05% ±1.40% ±1.83%
events/ee-once.js argc=0 n=20000000 *** 25.71 % ±1.08% ±1.43% ±1.87%
events/ee-once.js argc=1 n=20000000 *** 24.94 % ±0.77% ±1.02% ±1.33%
events/ee-once.js argc=4 n=20000000 *** 25.14 % ±0.92% ±1.23% ±1.61%
events/ee-once.js argc=5 n=20000000 *** 25.63 % ±0.90% ±1.21% ±1.58%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 31 comparisons, you can thus expect the following amount of false-positive results:
1.55 false positives, when considering a 5% risk acceptance (*, **, ***),
0.31 false positives, when considering a 1% risk acceptance (**, ***),
0.03 false positives, when considering a 0.1% risk acceptance (***)
streams
 confidence improvement accuracy (*) (**) (***)
streams/creation.js kind='duplex' n=50000000 *** 1.32 % ±0.61% ±0.81% ±1.05%
streams/creation.js kind='readable' n=50000000 -0.37 % ±0.61% ±0.81% ±1.06%
streams/creation.js kind='transform' n=50000000 * 3.83 % ±3.24% ±4.37% ±5.78%
streams/creation.js kind='writable' n=50000000 *** 2.83 % ±0.55% ±0.73% ±0.95%
streams/destroy.js kind='duplex' n=1000000 -0.08 % ±0.64% ±0.85% ±1.11%
streams/destroy.js kind='readable' n=1000000 *** 3.98 % ±1.82% ±2.42% ±3.16%
streams/destroy.js kind='transform' n=1000000 0.32 % ±0.54% ±0.72% ±0.94%
streams/destroy.js kind='writable' n=1000000 *** 2.57 % ±0.60% ±0.79% ±1.03%
streams/iter-creation.js n=100000 type='pair' api='classic' 1.49 % ±4.62% ±6.15% ±8.00%
streams/iter-creation.js n=100000 type='pair' api='iter' 0.02 % ±0.78% ±1.04% ±1.35%
streams/iter-creation.js n=100000 type='pair' api='webstream' -0.31 % ±1.61% ±2.14% ±2.78%
streams/iter-creation.js n=100000 type='readable' api='classic' -0.15 % ±5.01% ±6.67% ±8.69%
streams/iter-creation.js n=100000 type='readable' api='iter' 0.48 % ±2.18% ±2.90% ±3.77%
streams/iter-creation.js n=100000 type='readable' api='webstream' -0.29 % ±1.71% ±2.27% ±2.96%
streams/iter-creation.js n=100000 type='transform' api='classic' 1.97 % ±2.41% ±3.21% ±4.18%
streams/iter-creation.js n=100000 type='transform' api='webstream' 0.19 % ±0.86% ±1.14% ±1.49%
streams/iter-creation.js n=100000 type='writable' api='classic' 1.07 % ±2.10% ±2.80% ±3.64%
streams/iter-creation.js n=100000 type='writable' api='iter' 0.60 % ±1.89% ±2.51% ±3.27%
streams/iter-creation.js n=100000 type='writable' api='webstream' -0.18 % ±1.23% ±1.64% ±2.13%
streams/pipe.js n=5000000 *** 13.92 % ±1.41% ±1.88% ±2.45%
streams/readable-async-iterator.js sync='no' n=100000 * 2.45 % ±1.86% ±2.48% ±3.24%
streams/readable-async-iterator.js sync='yes' n=100000 -3.12 % ±3.85% ±5.15% ±6.76%
streams/readable-bigread.js n=1000 0.14 % ±2.98% ±3.96% ±5.16%
streams/readable-readall.js n=5000 -0.24 % ±2.49% ±3.32% ±4.33%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='no' n=100000 -0.87 % ±2.73% ±3.64% ±4.75%
streams/writable-manywrites.js len=1024 callback='no' writev='no' sync='yes' n=100000 1.20 % ±4.18% ±5.57% ±7.29%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='no' n=100000 2.47 % ±5.23% ±6.98% ±9.13%
streams/writable-manywrites.js len=1024 callback='no' writev='yes' sync='yes' n=100000 -1.24 % ±7.14% ±9.50% ±12.36%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='no' n=100000 * 2.65 % ±2.43% ±3.23% ±4.22%
streams/writable-manywrites.js len=1024 callback='yes' writev='no' sync='yes' n=100000 ** 8.29 % ±5.26% ±7.00% ±9.11%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='no' n=100000 2.01 % ±4.22% ±5.62% ±7.31%
streams/writable-manywrites.js len=1024 callback='yes' writev='yes' sync='yes' n=100000 * 5.16 % ±5.15% ±6.85% ±8.92%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='no' n=100000 2.67 % ±3.56% ±4.73% ±6.16%
streams/writable-manywrites.js len=32768 callback='no' writev='no' sync='yes' n=100000 * 5.65 % ±4.82% ±6.42% ±8.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='no' n=100000 -0.76 % ±1.95% ±2.59% ±3.37%
streams/writable-manywrites.js len=32768 callback='no' writev='yes' sync='yes' n=100000 4.26 % ±8.13% ±10.81% ±14.07%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='no' n=100000 -1.57 % ±3.42% ±4.56% ±5.94%
streams/writable-manywrites.js len=32768 callback='yes' writev='no' sync='yes' n=100000 2.83 % ±4.44% ±5.91% ±7.69%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='no' n=100000 -0.87 % ±2.98% ±3.96% ±5.16%
streams/writable-manywrites.js len=32768 callback='yes' writev='yes' sync='yes' n=100000 2.03 % ±5.96% ±7.93% ±10.32%
Be aware that when doing many comparisons the risk of a false-positive result increases.
In this case, there are 40 comparisons, you can thus expect the following amount of false-positive results:
2.00 false positives, when considering a 5% risk acceptance (*, **, ***),
0.40 false positives, when considering a 1% risk acceptance (**, ***),
0.04 false positives, when considering a 0.1% risk acceptance (***)

Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
@nodejs-github-botnodejs-github-bot added events Issues and PRs related to EventEmitter and the events module. needs-ci PRs that need a full CI run. labels Jul 8, 2026
@codecov

codecovBot commented Jul 8, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 90.24%. Comparing base (1d87a24) to head (ce6c9ad).
⚠️ Report is 43 commits behind head on main.

Additional details and impacted files
@@ Coverage Diff @@## main #64373 +/- ##
==========================================
- Coverage 90.25% 90.24% -0.01% 
==========================================
Files 741 741 Lines 240990 241196 +206 Branches 45402 45431 +29 ==========================================
+ Hits 217502 217666 +164 - Misses 15066 15086 +20 - Partials 8422 8444 +22 
Files with missing linesCoverage Δ
lib/events.js99.59% <100.00%> (+<0.01%)⬆️

... and 48 files with indirect coverage changes

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • 📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

Comment threadlib/events.js
configurable: true,
});
} catch {
// Continue regardless of error.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Can you expand this to explain why we're ignoring the error?

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I know this isn't new but it's always bugged me that's it's not explained :-)

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In the lines above we are trying to expand the stacktrace. If we can't for whatever reasons, we don't hide the original error.

Copy link
Copy Markdown
MemberAuthor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jasnell do you want me to update the comment?

@mcollinamcollina added the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Jul 9, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@mcollinamcollina added commit-queue PRs queued for automated landing through the Commit Queue. author ready PRs with CI started, the required approvals, and no outstanding review comments. and removed needs-ci PRs that need a full CI run. labels Jul 13, 2026
@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Jul 13, 2026
@nodejs-github-bot
nodejs-github-bot merged commit 384d7a4 into nodejs:mainJul 13, 2026
84 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in 384d7a4

Comment threadlib/events.js
// the `events` object in the same shape and avoids both a `delete`
// (which would put the object into dictionary mode) and allocating
// a fresh object when the last listener is removed.
events[type] = undefined;

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This can cause memory leaks when using unstructured event names, I.e random ids etc...

@mcollina
mcollina deleted the events-optimize-once-removelistener branch July 13, 2026 16:02
mcollina added a commit to mcollina/node that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: nodejs#64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
nodejs-github-bot pushed a commit that referenced this pull request Jul 13, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Jul 21, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
RafaelGSS pushed a commit that referenced this pull request Jul 29, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Use a closure instead of a bound state object for the once() wrapper,
keep the events object shape in removeListener() by storing undefined
instead of deleting keys or reallocating the object, and outline the
cold unhandled 'error' path from emit() and the max-listeners warning
from _addListener() so both fit within V8 inlining budgets.
ee-once +25%, ee-add-remove +12-22%, ee-listen-unique +7-15%,
streams/pipe +13.9%.
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64373
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Yagiz Nizipli <yagiz@nizipli.com>
aduh95 pushed a commit that referenced this pull request Aug 6, 2026
Restore shape mode for preallocated EventEmitters while deleting dynamic
names from ordinary EventEmitters. Keeping every removed name as an
undefined property causes unbounded memory growth when event names are
unstructured.
Refs: #64373
Signed-off-by: Matteo Collina <hello@matteocollina.com>
PR-URL: #64475
Reviewed-By: Robert Nagy <ronagy@icloud.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Sign up for freeto join this conversation on GitHub. Already have an account? Sign in to comment

Labels

author readyPRs with CI started, the required approvals, and no outstanding review comments.eventsIssues and PRs related to EventEmitter and the events module.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants

@mcollina@nodejs-github-bot@jasnell@anonrig@ronag