quic: remove unused fin flag from blob reader wakeup - #65315

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin
Aug 30, 2026
Merged

quic: remove unused fin flag from blob reader wakeup#65315
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin

Conversation

@trivenay

Copy link
Copy Markdown
Contributor

Fixes the dead code identified in #64767.

The blob reader used by QUIC inbound streams has two separate channels. The pull channel is where the iterator asks for data and gets a real answer: a chunk, "blocked, nothing available yet", or "end of stream". The wakeup channel exists only to wake a parked iterator after a blocked pull so it pulls again — it carries no data and answers no question.

The wakeup additionally carried a boolean label saying whether it was triggered by end-of-stream. That label is dead information: whatever it says, the woken iterator does the same single thing — loop back and pull. If the stream has ended, that next pull returns end-of-stream by itself, because the receive queue was already capped when the FIN was processed. The pull channel is the source of truth for "am I done?"; the label was a second announcement of something the very next pull confirms anyway, and the branch consuming it (if (fin) continue; as the final statement of the loop) behaves identically to not existing.

This removes the label end to end while keeping the wakeup itself: the JS iterator no longer reads a value from the wakeup promise, the C++ notifier no longer constructs or passes the boolean, and the end-of-stream path still fires a (now unlabeled) wakeup. All actual FIN processing — recording the final size, capping the receive queue, the stream state flags — is untouched.

One consequence deserves reviewer attention. The notifier coalesces wakeups: once it has woken the iterator, further wakeups are suppressed until the iterator actually pulls. Previously, end-of-stream wakeups bypassed that suppression "just in case". With the label gone the bypass goes too, so end-of-stream wakeups now coalesce like any other. This cannot stall the iterator: the iterator only parks after a pull returned "blocked", every pull resets the suppression flag on entry, and only synchronous JavaScript runs between that pull and the park — so a parked iterator always has suppression clear, and the first wakeup after parking always gets through. The bypass only ever fired while the iterator was already awake and about to pull, where an extra wakeup changes nothing.

Changes:

  • lib/internal/blob.js — stop reading a value from the wakeup; delete the dead branch and its comment.
  • src/node_blob.cc, src/node_blob.hNotifyPull() loses its boolean parameter and JS-facing argument.
  • src/quic/streams.cc — the end-of-stream call site drops the argument.

No behavior change; no new test. Existing test/parallel/test-quic-* and test/parallel/test-blob* pass on the compiled binary.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/quic

@nodejs-github-botnodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs involving general changes in the lib/ or src/ directories. needs-ci PRs that need a full CI run. labels Aug 15, 2026
@jasnell

Copy link
Copy Markdown
Member

@trivenay ... this will need a rebase

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

Rebased on main — thanks for the heads-up!

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9a01ab0 to 9cbb5e4CompareAugust 16, 2026 09:46
@codecov

codecovBot commented Aug 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 0% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.06%. Comparing base (c5eb9de) to head (2ebf33d).
⚠️ Report is 3 commits behind head on main.

Files with missing linesPatch %Lines
src/node_blob.cc0.00%3 Missing ⚠️
lib/internal/blob.js0.00%1 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #65315 +/- ##
==========================================
- Coverage 91.71% 90.06% -1.66% 
==========================================
Files 402 754 +352 Lines 181151 255731 +74580 Branches 27805 48323 +20518 ==========================================
+ Hits 166147 230317 +64170 - Misses 14664 16546 +1882 - Partials 340 8868 +8528 
Files with missing linesCoverage Δ
src/node_blob.h37.50% <ø> (ø)
lib/internal/blob.js88.40% <0.00%> (+6.77%)⬆️
src/node_blob.cc73.49% <0.00%> (ø)

... and 482 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.

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

The x86_64-darwin: with shared libraries failure is the test-common-wpt-backends — known flaky test, unrelated to this change. Thankfully there is already a fix in flight for it in #65320.

@jasnell

Copy link
Copy Markdown
Member

Just a note, this will have a few conflicts with #65309 but nothing major.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Sure — happy to rebase once #65309 lands.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Rebased on top of #65309 now that it has landed (05a8e91). No conflicts; the fin removal re-applies cleanly on the reworked wakeup path.

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9cbb5e4 to ebbaec7CompareAugust 28, 2026 15:35

@pimterrypimterry left a comment

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.

LGTM

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

This comment was marked as outdated.

@nodejs-github-bot

This comment was marked as outdated.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@jasnell

Copy link
Copy Markdown
Member

The PR likely needs to be rebased in order for CI to pass.

The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: nodejs#64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from ebbaec7 to 2ebf33dCompareAugust 29, 2026 18:47
@trivikrtrivikr added request-ci Add this label to start a Jenkins CI on a PR. author ready PRs with CI started, the required approvals, and no outstanding review comments. labels Aug 29, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 29, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@trivikrtrivikr added the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
@nodejs-github-bot
nodejs-github-bot merged commit f63bffd into nodejs:mainAug 30, 2026
77 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in f63bffd

@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
aduh95 pushed a commit that referenced this pull request Sep 3, 2026
The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: #64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
PR-URL: #65315
Reviewed-By: Tim Perry <pimterry@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@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.c++Issues and PRs that require attention from people who are familiar with C++.lib / srcIssues and PRs involving general changes in the lib/ or src/ directories.needs-ciPRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@trivenay@nodejs-github-bot@jasnell@pimterry@trivikr@bjohansebas
, '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

quic: remove unused fin flag from blob reader wakeup - #65315

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin
Aug 30, 2026
Merged

quic: remove unused fin flag from blob reader wakeup#65315
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin

Conversation

@trivenay

Copy link
Copy Markdown
Contributor

Fixes the dead code identified in #64767.

The blob reader used by QUIC inbound streams has two separate channels. The pull channel is where the iterator asks for data and gets a real answer: a chunk, "blocked, nothing available yet", or "end of stream". The wakeup channel exists only to wake a parked iterator after a blocked pull so it pulls again — it carries no data and answers no question.

The wakeup additionally carried a boolean label saying whether it was triggered by end-of-stream. That label is dead information: whatever it says, the woken iterator does the same single thing — loop back and pull. If the stream has ended, that next pull returns end-of-stream by itself, because the receive queue was already capped when the FIN was processed. The pull channel is the source of truth for "am I done?"; the label was a second announcement of something the very next pull confirms anyway, and the branch consuming it (if (fin) continue; as the final statement of the loop) behaves identically to not existing.

This removes the label end to end while keeping the wakeup itself: the JS iterator no longer reads a value from the wakeup promise, the C++ notifier no longer constructs or passes the boolean, and the end-of-stream path still fires a (now unlabeled) wakeup. All actual FIN processing — recording the final size, capping the receive queue, the stream state flags — is untouched.

One consequence deserves reviewer attention. The notifier coalesces wakeups: once it has woken the iterator, further wakeups are suppressed until the iterator actually pulls. Previously, end-of-stream wakeups bypassed that suppression "just in case". With the label gone the bypass goes too, so end-of-stream wakeups now coalesce like any other. This cannot stall the iterator: the iterator only parks after a pull returned "blocked", every pull resets the suppression flag on entry, and only synchronous JavaScript runs between that pull and the park — so a parked iterator always has suppression clear, and the first wakeup after parking always gets through. The bypass only ever fired while the iterator was already awake and about to pull, where an extra wakeup changes nothing.

Changes:

  • lib/internal/blob.js — stop reading a value from the wakeup; delete the dead branch and its comment.
  • src/node_blob.cc, src/node_blob.hNotifyPull() loses its boolean parameter and JS-facing argument.
  • src/quic/streams.cc — the end-of-stream call site drops the argument.

No behavior change; no new test. Existing test/parallel/test-quic-* and test/parallel/test-blob* pass on the compiled binary.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/quic

@nodejs-github-botnodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs involving general changes in the lib/ or src/ directories. needs-ci PRs that need a full CI run. labels Aug 15, 2026
@jasnell

Copy link
Copy Markdown
Member

@trivenay ... this will need a rebase

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

Rebased on main — thanks for the heads-up!

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9a01ab0 to 9cbb5e4CompareAugust 16, 2026 09:46
@codecov

codecovBot commented Aug 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 0% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.06%. Comparing base (c5eb9de) to head (2ebf33d).
⚠️ Report is 3 commits behind head on main.

Files with missing linesPatch %Lines
src/node_blob.cc0.00%3 Missing ⚠️
lib/internal/blob.js0.00%1 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #65315 +/- ##
==========================================
- Coverage 91.71% 90.06% -1.66% 
==========================================
Files 402 754 +352 Lines 181151 255731 +74580 Branches 27805 48323 +20518 ==========================================
+ Hits 166147 230317 +64170 - Misses 14664 16546 +1882 - Partials 340 8868 +8528 
Files with missing linesCoverage Δ
src/node_blob.h37.50% <ø> (ø)
lib/internal/blob.js88.40% <0.00%> (+6.77%)⬆️
src/node_blob.cc73.49% <0.00%> (ø)

... and 482 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.

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

The x86_64-darwin: with shared libraries failure is the test-common-wpt-backends — known flaky test, unrelated to this change. Thankfully there is already a fix in flight for it in #65320.

@jasnell

Copy link
Copy Markdown
Member

Just a note, this will have a few conflicts with #65309 but nothing major.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Sure — happy to rebase once #65309 lands.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Rebased on top of #65309 now that it has landed (05a8e91). No conflicts; the fin removal re-applies cleanly on the reworked wakeup path.

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9cbb5e4 to ebbaec7CompareAugust 28, 2026 15:35

@pimterrypimterry left a comment

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.

LGTM

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

This comment was marked as outdated.

@nodejs-github-bot

This comment was marked as outdated.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@jasnell

Copy link
Copy Markdown
Member

The PR likely needs to be rebased in order for CI to pass.

The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: nodejs#64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from ebbaec7 to 2ebf33dCompareAugust 29, 2026 18:47
@trivikrtrivikr added request-ci Add this label to start a Jenkins CI on a PR. author ready PRs with CI started, the required approvals, and no outstanding review comments. labels Aug 29, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 29, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@trivikrtrivikr added the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
@nodejs-github-bot
nodejs-github-bot merged commit f63bffd into nodejs:mainAug 30, 2026
77 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in f63bffd

@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
aduh95 pushed a commit that referenced this pull request Sep 3, 2026
The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: #64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
PR-URL: #65315
Reviewed-By: Tim Perry <pimterry@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@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.c++Issues and PRs that require attention from people who are familiar with C++.lib / srcIssues and PRs involving general changes in the lib/ or src/ directories.needs-ciPRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@trivenay@nodejs-github-bot@jasnell@pimterry@trivikr@bjohansebas
, '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

quic: remove unused fin flag from blob reader wakeup - #65315

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin
Aug 30, 2026
Merged

quic: remove unused fin flag from blob reader wakeup#65315
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin

Conversation

@trivenay

Copy link
Copy Markdown
Contributor

Fixes the dead code identified in #64767.

The blob reader used by QUIC inbound streams has two separate channels. The pull channel is where the iterator asks for data and gets a real answer: a chunk, "blocked, nothing available yet", or "end of stream". The wakeup channel exists only to wake a parked iterator after a blocked pull so it pulls again — it carries no data and answers no question.

The wakeup additionally carried a boolean label saying whether it was triggered by end-of-stream. That label is dead information: whatever it says, the woken iterator does the same single thing — loop back and pull. If the stream has ended, that next pull returns end-of-stream by itself, because the receive queue was already capped when the FIN was processed. The pull channel is the source of truth for "am I done?"; the label was a second announcement of something the very next pull confirms anyway, and the branch consuming it (if (fin) continue; as the final statement of the loop) behaves identically to not existing.

This removes the label end to end while keeping the wakeup itself: the JS iterator no longer reads a value from the wakeup promise, the C++ notifier no longer constructs or passes the boolean, and the end-of-stream path still fires a (now unlabeled) wakeup. All actual FIN processing — recording the final size, capping the receive queue, the stream state flags — is untouched.

One consequence deserves reviewer attention. The notifier coalesces wakeups: once it has woken the iterator, further wakeups are suppressed until the iterator actually pulls. Previously, end-of-stream wakeups bypassed that suppression "just in case". With the label gone the bypass goes too, so end-of-stream wakeups now coalesce like any other. This cannot stall the iterator: the iterator only parks after a pull returned "blocked", every pull resets the suppression flag on entry, and only synchronous JavaScript runs between that pull and the park — so a parked iterator always has suppression clear, and the first wakeup after parking always gets through. The bypass only ever fired while the iterator was already awake and about to pull, where an extra wakeup changes nothing.

Changes:

  • lib/internal/blob.js — stop reading a value from the wakeup; delete the dead branch and its comment.
  • src/node_blob.cc, src/node_blob.hNotifyPull() loses its boolean parameter and JS-facing argument.
  • src/quic/streams.cc — the end-of-stream call site drops the argument.

No behavior change; no new test. Existing test/parallel/test-quic-* and test/parallel/test-blob* pass on the compiled binary.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/quic

@nodejs-github-botnodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs involving general changes in the lib/ or src/ directories. needs-ci PRs that need a full CI run. labels Aug 15, 2026
@jasnell

Copy link
Copy Markdown
Member

@trivenay ... this will need a rebase

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

Rebased on main — thanks for the heads-up!

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9a01ab0 to 9cbb5e4CompareAugust 16, 2026 09:46
@codecov

codecovBot commented Aug 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 0% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.06%. Comparing base (c5eb9de) to head (2ebf33d).
⚠️ Report is 3 commits behind head on main.

Files with missing linesPatch %Lines
src/node_blob.cc0.00%3 Missing ⚠️
lib/internal/blob.js0.00%1 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #65315 +/- ##
==========================================
- Coverage 91.71% 90.06% -1.66% 
==========================================
Files 402 754 +352 Lines 181151 255731 +74580 Branches 27805 48323 +20518 ==========================================
+ Hits 166147 230317 +64170 - Misses 14664 16546 +1882 - Partials 340 8868 +8528 
Files with missing linesCoverage Δ
src/node_blob.h37.50% <ø> (ø)
lib/internal/blob.js88.40% <0.00%> (+6.77%)⬆️
src/node_blob.cc73.49% <0.00%> (ø)

... and 482 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.

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

The x86_64-darwin: with shared libraries failure is the test-common-wpt-backends — known flaky test, unrelated to this change. Thankfully there is already a fix in flight for it in #65320.

@jasnell

Copy link
Copy Markdown
Member

Just a note, this will have a few conflicts with #65309 but nothing major.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Sure — happy to rebase once #65309 lands.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Rebased on top of #65309 now that it has landed (05a8e91). No conflicts; the fin removal re-applies cleanly on the reworked wakeup path.

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9cbb5e4 to ebbaec7CompareAugust 28, 2026 15:35

@pimterrypimterry left a comment

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.

LGTM

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

This comment was marked as outdated.

@nodejs-github-bot

This comment was marked as outdated.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@jasnell

Copy link
Copy Markdown
Member

The PR likely needs to be rebased in order for CI to pass.

The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: nodejs#64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from ebbaec7 to 2ebf33dCompareAugust 29, 2026 18:47
@trivikrtrivikr added request-ci Add this label to start a Jenkins CI on a PR. author ready PRs with CI started, the required approvals, and no outstanding review comments. labels Aug 29, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 29, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@trivikrtrivikr added the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
@nodejs-github-bot
nodejs-github-bot merged commit f63bffd into nodejs:mainAug 30, 2026
77 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in f63bffd

@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
aduh95 pushed a commit that referenced this pull request Sep 3, 2026
The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: #64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
PR-URL: #65315
Reviewed-By: Tim Perry <pimterry@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@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.c++Issues and PRs that require attention from people who are familiar with C++.lib / srcIssues and PRs involving general changes in the lib/ or src/ directories.needs-ciPRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@trivenay@nodejs-github-bot@jasnell@pimterry@trivikr@bjohansebas
, '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

quic: remove unused fin flag from blob reader wakeup - #65315

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin
Aug 30, 2026
Merged

quic: remove unused fin flag from blob reader wakeup#65315
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin

Conversation

@trivenay

Copy link
Copy Markdown
Contributor

Fixes the dead code identified in #64767.

The blob reader used by QUIC inbound streams has two separate channels. The pull channel is where the iterator asks for data and gets a real answer: a chunk, "blocked, nothing available yet", or "end of stream". The wakeup channel exists only to wake a parked iterator after a blocked pull so it pulls again — it carries no data and answers no question.

The wakeup additionally carried a boolean label saying whether it was triggered by end-of-stream. That label is dead information: whatever it says, the woken iterator does the same single thing — loop back and pull. If the stream has ended, that next pull returns end-of-stream by itself, because the receive queue was already capped when the FIN was processed. The pull channel is the source of truth for "am I done?"; the label was a second announcement of something the very next pull confirms anyway, and the branch consuming it (if (fin) continue; as the final statement of the loop) behaves identically to not existing.

This removes the label end to end while keeping the wakeup itself: the JS iterator no longer reads a value from the wakeup promise, the C++ notifier no longer constructs or passes the boolean, and the end-of-stream path still fires a (now unlabeled) wakeup. All actual FIN processing — recording the final size, capping the receive queue, the stream state flags — is untouched.

One consequence deserves reviewer attention. The notifier coalesces wakeups: once it has woken the iterator, further wakeups are suppressed until the iterator actually pulls. Previously, end-of-stream wakeups bypassed that suppression "just in case". With the label gone the bypass goes too, so end-of-stream wakeups now coalesce like any other. This cannot stall the iterator: the iterator only parks after a pull returned "blocked", every pull resets the suppression flag on entry, and only synchronous JavaScript runs between that pull and the park — so a parked iterator always has suppression clear, and the first wakeup after parking always gets through. The bypass only ever fired while the iterator was already awake and about to pull, where an extra wakeup changes nothing.

Changes:

  • lib/internal/blob.js — stop reading a value from the wakeup; delete the dead branch and its comment.
  • src/node_blob.cc, src/node_blob.hNotifyPull() loses its boolean parameter and JS-facing argument.
  • src/quic/streams.cc — the end-of-stream call site drops the argument.

No behavior change; no new test. Existing test/parallel/test-quic-* and test/parallel/test-blob* pass on the compiled binary.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/quic

@nodejs-github-botnodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs involving general changes in the lib/ or src/ directories. needs-ci PRs that need a full CI run. labels Aug 15, 2026
@jasnell

Copy link
Copy Markdown
Member

@trivenay ... this will need a rebase

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

Rebased on main — thanks for the heads-up!

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9a01ab0 to 9cbb5e4CompareAugust 16, 2026 09:46
@codecov

codecovBot commented Aug 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 0% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.06%. Comparing base (c5eb9de) to head (2ebf33d).
⚠️ Report is 3 commits behind head on main.

Files with missing linesPatch %Lines
src/node_blob.cc0.00%3 Missing ⚠️
lib/internal/blob.js0.00%1 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #65315 +/- ##
==========================================
- Coverage 91.71% 90.06% -1.66% 
==========================================
Files 402 754 +352 Lines 181151 255731 +74580 Branches 27805 48323 +20518 ==========================================
+ Hits 166147 230317 +64170 - Misses 14664 16546 +1882 - Partials 340 8868 +8528 
Files with missing linesCoverage Δ
src/node_blob.h37.50% <ø> (ø)
lib/internal/blob.js88.40% <0.00%> (+6.77%)⬆️
src/node_blob.cc73.49% <0.00%> (ø)

... and 482 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.

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

The x86_64-darwin: with shared libraries failure is the test-common-wpt-backends — known flaky test, unrelated to this change. Thankfully there is already a fix in flight for it in #65320.

@jasnell

Copy link
Copy Markdown
Member

Just a note, this will have a few conflicts with #65309 but nothing major.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Sure — happy to rebase once #65309 lands.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Rebased on top of #65309 now that it has landed (05a8e91). No conflicts; the fin removal re-applies cleanly on the reworked wakeup path.

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9cbb5e4 to ebbaec7CompareAugust 28, 2026 15:35

@pimterrypimterry left a comment

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.

LGTM

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

This comment was marked as outdated.

@nodejs-github-bot

This comment was marked as outdated.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@jasnell

Copy link
Copy Markdown
Member

The PR likely needs to be rebased in order for CI to pass.

The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: nodejs#64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from ebbaec7 to 2ebf33dCompareAugust 29, 2026 18:47
@trivikrtrivikr added request-ci Add this label to start a Jenkins CI on a PR. author ready PRs with CI started, the required approvals, and no outstanding review comments. labels Aug 29, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 29, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@trivikrtrivikr added the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
@nodejs-github-bot
nodejs-github-bot merged commit f63bffd into nodejs:mainAug 30, 2026
77 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in f63bffd

@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
aduh95 pushed a commit that referenced this pull request Sep 3, 2026
The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: #64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
PR-URL: #65315
Reviewed-By: Tim Perry <pimterry@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@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.c++Issues and PRs that require attention from people who are familiar with C++.lib / srcIssues and PRs involving general changes in the lib/ or src/ directories.needs-ciPRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@trivenay@nodejs-github-bot@jasnell@pimterry@trivikr@bjohansebas
, '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

quic: remove unused fin flag from blob reader wakeup - #65315

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin
Aug 30, 2026
Merged

quic: remove unused fin flag from blob reader wakeup#65315
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin

Conversation

@trivenay

Copy link
Copy Markdown
Contributor

Fixes the dead code identified in #64767.

The blob reader used by QUIC inbound streams has two separate channels. The pull channel is where the iterator asks for data and gets a real answer: a chunk, "blocked, nothing available yet", or "end of stream". The wakeup channel exists only to wake a parked iterator after a blocked pull so it pulls again — it carries no data and answers no question.

The wakeup additionally carried a boolean label saying whether it was triggered by end-of-stream. That label is dead information: whatever it says, the woken iterator does the same single thing — loop back and pull. If the stream has ended, that next pull returns end-of-stream by itself, because the receive queue was already capped when the FIN was processed. The pull channel is the source of truth for "am I done?"; the label was a second announcement of something the very next pull confirms anyway, and the branch consuming it (if (fin) continue; as the final statement of the loop) behaves identically to not existing.

This removes the label end to end while keeping the wakeup itself: the JS iterator no longer reads a value from the wakeup promise, the C++ notifier no longer constructs or passes the boolean, and the end-of-stream path still fires a (now unlabeled) wakeup. All actual FIN processing — recording the final size, capping the receive queue, the stream state flags — is untouched.

One consequence deserves reviewer attention. The notifier coalesces wakeups: once it has woken the iterator, further wakeups are suppressed until the iterator actually pulls. Previously, end-of-stream wakeups bypassed that suppression "just in case". With the label gone the bypass goes too, so end-of-stream wakeups now coalesce like any other. This cannot stall the iterator: the iterator only parks after a pull returned "blocked", every pull resets the suppression flag on entry, and only synchronous JavaScript runs between that pull and the park — so a parked iterator always has suppression clear, and the first wakeup after parking always gets through. The bypass only ever fired while the iterator was already awake and about to pull, where an extra wakeup changes nothing.

Changes:

  • lib/internal/blob.js — stop reading a value from the wakeup; delete the dead branch and its comment.
  • src/node_blob.cc, src/node_blob.hNotifyPull() loses its boolean parameter and JS-facing argument.
  • src/quic/streams.cc — the end-of-stream call site drops the argument.

No behavior change; no new test. Existing test/parallel/test-quic-* and test/parallel/test-blob* pass on the compiled binary.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/quic

@nodejs-github-botnodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs involving general changes in the lib/ or src/ directories. needs-ci PRs that need a full CI run. labels Aug 15, 2026
@jasnell

Copy link
Copy Markdown
Member

@trivenay ... this will need a rebase

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

Rebased on main — thanks for the heads-up!

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9a01ab0 to 9cbb5e4CompareAugust 16, 2026 09:46
@codecov

codecovBot commented Aug 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 0% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.06%. Comparing base (c5eb9de) to head (2ebf33d).
⚠️ Report is 3 commits behind head on main.

Files with missing linesPatch %Lines
src/node_blob.cc0.00%3 Missing ⚠️
lib/internal/blob.js0.00%1 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #65315 +/- ##
==========================================
- Coverage 91.71% 90.06% -1.66% 
==========================================
Files 402 754 +352 Lines 181151 255731 +74580 Branches 27805 48323 +20518 ==========================================
+ Hits 166147 230317 +64170 - Misses 14664 16546 +1882 - Partials 340 8868 +8528 
Files with missing linesCoverage Δ
src/node_blob.h37.50% <ø> (ø)
lib/internal/blob.js88.40% <0.00%> (+6.77%)⬆️
src/node_blob.cc73.49% <0.00%> (ø)

... and 482 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.

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

The x86_64-darwin: with shared libraries failure is the test-common-wpt-backends — known flaky test, unrelated to this change. Thankfully there is already a fix in flight for it in #65320.

@jasnell

Copy link
Copy Markdown
Member

Just a note, this will have a few conflicts with #65309 but nothing major.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Sure — happy to rebase once #65309 lands.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Rebased on top of #65309 now that it has landed (05a8e91). No conflicts; the fin removal re-applies cleanly on the reworked wakeup path.

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9cbb5e4 to ebbaec7CompareAugust 28, 2026 15:35

@pimterrypimterry left a comment

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.

LGTM

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

This comment was marked as outdated.

@nodejs-github-bot

This comment was marked as outdated.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@jasnell

Copy link
Copy Markdown
Member

The PR likely needs to be rebased in order for CI to pass.

The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: nodejs#64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from ebbaec7 to 2ebf33dCompareAugust 29, 2026 18:47
@trivikrtrivikr added request-ci Add this label to start a Jenkins CI on a PR. author ready PRs with CI started, the required approvals, and no outstanding review comments. labels Aug 29, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 29, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@trivikrtrivikr added the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
@nodejs-github-bot
nodejs-github-bot merged commit f63bffd into nodejs:mainAug 30, 2026
77 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in f63bffd

@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
aduh95 pushed a commit that referenced this pull request Sep 3, 2026
The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: #64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
PR-URL: #65315
Reviewed-By: Tim Perry <pimterry@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@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.c++Issues and PRs that require attention from people who are familiar with C++.lib / srcIssues and PRs involving general changes in the lib/ or src/ directories.needs-ciPRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@trivenay@nodejs-github-bot@jasnell@pimterry@trivikr@bjohansebas
, '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

quic: remove unused fin flag from blob reader wakeup - #65315

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin
Aug 30, 2026
Merged

quic: remove unused fin flag from blob reader wakeup#65315
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin

Conversation

@trivenay

Copy link
Copy Markdown
Contributor

Fixes the dead code identified in #64767.

The blob reader used by QUIC inbound streams has two separate channels. The pull channel is where the iterator asks for data and gets a real answer: a chunk, "blocked, nothing available yet", or "end of stream". The wakeup channel exists only to wake a parked iterator after a blocked pull so it pulls again — it carries no data and answers no question.

The wakeup additionally carried a boolean label saying whether it was triggered by end-of-stream. That label is dead information: whatever it says, the woken iterator does the same single thing — loop back and pull. If the stream has ended, that next pull returns end-of-stream by itself, because the receive queue was already capped when the FIN was processed. The pull channel is the source of truth for "am I done?"; the label was a second announcement of something the very next pull confirms anyway, and the branch consuming it (if (fin) continue; as the final statement of the loop) behaves identically to not existing.

This removes the label end to end while keeping the wakeup itself: the JS iterator no longer reads a value from the wakeup promise, the C++ notifier no longer constructs or passes the boolean, and the end-of-stream path still fires a (now unlabeled) wakeup. All actual FIN processing — recording the final size, capping the receive queue, the stream state flags — is untouched.

One consequence deserves reviewer attention. The notifier coalesces wakeups: once it has woken the iterator, further wakeups are suppressed until the iterator actually pulls. Previously, end-of-stream wakeups bypassed that suppression "just in case". With the label gone the bypass goes too, so end-of-stream wakeups now coalesce like any other. This cannot stall the iterator: the iterator only parks after a pull returned "blocked", every pull resets the suppression flag on entry, and only synchronous JavaScript runs between that pull and the park — so a parked iterator always has suppression clear, and the first wakeup after parking always gets through. The bypass only ever fired while the iterator was already awake and about to pull, where an extra wakeup changes nothing.

Changes:

  • lib/internal/blob.js — stop reading a value from the wakeup; delete the dead branch and its comment.
  • src/node_blob.cc, src/node_blob.hNotifyPull() loses its boolean parameter and JS-facing argument.
  • src/quic/streams.cc — the end-of-stream call site drops the argument.

No behavior change; no new test. Existing test/parallel/test-quic-* and test/parallel/test-blob* pass on the compiled binary.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/quic

@nodejs-github-botnodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs involving general changes in the lib/ or src/ directories. needs-ci PRs that need a full CI run. labels Aug 15, 2026
@jasnell

Copy link
Copy Markdown
Member

@trivenay ... this will need a rebase

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

Rebased on main — thanks for the heads-up!

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9a01ab0 to 9cbb5e4CompareAugust 16, 2026 09:46
@codecov

codecovBot commented Aug 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 0% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.06%. Comparing base (c5eb9de) to head (2ebf33d).
⚠️ Report is 3 commits behind head on main.

Files with missing linesPatch %Lines
src/node_blob.cc0.00%3 Missing ⚠️
lib/internal/blob.js0.00%1 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #65315 +/- ##
==========================================
- Coverage 91.71% 90.06% -1.66% 
==========================================
Files 402 754 +352 Lines 181151 255731 +74580 Branches 27805 48323 +20518 ==========================================
+ Hits 166147 230317 +64170 - Misses 14664 16546 +1882 - Partials 340 8868 +8528 
Files with missing linesCoverage Δ
src/node_blob.h37.50% <ø> (ø)
lib/internal/blob.js88.40% <0.00%> (+6.77%)⬆️
src/node_blob.cc73.49% <0.00%> (ø)

... and 482 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.

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

The x86_64-darwin: with shared libraries failure is the test-common-wpt-backends — known flaky test, unrelated to this change. Thankfully there is already a fix in flight for it in #65320.

@jasnell

Copy link
Copy Markdown
Member

Just a note, this will have a few conflicts with #65309 but nothing major.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Sure — happy to rebase once #65309 lands.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Rebased on top of #65309 now that it has landed (05a8e91). No conflicts; the fin removal re-applies cleanly on the reworked wakeup path.

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9cbb5e4 to ebbaec7CompareAugust 28, 2026 15:35

@pimterrypimterry left a comment

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.

LGTM

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

This comment was marked as outdated.

@nodejs-github-bot

This comment was marked as outdated.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@jasnell

Copy link
Copy Markdown
Member

The PR likely needs to be rebased in order for CI to pass.

The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: nodejs#64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from ebbaec7 to 2ebf33dCompareAugust 29, 2026 18:47
@trivikrtrivikr added request-ci Add this label to start a Jenkins CI on a PR. author ready PRs with CI started, the required approvals, and no outstanding review comments. labels Aug 29, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 29, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@trivikrtrivikr added the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
@nodejs-github-bot
nodejs-github-bot merged commit f63bffd into nodejs:mainAug 30, 2026
77 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in f63bffd

@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
aduh95 pushed a commit that referenced this pull request Sep 3, 2026
The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: #64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
PR-URL: #65315
Reviewed-By: Tim Perry <pimterry@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@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.c++Issues and PRs that require attention from people who are familiar with C++.lib / srcIssues and PRs involving general changes in the lib/ or src/ directories.needs-ciPRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@trivenay@nodejs-github-bot@jasnell@pimterry@trivikr@bjohansebas
, '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

quic: remove unused fin flag from blob reader wakeup - #65315

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin
Aug 30, 2026
Merged

quic: remove unused fin flag from blob reader wakeup#65315
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin

Conversation

@trivenay

Copy link
Copy Markdown
Contributor

Fixes the dead code identified in #64767.

The blob reader used by QUIC inbound streams has two separate channels. The pull channel is where the iterator asks for data and gets a real answer: a chunk, "blocked, nothing available yet", or "end of stream". The wakeup channel exists only to wake a parked iterator after a blocked pull so it pulls again — it carries no data and answers no question.

The wakeup additionally carried a boolean label saying whether it was triggered by end-of-stream. That label is dead information: whatever it says, the woken iterator does the same single thing — loop back and pull. If the stream has ended, that next pull returns end-of-stream by itself, because the receive queue was already capped when the FIN was processed. The pull channel is the source of truth for "am I done?"; the label was a second announcement of something the very next pull confirms anyway, and the branch consuming it (if (fin) continue; as the final statement of the loop) behaves identically to not existing.

This removes the label end to end while keeping the wakeup itself: the JS iterator no longer reads a value from the wakeup promise, the C++ notifier no longer constructs or passes the boolean, and the end-of-stream path still fires a (now unlabeled) wakeup. All actual FIN processing — recording the final size, capping the receive queue, the stream state flags — is untouched.

One consequence deserves reviewer attention. The notifier coalesces wakeups: once it has woken the iterator, further wakeups are suppressed until the iterator actually pulls. Previously, end-of-stream wakeups bypassed that suppression "just in case". With the label gone the bypass goes too, so end-of-stream wakeups now coalesce like any other. This cannot stall the iterator: the iterator only parks after a pull returned "blocked", every pull resets the suppression flag on entry, and only synchronous JavaScript runs between that pull and the park — so a parked iterator always has suppression clear, and the first wakeup after parking always gets through. The bypass only ever fired while the iterator was already awake and about to pull, where an extra wakeup changes nothing.

Changes:

  • lib/internal/blob.js — stop reading a value from the wakeup; delete the dead branch and its comment.
  • src/node_blob.cc, src/node_blob.hNotifyPull() loses its boolean parameter and JS-facing argument.
  • src/quic/streams.cc — the end-of-stream call site drops the argument.

No behavior change; no new test. Existing test/parallel/test-quic-* and test/parallel/test-blob* pass on the compiled binary.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/quic

@nodejs-github-botnodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs involving general changes in the lib/ or src/ directories. needs-ci PRs that need a full CI run. labels Aug 15, 2026
@jasnell

Copy link
Copy Markdown
Member

@trivenay ... this will need a rebase

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

Rebased on main — thanks for the heads-up!

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9a01ab0 to 9cbb5e4CompareAugust 16, 2026 09:46
@codecov

codecovBot commented Aug 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 0% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.06%. Comparing base (c5eb9de) to head (2ebf33d).
⚠️ Report is 3 commits behind head on main.

Files with missing linesPatch %Lines
src/node_blob.cc0.00%3 Missing ⚠️
lib/internal/blob.js0.00%1 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #65315 +/- ##
==========================================
- Coverage 91.71% 90.06% -1.66% 
==========================================
Files 402 754 +352 Lines 181151 255731 +74580 Branches 27805 48323 +20518 ==========================================
+ Hits 166147 230317 +64170 - Misses 14664 16546 +1882 - Partials 340 8868 +8528 
Files with missing linesCoverage Δ
src/node_blob.h37.50% <ø> (ø)
lib/internal/blob.js88.40% <0.00%> (+6.77%)⬆️
src/node_blob.cc73.49% <0.00%> (ø)

... and 482 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.

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

The x86_64-darwin: with shared libraries failure is the test-common-wpt-backends — known flaky test, unrelated to this change. Thankfully there is already a fix in flight for it in #65320.

@jasnell

Copy link
Copy Markdown
Member

Just a note, this will have a few conflicts with #65309 but nothing major.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Sure — happy to rebase once #65309 lands.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Rebased on top of #65309 now that it has landed (05a8e91). No conflicts; the fin removal re-applies cleanly on the reworked wakeup path.

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9cbb5e4 to ebbaec7CompareAugust 28, 2026 15:35

@pimterrypimterry left a comment

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.

LGTM

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

This comment was marked as outdated.

@nodejs-github-bot

This comment was marked as outdated.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@jasnell

Copy link
Copy Markdown
Member

The PR likely needs to be rebased in order for CI to pass.

The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: nodejs#64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from ebbaec7 to 2ebf33dCompareAugust 29, 2026 18:47
@trivikrtrivikr added request-ci Add this label to start a Jenkins CI on a PR. author ready PRs with CI started, the required approvals, and no outstanding review comments. labels Aug 29, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 29, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@trivikrtrivikr added the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
@nodejs-github-bot
nodejs-github-bot merged commit f63bffd into nodejs:mainAug 30, 2026
77 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in f63bffd

@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
aduh95 pushed a commit that referenced this pull request Sep 3, 2026
The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: #64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
PR-URL: #65315
Reviewed-By: Tim Perry <pimterry@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@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.c++Issues and PRs that require attention from people who are familiar with C++.lib / srcIssues and PRs involving general changes in the lib/ or src/ directories.needs-ciPRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@trivenay@nodejs-github-bot@jasnell@pimterry@trivikr@bjohansebas
, '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

quic: remove unused fin flag from blob reader wakeup - #65315

Merged
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin
Aug 30, 2026
Merged

quic: remove unused fin flag from blob reader wakeup#65315
nodejs-github-bot merged 1 commit into
nodejs:mainfrom
trivenay:quic-blob-remove-dead-fin

Conversation

@trivenay

Copy link
Copy Markdown
Contributor

Fixes the dead code identified in #64767.

The blob reader used by QUIC inbound streams has two separate channels. The pull channel is where the iterator asks for data and gets a real answer: a chunk, "blocked, nothing available yet", or "end of stream". The wakeup channel exists only to wake a parked iterator after a blocked pull so it pulls again — it carries no data and answers no question.

The wakeup additionally carried a boolean label saying whether it was triggered by end-of-stream. That label is dead information: whatever it says, the woken iterator does the same single thing — loop back and pull. If the stream has ended, that next pull returns end-of-stream by itself, because the receive queue was already capped when the FIN was processed. The pull channel is the source of truth for "am I done?"; the label was a second announcement of something the very next pull confirms anyway, and the branch consuming it (if (fin) continue; as the final statement of the loop) behaves identically to not existing.

This removes the label end to end while keeping the wakeup itself: the JS iterator no longer reads a value from the wakeup promise, the C++ notifier no longer constructs or passes the boolean, and the end-of-stream path still fires a (now unlabeled) wakeup. All actual FIN processing — recording the final size, capping the receive queue, the stream state flags — is untouched.

One consequence deserves reviewer attention. The notifier coalesces wakeups: once it has woken the iterator, further wakeups are suppressed until the iterator actually pulls. Previously, end-of-stream wakeups bypassed that suppression "just in case". With the label gone the bypass goes too, so end-of-stream wakeups now coalesce like any other. This cannot stall the iterator: the iterator only parks after a pull returned "blocked", every pull resets the suppression flag on entry, and only synchronous JavaScript runs between that pull and the park — so a parked iterator always has suppression clear, and the first wakeup after parking always gets through. The bypass only ever fired while the iterator was already awake and about to pull, where an extra wakeup changes nothing.

Changes:

  • lib/internal/blob.js — stop reading a value from the wakeup; delete the dead branch and its comment.
  • src/node_blob.cc, src/node_blob.hNotifyPull() loses its boolean parameter and JS-facing argument.
  • src/quic/streams.cc — the end-of-stream call site drops the argument.

No behavior change; no new test. Existing test/parallel/test-quic-* and test/parallel/test-blob* pass on the compiled binary.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/quic

@nodejs-github-botnodejs-github-bot added c++ Issues and PRs that require attention from people who are familiar with C++. lib / src Issues and PRs involving general changes in the lib/ or src/ directories. needs-ci PRs that need a full CI run. labels Aug 15, 2026
@jasnell

Copy link
Copy Markdown
Member

@trivenay ... this will need a rebase

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

Rebased on main — thanks for the heads-up!

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9a01ab0 to 9cbb5e4CompareAugust 16, 2026 09:46
@codecov

codecovBot commented Aug 16, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 0% with 4 lines in your changes missing coverage. Please review.
✅ Project coverage is 90.06%. Comparing base (c5eb9de) to head (2ebf33d).
⚠️ Report is 3 commits behind head on main.

Files with missing linesPatch %Lines
src/node_blob.cc0.00%3 Missing ⚠️
lib/internal/blob.js0.00%1 Missing ⚠️
Additional details and impacted files
@@ Coverage Diff @@## main #65315 +/- ##
==========================================
- Coverage 91.71% 90.06% -1.66% 
==========================================
Files 402 754 +352 Lines 181151 255731 +74580 Branches 27805 48323 +20518 ==========================================
+ Hits 166147 230317 +64170 - Misses 14664 16546 +1882 - Partials 340 8868 +8528 
Files with missing linesCoverage Δ
src/node_blob.h37.50% <ø> (ø)
lib/internal/blob.js88.40% <0.00%> (+6.77%)⬆️
src/node_blob.cc73.49% <0.00%> (ø)

... and 482 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.

@trivenay

trivenay commented Aug 16, 2026

Copy link
Copy Markdown
ContributorAuthor

The x86_64-darwin: with shared libraries failure is the test-common-wpt-backends — known flaky test, unrelated to this change. Thankfully there is already a fix in flight for it in #65320.

@jasnell

Copy link
Copy Markdown
Member

Just a note, this will have a few conflicts with #65309 but nothing major.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Sure — happy to rebase once #65309 lands.

@trivenay

Copy link
Copy Markdown
ContributorAuthor

Rebased on top of #65309 now that it has landed (05a8e91). No conflicts; the fin removal re-applies cleanly on the reworked wakeup path.

@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from 9cbb5e4 to ebbaec7CompareAugust 28, 2026 15:35

@pimterrypimterry left a comment

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.

LGTM

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

This comment was marked as outdated.

@nodejs-github-bot

This comment was marked as outdated.

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@jasnell

Copy link
Copy Markdown
Member

The PR likely needs to be rebased in order for CI to pass.

The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: nodejs#64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
@trivenay
trivenayforce-pushed the quic-blob-remove-dead-fin branch from ebbaec7 to 2ebf33dCompareAugust 29, 2026 18:47
@trivikrtrivikr added request-ci Add this label to start a Jenkins CI on a PR. author ready PRs with CI started, the required approvals, and no outstanding review comments. labels Aug 29, 2026
@github-actionsgithub-actionsBot removed the request-ci Add this label to start a Jenkins CI on a PR. label Aug 29, 2026
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

@trivikrtrivikr added the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
@nodejs-github-bot
nodejs-github-bot merged commit f63bffd into nodejs:mainAug 30, 2026
77 checks passed
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Landed in f63bffd

@nodejs-github-botnodejs-github-bot removed the commit-queue PRs queued for automated landing through the Commit Queue. label Aug 30, 2026
aduh95 pushed a commit that referenced this pull request Sep 3, 2026
The fin argument threaded from Blob::Reader::NotifyPull to the JS
blob reader iterator was dead: the only consumer, `if (fin) continue;`,
was the last statement in the loop and behaved identically to falling
through. End-of-stream is always discovered by the subsequent pull
returning EOS, never via the wakeup label. Remove the flag from the
JS iterator, NotifyPull's signature/argv, and the EndReadable call
site. The `!fin` coalescing bypass collapses safely because a parked
reader always has pull_pending_ == false, so the first wakeup after
parking always fires.
Refs: #64767
Signed-off-by: Naman Trivedi <trivenay@amazon.com>
PR-URL: #65315
Reviewed-By: Tim Perry <pimterry@gmail.com>
Reviewed-By: James M Snell <jasnell@gmail.com>
Reviewed-By: Trivikram Kamat <trivikr.dev@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.c++Issues and PRs that require attention from people who are familiar with C++.lib / srcIssues and PRs involving general changes in the lib/ or src/ directories.needs-ciPRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

6 participants

@trivenay@nodejs-github-bot@jasnell@pimterry@trivikr@bjohansebas