Split HTTP/3 module out from QUIC#63995

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
pimterry wants to merge 11 commits into
base:main
Choose a base branch
from
Open

Split HTTP/3 module out from QUIC #63995

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
11 commits
Select commit Hold shift + click to select a range
b9cffb3
quic: create standalone Http3Session APIs around QUIC
pimterry Jun 10, 2026
35691fa
quic: split out full http3 module with separate request() API
pimterry Jun 10, 2026
92f5d2c
quic: use 'kApplication' not ALPN to explicitly connect QUIC to H3
pimterry Jun 11, 2026
0efd303
quic: make Applications optional, with raw stream support in sessions
pimterry Jun 16, 2026
dd48939
quic: move HTTP/3 protocol machinery into node:http3
pimterry Jun 16, 2026
55450be
quic: bring in a related performance optimizations en route
pimterry Jun 12, 2026
58eae6b
quic: move HTTP/3 event emit logic into Http3Application
pimterry Jun 15, 2026
33e84b7
quic: use http3Binding to drop header & priority stream logic from QUIC
pimterry Jun 16, 2026
ec1dc6e
quic: add docs for http3 module, update quic docs & internal README
pimterry Jun 18, 2026
9d175ef
quic: move HTTP/3 APIs back inside node:quic
pimterry Aug 9, 2026
4882960
quic: resolve various small further issues & omissions in HTTP/3 API
pimterry Aug 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1,404 changes: 764 additions & 640 deletions doc/api/quic.md
View file
Open in desktop

Large diffs are not rendered by default.

874 changes: 874 additions & 0 deletions lib/internal/quic/http3.js
View file
Open in desktop

Large diffs are not rendered by default.

889 changes: 114 additions & 775 deletions lib/internal/quic/quic.js
View file
Open in desktop

Large diffs are not rendered by default.

73 changes: 28 additions & 45 deletions lib/internal/quic/state.js
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -70,10 +70,9 @@ const {
IDX_STATE_SESSION_HANDSHAKE_COMPLETED,
IDX_STATE_SESSION_HANDSHAKE_CONFIRMED,
IDX_STATE_SESSION_STREAM_OPEN_ALLOWED,
IDX_STATE_SESSION_PRIORITY_SUPPORTED,
IDX_STATE_SESSION_HEADERS_SUPPORTED,
IDX_STATE_SESSION_WRAPPED,
IDX_STATE_SESSION_APPLICATION_TYPE,
IDX_STATE_SESSION_IS_SERVER,
IDX_STATE_SESSION_HAS_APPLICATION,
IDX_STATE_SESSION_NO_ERROR_CODE,
IDX_STATE_SESSION_INTERNAL_ERROR_CODE,
IDX_STATE_SESSION_MAX_DATAGRAM_SIZE,
Expand DownExpand Up@@ -117,10 +116,9 @@ assert(IDX_STATE_SESSION_STATELESS_RESET !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_COMPLETED !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_CONFIRMED !== undefined);
assert(IDX_STATE_SESSION_STREAM_OPEN_ALLOWED !== undefined);
assert(IDX_STATE_SESSION_PRIORITY_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HEADERS_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HAS_APPLICATION !== undefined);
assert(IDX_STATE_SESSION_IS_SERVER !== undefined);
assert(IDX_STATE_SESSION_WRAPPED !== undefined);
assert(IDX_STATE_SESSION_APPLICATION_TYPE !== undefined);
assert(IDX_STATE_SESSION_NO_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_INTERNAL_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_MAX_DATAGRAM_SIZE !== undefined);
Expand DownExpand Up@@ -351,7 +349,6 @@ class QuicSessionState {
static #LISTENER_SESSION_TICKET = 1 << 3;
static #LISTENER_NEW_TOKEN = 1 << 4;
static #LISTENER_ORIGIN = 1 << 5;
static #LISTENER_APPLICATION = 1 << 6;

#getListenerFlag(flag) {
const handle = this.#handle;
Expand All@@ -370,13 +367,6 @@ class QuicSessionState {
val ? (current | flag) : (current & ~flag), kIsLittleEndian);
}

/** @type {boolean} */
get hasApplicationListener() {
return this.#getListenerFlag(QuicSessionState.#LISTENER_APPLICATION);
}
set hasApplicationListener(val) {
this.#setListenerFlag(QuicSessionState.#LISTENER_APPLICATION, val);
}

/** @type {boolean} */
get hasPathValidationListener() {
Expand DownExpand Up@@ -475,22 +465,15 @@ class QuicSessionState {
return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_STREAM_OPEN_ALLOWED) !== 0;
}

/** @type {boolean} */
get isPrioritySupported() {
const handle = this.#handle;
if (handle === undefined) return undefined;
return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_PRIORITY_SUPPORTED) !== 0;
}

/**
* Whether the negotiated application protocol supports headers.
* Returns 0 (unknown), 1 (supported), or 2 (not supported).
* @type {number}
* Whether a protocol application (vs the native raw-stream path) is
* installed on the session.
* @type {boolean}
*/
get headersSupported() {
get hasApplication() {
const handle = this.#handle;
if (handle === undefined) return undefined;
return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HEADERS_SUPPORTED);
return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HAS_APPLICATION) !== 0;
}

/** @type {boolean} */
Expand All@@ -500,17 +483,21 @@ class QuicSessionState {
return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_WRAPPED) !== 0;
}

/** @type {number} */
get applicationType() {
/**
* True for server (accepted) sessions, false for client (initiated)
* sessions. Fixed for the session's lifetime.
* @type {boolean}
*/
get isServer() {
const handle = this.#handle;
if (handle === undefined) return undefined;
return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_APPLICATION_TYPE);
return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_IS_SERVER) !== 0;
}

/**
* The negotiated application protocol's "no error" code, populated
* by the C++ layer when the application is selected during ALPN
* negotiation. For raw QUIC this is `0n`; for HTTP/3 this is
* The installed application's "no error" code, populated
* by the C++ layer when the application is installed.
* For raw QUIC this is `0n`; for HTTP/3 this is
* `0x100n` (`H3_NO_ERROR`).
* @type {bigint}
*/
Expand All@@ -522,7 +509,7 @@ class QuicSessionState {
}

/**
* The negotiated application protocol's "internal error" code,
* The installed application's "internal error" code,
* populated by the C++ layer when the application is selected
* during ALPN negotiation. Used as the wire code for `RESET_STREAM`
* frames when a stream is aborted without a more specific code.
Expand DownExpand Up@@ -590,10 +577,9 @@ class QuicSessionState {
isHandshakeCompleted,
isHandshakeConfirmed,
isStreamOpenAllowed,
isPrioritySupported,
headersSupported,
hasApplication,
isWrapped,
applicationType,
isServer,
noErrorCode,
internalErrorCode,
maxDatagramSize,
Expand All@@ -615,10 +601,9 @@ class QuicSessionState {
isHandshakeCompleted,
isHandshakeConfirmed,
isStreamOpenAllowed,
isPrioritySupported,
headersSupported,
hasApplication,
isWrapped,
applicationType,
isServer,
noErrorCode: `${noErrorCode}`,
internalErrorCode: `${internalErrorCode}`,
maxDatagramSize: `${maxDatagramSize}`,
Expand DownExpand Up@@ -656,10 +641,9 @@ class QuicSessionState {
isHandshakeCompleted,
isHandshakeConfirmed,
isStreamOpenAllowed,
isPrioritySupported,
headersSupported,
hasApplication,
isWrapped,
applicationType,
isServer,
noErrorCode,
internalErrorCode,
maxDatagramSize,
Expand All@@ -681,10 +665,9 @@ class QuicSessionState {
isHandshakeCompleted,
isHandshakeConfirmed,
isStreamOpenAllowed,
isPrioritySupported,
headersSupported,
hasApplication,
isWrapped,
applicationType,
isServer,
noErrorCode,
internalErrorCode,
maxDatagramSize,
Expand Down
14 changes: 0 additions & 14 deletions lib/internal/quic/symbols.js
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -35,30 +35,23 @@ const kDatagram = Symbol('kDatagram');
const kDatagramStatus = Symbol('kDatagramStatus');
const kEarlyDataRejected = Symbol('kEarlyDataRejected');
const kFinishClose = Symbol('kFinishClose');
const kGoaway = Symbol('kGoaway');
const kHandshake = Symbol('kHandshake');
const kHandshakeCompleted = Symbol('kHandshakeCompleted');
const kVerifyPeer = Symbol('kVerifyPeer');
const kHeaders = Symbol('kHeaders');
const kKeylog = Symbol('kKeylog');
const kListen = Symbol('kListen');
const kQlog = Symbol('kQlog');
const kNewSession = Symbol('kNewSession');
const kNewStream = Symbol('kNewStream');
const kNewToken = Symbol('kNewToken');
const kStreamCallbacks = Symbol('kStreamCallbacks');
const kOrigin = Symbol('kOrigin');
const kOwner = Symbol('kOwner');
const kPathValidation = Symbol('kPathValidation');
const kPrivateConstructor = Symbol('kPrivateConstructor');
const kRemoveSession = Symbol('kRemoveSession');
const kRemoveStream = Symbol('kRemoveStream');
const kReset = Symbol('kReset');
const kSendHeaders = Symbol('kSendHeaders');
const kSessionApplication = Symbol('kSessionApplication');
const kSessionTicket = Symbol('kSessionTicket');
const kStopSending = Symbol('kStopSending');
const kTrailers = Symbol('kTrailers');
const kVersionNegotiation = Symbol('kVersionNegotiation');

module.exports = {
Expand All@@ -70,32 +63,25 @@ module.exports = {
kDrain,
kEarlyDataRejected,
kFinishClose,
kGoaway,
kHandshake,
kHandshakeCompleted,
kVerifyPeer,
kHeaders,
kInspect,
kKeylog,
kKeyObjectHandle,
kListen,
kNewSession,
kNewStream,
kNewToken,
kStreamCallbacks,
kOrigin,
kOwner,
kQlog,
kPathValidation,
kPrivateConstructor,
kRemoveSession,
kRemoveStream,
kReset,
kSendHeaders,
kSessionApplication,
kSessionTicket,
kStopSending,
kTrailers,
kVersionNegotiation,
};

Expand Down
11 changes: 11 additions & 0 deletions lib/quic.js
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -20,6 +20,13 @@ const {
DEFAULT_GROUPS,
} = require('internal/quic/quic');

const {
connect: connectHttp3,
listen: listenHttp3,
Http3Session,
Http3Stream,
} = require('internal/quic/http3');

const cc = {
get RENO() { return CC_ALGO_RENO; },
get CUBIC() { return CC_ALGO_CUBIC; },
Expand All@@ -35,7 +42,11 @@ const constants = {
module.exports = {
connect,
listen,
connectHttp3,
listenHttp3,

@jasnelljasnellAug 17, 2026

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.

Do we really need separate connect and listen variants for http3?

@pimterrypimterryAug 17, 2026

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.

Strictly speaking, no.

Those two APIs create a auto-H3 client/server with sensible H3 defaults that automatically wires up the h3 application. It's roughly the equivalent to the current auto-HTTP3 support. But with this PR you can now use new Http3Session(quicSession) to dynamically create an HTTP/3 session on top of QUIC instead, so a separate server/client API is no longer necessary.

It is mildly more fiddly this way: you have to manually create the H3 session every time, and we wouldn't offer a way to set up any HTTP/3 specific defaults (e.g. ALPN) for you. Given we now intend this only for low-level use cases that's fine though, it gives you more control en route anyway.

There is one practical limitation right now: you can't do server 0RTT with dynamic attach like this (because by the time session event fires on the server to attach, that's been partially processed already). That is fixable I think, it's just a separate step I was going to leave until later. I could investigate that further within this PR instead though, and then if there's a good solution then we could drop these with no practical downside.

listEndpoints,
Http3Session,
Http3Stream,
QuicEndpoint,
QuicError,
QuicSession,
Expand Down
3 changes: 2 additions & 1 deletion src/node_builtins.cc
View file
Open in desktop
Original file line numberDiff line numberDiff line change
Expand Up@@ -138,7 +138,8 @@ BuiltinLoader::BuiltinCategories BuiltinLoader::GetBuiltinCategories() const {
#endif // !HAVE_OPENSSL
#ifndef OPENSSL_NO_QUIC
"internal/quic/quic", "internal/quic/symbols", "internal/quic/stats",
"internal/quic/state",
"internal/quic/state", "internal/quic/diagnostics",
"internal/quic/http3",
#endif // !OPENSSL_NO_QUIC
#if HAVE_DTLS
"internal/dtls/dtls", "internal/dtls/symbols", "internal/dtls/stats",
Expand Down
Loading
Loading
, '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
Split HTTP/3 module out from QUIC#63995

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

pimterry
wants to merge
11
commits into

base:main
Choose a base branch

from

 Open


Split HTTP/3 module out from QUIC
#63995
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


11 commits


Select commit
Hold shift + click to select a range
b9cffb3

quic: create standalone Http3Session APIs around QUIC


pimterry Jun 10, 2026
35691fa

quic: split out full http3 module with separate request() API


pimterry Jun 10, 2026
92f5d2c

quic: use 'kApplication' not ALPN to explicitly connect QUIC to H3


pimterry Jun 11, 2026
0efd303

quic: make Applications optional, with raw stream support in sessions


pimterry Jun 16, 2026
dd48939

quic: move HTTP/3 protocol machinery into node:http3


pimterry Jun 16, 2026
55450be

quic: bring in a related performance optimizations en route


pimterry Jun 12, 2026
58eae6b

quic: move HTTP/3 event emit logic into Http3Application


pimterry Jun 15, 2026
33e84b7

quic: use http3Binding to drop header & priority stream logic from QUIC


pimterry Jun 16, 2026
ec1dc6e

quic: add docs for http3 module, update quic docs & internal README


pimterry Jun 18, 2026
9d175ef

quic: move HTTP/3 APIs back inside node:quic


pimterry Aug 9, 2026
4882960

quic: resolve various small further issues & omissions in HTTP/3 API


pimterry Aug 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1,404 changes: 764 additions & 640 deletions
doc/api/quic.md

View file


Open in desktop


Large diffs are not rendered by default.


874 changes: 874 additions & 0 deletions
lib/internal/quic/http3.js

View file


Open in desktop


Large diffs are not rendered by default.


889 changes: 114 additions & 775 deletions
lib/internal/quic/quic.js

View file


Open in desktop


Large diffs are not rendered by default.


73 changes: 28 additions & 45 deletions
lib/internal/quic/state.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -70,10 +70,9 @@ const {
 IDX_STATE_SESSION_HANDSHAKE_COMPLETED,
 IDX_STATE_SESSION_HANDSHAKE_CONFIRMED,
 IDX_STATE_SESSION_STREAM_OPEN_ALLOWED,
 IDX_STATE_SESSION_PRIORITY_SUPPORTED,
 IDX_STATE_SESSION_HEADERS_SUPPORTED,
 IDX_STATE_SESSION_WRAPPED,
 IDX_STATE_SESSION_APPLICATION_TYPE,
 IDX_STATE_SESSION_IS_SERVER,
 IDX_STATE_SESSION_HAS_APPLICATION,
 IDX_STATE_SESSION_NO_ERROR_CODE,
 IDX_STATE_SESSION_INTERNAL_ERROR_CODE,
 IDX_STATE_SESSION_MAX_DATAGRAM_SIZE,
Expand DownExpand Up@@ -117,10 +116,9 @@ assert(IDX_STATE_SESSION_STATELESS_RESET !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_COMPLETED !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_CONFIRMED !== undefined);
assert(IDX_STATE_SESSION_STREAM_OPEN_ALLOWED !== undefined);
assert(IDX_STATE_SESSION_PRIORITY_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HEADERS_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HAS_APPLICATION !== undefined);
assert(IDX_STATE_SESSION_IS_SERVER !== undefined);
assert(IDX_STATE_SESSION_WRAPPED !== undefined);
assert(IDX_STATE_SESSION_APPLICATION_TYPE !== undefined);
assert(IDX_STATE_SESSION_NO_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_INTERNAL_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_MAX_DATAGRAM_SIZE !== undefined);
Expand DownExpand Up@@ -351,7 +349,6 @@ class QuicSessionState {
 static #LISTENER_SESSION_TICKET = 1 << 3;
 static #LISTENER_NEW_TOKEN = 1 << 4;
 static #LISTENER_ORIGIN = 1 << 5;
 static #LISTENER_APPLICATION = 1 << 6;

 #getListenerFlag(flag) {
 const handle = this.#handle;
Expand All@@ -370,13 +367,6 @@ class QuicSessionState {
 val ? (current | flag) : (current & ~flag), kIsLittleEndian);
 }

 /** @type {boolean} */
 get hasApplicationListener() {
 return this.#getListenerFlag(QuicSessionState.#LISTENER_APPLICATION);
 }
 set hasApplicationListener(val) {
 this.#setListenerFlag(QuicSessionState.#LISTENER_APPLICATION, val);
 }

 /** @type {boolean} */
 get hasPathValidationListener() {
Expand DownExpand Up@@ -475,22 +465,15 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_STREAM_OPEN_ALLOWED) !== 0;
 }

 /** @type {boolean} */
 get isPrioritySupported() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_PRIORITY_SUPPORTED) !== 0;
 }

 /**
 * Whether the negotiated application protocol supports headers.
 * Returns 0 (unknown), 1 (supported), or 2 (not supported).
 * @type {number}
 * Whether a protocol application (vs the native raw-stream path) is
 * installed on the session.
 * @type {boolean}
 */
 get headersSupported() {
 get hasApplication() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HEADERS_SUPPORTED);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HAS_APPLICATION) !== 0;
 }

 /** @type {boolean} */
Expand All@@ -500,17 +483,21 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_WRAPPED) !== 0;
 }

 /** @type {number} */
 get applicationType() {
 /**
 * True for server (accepted) sessions, false for client (initiated)
 * sessions. Fixed for the session's lifetime.
 * @type {boolean}
 */
 get isServer() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_APPLICATION_TYPE);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_IS_SERVER) !== 0;
 }

 /**
 * The negotiated application protocol's "no error" code, populated
 * by the C++ layer when the application is selected during ALPN
 * negotiation. For raw QUIC this is `0n`; for HTTP/3 this is
 * The installed application's "no error" code, populated
 * by the C++ layer when the application is installed.
 * For raw QUIC this is `0n`; for HTTP/3 this is
 * `0x100n` (`H3_NO_ERROR`).
 * @type {bigint}
 */
Expand All@@ -522,7 +509,7 @@ class QuicSessionState {
 }

 /**
 * The negotiated application protocol's "internal error" code,
 * The installed application's "internal error" code,
 * populated by the C++ layer when the application is selected
 * during ALPN negotiation. Used as the wire code for `RESET_STREAM`
 * frames when a stream is aborted without a more specific code.
Expand DownExpand Up@@ -590,10 +577,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -615,10 +601,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode: `${noErrorCode}`,
 internalErrorCode: `${internalErrorCode}`,
 maxDatagramSize: `${maxDatagramSize}`,
Expand DownExpand Up@@ -656,10 +641,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -681,10 +665,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand Down

14 changes: 0 additions & 14 deletions
lib/internal/quic/symbols.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,30 +35,23 @@ const kDatagram = Symbol('kDatagram');
const kDatagramStatus = Symbol('kDatagramStatus');
const kEarlyDataRejected = Symbol('kEarlyDataRejected');
const kFinishClose = Symbol('kFinishClose');
const kGoaway = Symbol('kGoaway');
const kHandshake = Symbol('kHandshake');
const kHandshakeCompleted = Symbol('kHandshakeCompleted');
const kVerifyPeer = Symbol('kVerifyPeer');
const kHeaders = Symbol('kHeaders');
const kKeylog = Symbol('kKeylog');
const kListen = Symbol('kListen');
const kQlog = Symbol('kQlog');
const kNewSession = Symbol('kNewSession');
const kNewStream = Symbol('kNewStream');
const kNewToken = Symbol('kNewToken');
const kStreamCallbacks = Symbol('kStreamCallbacks');
const kOrigin = Symbol('kOrigin');
const kOwner = Symbol('kOwner');
const kPathValidation = Symbol('kPathValidation');
const kPrivateConstructor = Symbol('kPrivateConstructor');
const kRemoveSession = Symbol('kRemoveSession');
const kRemoveStream = Symbol('kRemoveStream');
const kReset = Symbol('kReset');
const kSendHeaders = Symbol('kSendHeaders');
const kSessionApplication = Symbol('kSessionApplication');
const kSessionTicket = Symbol('kSessionTicket');
const kStopSending = Symbol('kStopSending');
const kTrailers = Symbol('kTrailers');
const kVersionNegotiation = Symbol('kVersionNegotiation');

module.exports = {
Expand All@@ -70,32 +63,25 @@ module.exports = {
 kDrain,
 kEarlyDataRejected,
 kFinishClose,
 kGoaway,
 kHandshake,
 kHandshakeCompleted,
 kVerifyPeer,
 kHeaders,
 kInspect,
 kKeylog,
 kKeyObjectHandle,
 kListen,
 kNewSession,
 kNewStream,
 kNewToken,
 kStreamCallbacks,
 kOrigin,
 kOwner,
 kQlog,
 kPathValidation,
 kPrivateConstructor,
 kRemoveSession,
 kRemoveStream,
 kReset,
 kSendHeaders,
 kSessionApplication,
 kSessionTicket,
 kStopSending,
 kTrailers,
 kVersionNegotiation,
};

Expand Down

11 changes: 11 additions & 0 deletions
lib/quic.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -20,6 +20,13 @@ const {
 DEFAULT_GROUPS,
} = require('internal/quic/quic');

const {
 connect: connectHttp3,
 listen: listenHttp3,
 Http3Session,
 Http3Stream,
} = require('internal/quic/http3');

const cc = {
 get RENO() { return CC_ALGO_RENO; },
 get CUBIC() { return CC_ALGO_CUBIC; },
Expand All@@ -35,7 +42,11 @@ const constants = {
module.exports = {
 connect,
 listen,
 connectHttp3,
 listenHttp3,
@jasnelljasnellAug 17, 2026

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.

Do we really need separate connect and listen variants for http3?
@pimterrypimterryAug 17, 2026

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.

Strictly speaking, no.
Those two APIs create a auto-H3 client/server with sensible H3 defaults that automatically wires up the h3 application. It's roughly the equivalent to the current auto-HTTP3 support. But with this PR you can now use new Http3Session(quicSession) to dynamically create an HTTP/3 session on top of QUIC instead, so a separate server/client API is no longer necessary.
It is mildly more fiddly this way: you have to manually create the H3 session every time, and we wouldn't offer a way to set up any HTTP/3 specific defaults (e.g. ALPN) for you. Given we now intend this only for low-level use cases that's fine though, it gives you more control en route anyway.
There is one practical limitation right now: you can't do server 0RTT with dynamic attach like this (because by the time session event fires on the server to attach, that's been partially processed already). That is fixable I think, it's just a separate step I was going to leave until later. I could investigate that further within this PR instead though, and then if there's a good solution then we could drop these with no practical downside.
 listEndpoints,
 Http3Session,
 Http3Stream,
 QuicEndpoint,
 QuicError,
 QuicSession,
Expand Down

3 changes: 2 additions & 1 deletion
src/node_builtins.cc

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -138,7 +138,8 @@ BuiltinLoader::BuiltinCategories BuiltinLoader::GetBuiltinCategories() const {
#endif // !HAVE_OPENSSL
#ifndef OPENSSL_NO_QUIC
 "internal/quic/quic", "internal/quic/symbols", "internal/quic/stats",
 "internal/quic/state",
 "internal/quic/state", "internal/quic/diagnostics",
 "internal/quic/http3",
#endif // !OPENSSL_NO_QUIC
#if HAVE_DTLS
 "internal/dtls/dtls", "internal/dtls/symbols", "internal/dtls/stats",
Expand Down
Loading
Loading

, '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
Split HTTP/3 module out from QUIC#63995

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

pimterry
wants to merge
11
commits into

base:main
Choose a base branch

from

 Open


Split HTTP/3 module out from QUIC
#63995
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


11 commits


Select commit
Hold shift + click to select a range
b9cffb3

quic: create standalone Http3Session APIs around QUIC


pimterry Jun 10, 2026
35691fa

quic: split out full http3 module with separate request() API


pimterry Jun 10, 2026
92f5d2c

quic: use 'kApplication' not ALPN to explicitly connect QUIC to H3


pimterry Jun 11, 2026
0efd303

quic: make Applications optional, with raw stream support in sessions


pimterry Jun 16, 2026
dd48939

quic: move HTTP/3 protocol machinery into node:http3


pimterry Jun 16, 2026
55450be

quic: bring in a related performance optimizations en route


pimterry Jun 12, 2026
58eae6b

quic: move HTTP/3 event emit logic into Http3Application


pimterry Jun 15, 2026
33e84b7

quic: use http3Binding to drop header & priority stream logic from QUIC


pimterry Jun 16, 2026
ec1dc6e

quic: add docs for http3 module, update quic docs & internal README


pimterry Jun 18, 2026
9d175ef

quic: move HTTP/3 APIs back inside node:quic


pimterry Aug 9, 2026
4882960

quic: resolve various small further issues & omissions in HTTP/3 API


pimterry Aug 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1,404 changes: 764 additions & 640 deletions
doc/api/quic.md

View file


Open in desktop


Large diffs are not rendered by default.


874 changes: 874 additions & 0 deletions
lib/internal/quic/http3.js

View file


Open in desktop


Large diffs are not rendered by default.


889 changes: 114 additions & 775 deletions
lib/internal/quic/quic.js

View file


Open in desktop


Large diffs are not rendered by default.


73 changes: 28 additions & 45 deletions
lib/internal/quic/state.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -70,10 +70,9 @@ const {
 IDX_STATE_SESSION_HANDSHAKE_COMPLETED,
 IDX_STATE_SESSION_HANDSHAKE_CONFIRMED,
 IDX_STATE_SESSION_STREAM_OPEN_ALLOWED,
 IDX_STATE_SESSION_PRIORITY_SUPPORTED,
 IDX_STATE_SESSION_HEADERS_SUPPORTED,
 IDX_STATE_SESSION_WRAPPED,
 IDX_STATE_SESSION_APPLICATION_TYPE,
 IDX_STATE_SESSION_IS_SERVER,
 IDX_STATE_SESSION_HAS_APPLICATION,
 IDX_STATE_SESSION_NO_ERROR_CODE,
 IDX_STATE_SESSION_INTERNAL_ERROR_CODE,
 IDX_STATE_SESSION_MAX_DATAGRAM_SIZE,
Expand DownExpand Up@@ -117,10 +116,9 @@ assert(IDX_STATE_SESSION_STATELESS_RESET !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_COMPLETED !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_CONFIRMED !== undefined);
assert(IDX_STATE_SESSION_STREAM_OPEN_ALLOWED !== undefined);
assert(IDX_STATE_SESSION_PRIORITY_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HEADERS_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HAS_APPLICATION !== undefined);
assert(IDX_STATE_SESSION_IS_SERVER !== undefined);
assert(IDX_STATE_SESSION_WRAPPED !== undefined);
assert(IDX_STATE_SESSION_APPLICATION_TYPE !== undefined);
assert(IDX_STATE_SESSION_NO_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_INTERNAL_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_MAX_DATAGRAM_SIZE !== undefined);
Expand DownExpand Up@@ -351,7 +349,6 @@ class QuicSessionState {
 static #LISTENER_SESSION_TICKET = 1 << 3;
 static #LISTENER_NEW_TOKEN = 1 << 4;
 static #LISTENER_ORIGIN = 1 << 5;
 static #LISTENER_APPLICATION = 1 << 6;

 #getListenerFlag(flag) {
 const handle = this.#handle;
Expand All@@ -370,13 +367,6 @@ class QuicSessionState {
 val ? (current | flag) : (current & ~flag), kIsLittleEndian);
 }

 /** @type {boolean} */
 get hasApplicationListener() {
 return this.#getListenerFlag(QuicSessionState.#LISTENER_APPLICATION);
 }
 set hasApplicationListener(val) {
 this.#setListenerFlag(QuicSessionState.#LISTENER_APPLICATION, val);
 }

 /** @type {boolean} */
 get hasPathValidationListener() {
Expand DownExpand Up@@ -475,22 +465,15 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_STREAM_OPEN_ALLOWED) !== 0;
 }

 /** @type {boolean} */
 get isPrioritySupported() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_PRIORITY_SUPPORTED) !== 0;
 }

 /**
 * Whether the negotiated application protocol supports headers.
 * Returns 0 (unknown), 1 (supported), or 2 (not supported).
 * @type {number}
 * Whether a protocol application (vs the native raw-stream path) is
 * installed on the session.
 * @type {boolean}
 */
 get headersSupported() {
 get hasApplication() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HEADERS_SUPPORTED);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HAS_APPLICATION) !== 0;
 }

 /** @type {boolean} */
Expand All@@ -500,17 +483,21 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_WRAPPED) !== 0;
 }

 /** @type {number} */
 get applicationType() {
 /**
 * True for server (accepted) sessions, false for client (initiated)
 * sessions. Fixed for the session's lifetime.
 * @type {boolean}
 */
 get isServer() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_APPLICATION_TYPE);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_IS_SERVER) !== 0;
 }

 /**
 * The negotiated application protocol's "no error" code, populated
 * by the C++ layer when the application is selected during ALPN
 * negotiation. For raw QUIC this is `0n`; for HTTP/3 this is
 * The installed application's "no error" code, populated
 * by the C++ layer when the application is installed.
 * For raw QUIC this is `0n`; for HTTP/3 this is
 * `0x100n` (`H3_NO_ERROR`).
 * @type {bigint}
 */
Expand All@@ -522,7 +509,7 @@ class QuicSessionState {
 }

 /**
 * The negotiated application protocol's "internal error" code,
 * The installed application's "internal error" code,
 * populated by the C++ layer when the application is selected
 * during ALPN negotiation. Used as the wire code for `RESET_STREAM`
 * frames when a stream is aborted without a more specific code.
Expand DownExpand Up@@ -590,10 +577,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -615,10 +601,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode: `${noErrorCode}`,
 internalErrorCode: `${internalErrorCode}`,
 maxDatagramSize: `${maxDatagramSize}`,
Expand DownExpand Up@@ -656,10 +641,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -681,10 +665,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand Down

14 changes: 0 additions & 14 deletions
lib/internal/quic/symbols.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,30 +35,23 @@ const kDatagram = Symbol('kDatagram');
const kDatagramStatus = Symbol('kDatagramStatus');
const kEarlyDataRejected = Symbol('kEarlyDataRejected');
const kFinishClose = Symbol('kFinishClose');
const kGoaway = Symbol('kGoaway');
const kHandshake = Symbol('kHandshake');
const kHandshakeCompleted = Symbol('kHandshakeCompleted');
const kVerifyPeer = Symbol('kVerifyPeer');
const kHeaders = Symbol('kHeaders');
const kKeylog = Symbol('kKeylog');
const kListen = Symbol('kListen');
const kQlog = Symbol('kQlog');
const kNewSession = Symbol('kNewSession');
const kNewStream = Symbol('kNewStream');
const kNewToken = Symbol('kNewToken');
const kStreamCallbacks = Symbol('kStreamCallbacks');
const kOrigin = Symbol('kOrigin');
const kOwner = Symbol('kOwner');
const kPathValidation = Symbol('kPathValidation');
const kPrivateConstructor = Symbol('kPrivateConstructor');
const kRemoveSession = Symbol('kRemoveSession');
const kRemoveStream = Symbol('kRemoveStream');
const kReset = Symbol('kReset');
const kSendHeaders = Symbol('kSendHeaders');
const kSessionApplication = Symbol('kSessionApplication');
const kSessionTicket = Symbol('kSessionTicket');
const kStopSending = Symbol('kStopSending');
const kTrailers = Symbol('kTrailers');
const kVersionNegotiation = Symbol('kVersionNegotiation');

module.exports = {
Expand All@@ -70,32 +63,25 @@ module.exports = {
 kDrain,
 kEarlyDataRejected,
 kFinishClose,
 kGoaway,
 kHandshake,
 kHandshakeCompleted,
 kVerifyPeer,
 kHeaders,
 kInspect,
 kKeylog,
 kKeyObjectHandle,
 kListen,
 kNewSession,
 kNewStream,
 kNewToken,
 kStreamCallbacks,
 kOrigin,
 kOwner,
 kQlog,
 kPathValidation,
 kPrivateConstructor,
 kRemoveSession,
 kRemoveStream,
 kReset,
 kSendHeaders,
 kSessionApplication,
 kSessionTicket,
 kStopSending,
 kTrailers,
 kVersionNegotiation,
};

Expand Down

11 changes: 11 additions & 0 deletions
lib/quic.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -20,6 +20,13 @@ const {
 DEFAULT_GROUPS,
} = require('internal/quic/quic');

const {
 connect: connectHttp3,
 listen: listenHttp3,
 Http3Session,
 Http3Stream,
} = require('internal/quic/http3');

const cc = {
 get RENO() { return CC_ALGO_RENO; },
 get CUBIC() { return CC_ALGO_CUBIC; },
Expand All@@ -35,7 +42,11 @@ const constants = {
module.exports = {
 connect,
 listen,
 connectHttp3,
 listenHttp3,
@jasnelljasnellAug 17, 2026

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.

Do we really need separate connect and listen variants for http3?
@pimterrypimterryAug 17, 2026

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.

Strictly speaking, no.
Those two APIs create a auto-H3 client/server with sensible H3 defaults that automatically wires up the h3 application. It's roughly the equivalent to the current auto-HTTP3 support. But with this PR you can now use new Http3Session(quicSession) to dynamically create an HTTP/3 session on top of QUIC instead, so a separate server/client API is no longer necessary.
It is mildly more fiddly this way: you have to manually create the H3 session every time, and we wouldn't offer a way to set up any HTTP/3 specific defaults (e.g. ALPN) for you. Given we now intend this only for low-level use cases that's fine though, it gives you more control en route anyway.
There is one practical limitation right now: you can't do server 0RTT with dynamic attach like this (because by the time session event fires on the server to attach, that's been partially processed already). That is fixable I think, it's just a separate step I was going to leave until later. I could investigate that further within this PR instead though, and then if there's a good solution then we could drop these with no practical downside.
 listEndpoints,
 Http3Session,
 Http3Stream,
 QuicEndpoint,
 QuicError,
 QuicSession,
Expand Down

3 changes: 2 additions & 1 deletion
src/node_builtins.cc

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -138,7 +138,8 @@ BuiltinLoader::BuiltinCategories BuiltinLoader::GetBuiltinCategories() const {
#endif // !HAVE_OPENSSL
#ifndef OPENSSL_NO_QUIC
 "internal/quic/quic", "internal/quic/symbols", "internal/quic/stats",
 "internal/quic/state",
 "internal/quic/state", "internal/quic/diagnostics",
 "internal/quic/http3",
#endif // !OPENSSL_NO_QUIC
#if HAVE_DTLS
 "internal/dtls/dtls", "internal/dtls/symbols", "internal/dtls/stats",
Expand Down
Loading
Loading

, '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
Split HTTP/3 module out from QUIC#63995

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

pimterry
wants to merge
11
commits into

base:main
Choose a base branch

from

 Open


Split HTTP/3 module out from QUIC
#63995
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


11 commits


Select commit
Hold shift + click to select a range
b9cffb3

quic: create standalone Http3Session APIs around QUIC


pimterry Jun 10, 2026
35691fa

quic: split out full http3 module with separate request() API


pimterry Jun 10, 2026
92f5d2c

quic: use 'kApplication' not ALPN to explicitly connect QUIC to H3


pimterry Jun 11, 2026
0efd303

quic: make Applications optional, with raw stream support in sessions


pimterry Jun 16, 2026
dd48939

quic: move HTTP/3 protocol machinery into node:http3


pimterry Jun 16, 2026
55450be

quic: bring in a related performance optimizations en route


pimterry Jun 12, 2026
58eae6b

quic: move HTTP/3 event emit logic into Http3Application


pimterry Jun 15, 2026
33e84b7

quic: use http3Binding to drop header & priority stream logic from QUIC


pimterry Jun 16, 2026
ec1dc6e

quic: add docs for http3 module, update quic docs & internal README


pimterry Jun 18, 2026
9d175ef

quic: move HTTP/3 APIs back inside node:quic


pimterry Aug 9, 2026
4882960

quic: resolve various small further issues & omissions in HTTP/3 API


pimterry Aug 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1,404 changes: 764 additions & 640 deletions
doc/api/quic.md

View file


Open in desktop


Large diffs are not rendered by default.


874 changes: 874 additions & 0 deletions
lib/internal/quic/http3.js

View file


Open in desktop


Large diffs are not rendered by default.


889 changes: 114 additions & 775 deletions
lib/internal/quic/quic.js

View file


Open in desktop


Large diffs are not rendered by default.


73 changes: 28 additions & 45 deletions
lib/internal/quic/state.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -70,10 +70,9 @@ const {
 IDX_STATE_SESSION_HANDSHAKE_COMPLETED,
 IDX_STATE_SESSION_HANDSHAKE_CONFIRMED,
 IDX_STATE_SESSION_STREAM_OPEN_ALLOWED,
 IDX_STATE_SESSION_PRIORITY_SUPPORTED,
 IDX_STATE_SESSION_HEADERS_SUPPORTED,
 IDX_STATE_SESSION_WRAPPED,
 IDX_STATE_SESSION_APPLICATION_TYPE,
 IDX_STATE_SESSION_IS_SERVER,
 IDX_STATE_SESSION_HAS_APPLICATION,
 IDX_STATE_SESSION_NO_ERROR_CODE,
 IDX_STATE_SESSION_INTERNAL_ERROR_CODE,
 IDX_STATE_SESSION_MAX_DATAGRAM_SIZE,
Expand DownExpand Up@@ -117,10 +116,9 @@ assert(IDX_STATE_SESSION_STATELESS_RESET !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_COMPLETED !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_CONFIRMED !== undefined);
assert(IDX_STATE_SESSION_STREAM_OPEN_ALLOWED !== undefined);
assert(IDX_STATE_SESSION_PRIORITY_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HEADERS_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HAS_APPLICATION !== undefined);
assert(IDX_STATE_SESSION_IS_SERVER !== undefined);
assert(IDX_STATE_SESSION_WRAPPED !== undefined);
assert(IDX_STATE_SESSION_APPLICATION_TYPE !== undefined);
assert(IDX_STATE_SESSION_NO_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_INTERNAL_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_MAX_DATAGRAM_SIZE !== undefined);
Expand DownExpand Up@@ -351,7 +349,6 @@ class QuicSessionState {
 static #LISTENER_SESSION_TICKET = 1 << 3;
 static #LISTENER_NEW_TOKEN = 1 << 4;
 static #LISTENER_ORIGIN = 1 << 5;
 static #LISTENER_APPLICATION = 1 << 6;

 #getListenerFlag(flag) {
 const handle = this.#handle;
Expand All@@ -370,13 +367,6 @@ class QuicSessionState {
 val ? (current | flag) : (current & ~flag), kIsLittleEndian);
 }

 /** @type {boolean} */
 get hasApplicationListener() {
 return this.#getListenerFlag(QuicSessionState.#LISTENER_APPLICATION);
 }
 set hasApplicationListener(val) {
 this.#setListenerFlag(QuicSessionState.#LISTENER_APPLICATION, val);
 }

 /** @type {boolean} */
 get hasPathValidationListener() {
Expand DownExpand Up@@ -475,22 +465,15 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_STREAM_OPEN_ALLOWED) !== 0;
 }

 /** @type {boolean} */
 get isPrioritySupported() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_PRIORITY_SUPPORTED) !== 0;
 }

 /**
 * Whether the negotiated application protocol supports headers.
 * Returns 0 (unknown), 1 (supported), or 2 (not supported).
 * @type {number}
 * Whether a protocol application (vs the native raw-stream path) is
 * installed on the session.
 * @type {boolean}
 */
 get headersSupported() {
 get hasApplication() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HEADERS_SUPPORTED);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HAS_APPLICATION) !== 0;
 }

 /** @type {boolean} */
Expand All@@ -500,17 +483,21 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_WRAPPED) !== 0;
 }

 /** @type {number} */
 get applicationType() {
 /**
 * True for server (accepted) sessions, false for client (initiated)
 * sessions. Fixed for the session's lifetime.
 * @type {boolean}
 */
 get isServer() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_APPLICATION_TYPE);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_IS_SERVER) !== 0;
 }

 /**
 * The negotiated application protocol's "no error" code, populated
 * by the C++ layer when the application is selected during ALPN
 * negotiation. For raw QUIC this is `0n`; for HTTP/3 this is
 * The installed application's "no error" code, populated
 * by the C++ layer when the application is installed.
 * For raw QUIC this is `0n`; for HTTP/3 this is
 * `0x100n` (`H3_NO_ERROR`).
 * @type {bigint}
 */
Expand All@@ -522,7 +509,7 @@ class QuicSessionState {
 }

 /**
 * The negotiated application protocol's "internal error" code,
 * The installed application's "internal error" code,
 * populated by the C++ layer when the application is selected
 * during ALPN negotiation. Used as the wire code for `RESET_STREAM`
 * frames when a stream is aborted without a more specific code.
Expand DownExpand Up@@ -590,10 +577,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -615,10 +601,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode: `${noErrorCode}`,
 internalErrorCode: `${internalErrorCode}`,
 maxDatagramSize: `${maxDatagramSize}`,
Expand DownExpand Up@@ -656,10 +641,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -681,10 +665,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand Down

14 changes: 0 additions & 14 deletions
lib/internal/quic/symbols.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,30 +35,23 @@ const kDatagram = Symbol('kDatagram');
const kDatagramStatus = Symbol('kDatagramStatus');
const kEarlyDataRejected = Symbol('kEarlyDataRejected');
const kFinishClose = Symbol('kFinishClose');
const kGoaway = Symbol('kGoaway');
const kHandshake = Symbol('kHandshake');
const kHandshakeCompleted = Symbol('kHandshakeCompleted');
const kVerifyPeer = Symbol('kVerifyPeer');
const kHeaders = Symbol('kHeaders');
const kKeylog = Symbol('kKeylog');
const kListen = Symbol('kListen');
const kQlog = Symbol('kQlog');
const kNewSession = Symbol('kNewSession');
const kNewStream = Symbol('kNewStream');
const kNewToken = Symbol('kNewToken');
const kStreamCallbacks = Symbol('kStreamCallbacks');
const kOrigin = Symbol('kOrigin');
const kOwner = Symbol('kOwner');
const kPathValidation = Symbol('kPathValidation');
const kPrivateConstructor = Symbol('kPrivateConstructor');
const kRemoveSession = Symbol('kRemoveSession');
const kRemoveStream = Symbol('kRemoveStream');
const kReset = Symbol('kReset');
const kSendHeaders = Symbol('kSendHeaders');
const kSessionApplication = Symbol('kSessionApplication');
const kSessionTicket = Symbol('kSessionTicket');
const kStopSending = Symbol('kStopSending');
const kTrailers = Symbol('kTrailers');
const kVersionNegotiation = Symbol('kVersionNegotiation');

module.exports = {
Expand All@@ -70,32 +63,25 @@ module.exports = {
 kDrain,
 kEarlyDataRejected,
 kFinishClose,
 kGoaway,
 kHandshake,
 kHandshakeCompleted,
 kVerifyPeer,
 kHeaders,
 kInspect,
 kKeylog,
 kKeyObjectHandle,
 kListen,
 kNewSession,
 kNewStream,
 kNewToken,
 kStreamCallbacks,
 kOrigin,
 kOwner,
 kQlog,
 kPathValidation,
 kPrivateConstructor,
 kRemoveSession,
 kRemoveStream,
 kReset,
 kSendHeaders,
 kSessionApplication,
 kSessionTicket,
 kStopSending,
 kTrailers,
 kVersionNegotiation,
};

Expand Down

11 changes: 11 additions & 0 deletions
lib/quic.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -20,6 +20,13 @@ const {
 DEFAULT_GROUPS,
} = require('internal/quic/quic');

const {
 connect: connectHttp3,
 listen: listenHttp3,
 Http3Session,
 Http3Stream,
} = require('internal/quic/http3');

const cc = {
 get RENO() { return CC_ALGO_RENO; },
 get CUBIC() { return CC_ALGO_CUBIC; },
Expand All@@ -35,7 +42,11 @@ const constants = {
module.exports = {
 connect,
 listen,
 connectHttp3,
 listenHttp3,
@jasnelljasnellAug 17, 2026

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.

Do we really need separate connect and listen variants for http3?
@pimterrypimterryAug 17, 2026

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.

Strictly speaking, no.
Those two APIs create a auto-H3 client/server with sensible H3 defaults that automatically wires up the h3 application. It's roughly the equivalent to the current auto-HTTP3 support. But with this PR you can now use new Http3Session(quicSession) to dynamically create an HTTP/3 session on top of QUIC instead, so a separate server/client API is no longer necessary.
It is mildly more fiddly this way: you have to manually create the H3 session every time, and we wouldn't offer a way to set up any HTTP/3 specific defaults (e.g. ALPN) for you. Given we now intend this only for low-level use cases that's fine though, it gives you more control en route anyway.
There is one practical limitation right now: you can't do server 0RTT with dynamic attach like this (because by the time session event fires on the server to attach, that's been partially processed already). That is fixable I think, it's just a separate step I was going to leave until later. I could investigate that further within this PR instead though, and then if there's a good solution then we could drop these with no practical downside.
 listEndpoints,
 Http3Session,
 Http3Stream,
 QuicEndpoint,
 QuicError,
 QuicSession,
Expand Down

3 changes: 2 additions & 1 deletion
src/node_builtins.cc

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -138,7 +138,8 @@ BuiltinLoader::BuiltinCategories BuiltinLoader::GetBuiltinCategories() const {
#endif // !HAVE_OPENSSL
#ifndef OPENSSL_NO_QUIC
 "internal/quic/quic", "internal/quic/symbols", "internal/quic/stats",
 "internal/quic/state",
 "internal/quic/state", "internal/quic/diagnostics",
 "internal/quic/http3",
#endif // !OPENSSL_NO_QUIC
#if HAVE_DTLS
 "internal/dtls/dtls", "internal/dtls/symbols", "internal/dtls/stats",
Expand Down
Loading
Loading

, '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
Split HTTP/3 module out from QUIC#63995

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

pimterry
wants to merge
11
commits into

base:main
Choose a base branch

from

 Open


Split HTTP/3 module out from QUIC
#63995
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


11 commits


Select commit
Hold shift + click to select a range
b9cffb3

quic: create standalone Http3Session APIs around QUIC


pimterry Jun 10, 2026
35691fa

quic: split out full http3 module with separate request() API


pimterry Jun 10, 2026
92f5d2c

quic: use 'kApplication' not ALPN to explicitly connect QUIC to H3


pimterry Jun 11, 2026
0efd303

quic: make Applications optional, with raw stream support in sessions


pimterry Jun 16, 2026
dd48939

quic: move HTTP/3 protocol machinery into node:http3


pimterry Jun 16, 2026
55450be

quic: bring in a related performance optimizations en route


pimterry Jun 12, 2026
58eae6b

quic: move HTTP/3 event emit logic into Http3Application


pimterry Jun 15, 2026
33e84b7

quic: use http3Binding to drop header & priority stream logic from QUIC


pimterry Jun 16, 2026
ec1dc6e

quic: add docs for http3 module, update quic docs & internal README


pimterry Jun 18, 2026
9d175ef

quic: move HTTP/3 APIs back inside node:quic


pimterry Aug 9, 2026
4882960

quic: resolve various small further issues & omissions in HTTP/3 API


pimterry Aug 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1,404 changes: 764 additions & 640 deletions
doc/api/quic.md

View file


Open in desktop


Large diffs are not rendered by default.


874 changes: 874 additions & 0 deletions
lib/internal/quic/http3.js

View file


Open in desktop


Large diffs are not rendered by default.


889 changes: 114 additions & 775 deletions
lib/internal/quic/quic.js

View file


Open in desktop


Large diffs are not rendered by default.


73 changes: 28 additions & 45 deletions
lib/internal/quic/state.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -70,10 +70,9 @@ const {
 IDX_STATE_SESSION_HANDSHAKE_COMPLETED,
 IDX_STATE_SESSION_HANDSHAKE_CONFIRMED,
 IDX_STATE_SESSION_STREAM_OPEN_ALLOWED,
 IDX_STATE_SESSION_PRIORITY_SUPPORTED,
 IDX_STATE_SESSION_HEADERS_SUPPORTED,
 IDX_STATE_SESSION_WRAPPED,
 IDX_STATE_SESSION_APPLICATION_TYPE,
 IDX_STATE_SESSION_IS_SERVER,
 IDX_STATE_SESSION_HAS_APPLICATION,
 IDX_STATE_SESSION_NO_ERROR_CODE,
 IDX_STATE_SESSION_INTERNAL_ERROR_CODE,
 IDX_STATE_SESSION_MAX_DATAGRAM_SIZE,
Expand DownExpand Up@@ -117,10 +116,9 @@ assert(IDX_STATE_SESSION_STATELESS_RESET !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_COMPLETED !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_CONFIRMED !== undefined);
assert(IDX_STATE_SESSION_STREAM_OPEN_ALLOWED !== undefined);
assert(IDX_STATE_SESSION_PRIORITY_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HEADERS_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HAS_APPLICATION !== undefined);
assert(IDX_STATE_SESSION_IS_SERVER !== undefined);
assert(IDX_STATE_SESSION_WRAPPED !== undefined);
assert(IDX_STATE_SESSION_APPLICATION_TYPE !== undefined);
assert(IDX_STATE_SESSION_NO_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_INTERNAL_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_MAX_DATAGRAM_SIZE !== undefined);
Expand DownExpand Up@@ -351,7 +349,6 @@ class QuicSessionState {
 static #LISTENER_SESSION_TICKET = 1 << 3;
 static #LISTENER_NEW_TOKEN = 1 << 4;
 static #LISTENER_ORIGIN = 1 << 5;
 static #LISTENER_APPLICATION = 1 << 6;

 #getListenerFlag(flag) {
 const handle = this.#handle;
Expand All@@ -370,13 +367,6 @@ class QuicSessionState {
 val ? (current | flag) : (current & ~flag), kIsLittleEndian);
 }

 /** @type {boolean} */
 get hasApplicationListener() {
 return this.#getListenerFlag(QuicSessionState.#LISTENER_APPLICATION);
 }
 set hasApplicationListener(val) {
 this.#setListenerFlag(QuicSessionState.#LISTENER_APPLICATION, val);
 }

 /** @type {boolean} */
 get hasPathValidationListener() {
Expand DownExpand Up@@ -475,22 +465,15 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_STREAM_OPEN_ALLOWED) !== 0;
 }

 /** @type {boolean} */
 get isPrioritySupported() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_PRIORITY_SUPPORTED) !== 0;
 }

 /**
 * Whether the negotiated application protocol supports headers.
 * Returns 0 (unknown), 1 (supported), or 2 (not supported).
 * @type {number}
 * Whether a protocol application (vs the native raw-stream path) is
 * installed on the session.
 * @type {boolean}
 */
 get headersSupported() {
 get hasApplication() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HEADERS_SUPPORTED);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HAS_APPLICATION) !== 0;
 }

 /** @type {boolean} */
Expand All@@ -500,17 +483,21 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_WRAPPED) !== 0;
 }

 /** @type {number} */
 get applicationType() {
 /**
 * True for server (accepted) sessions, false for client (initiated)
 * sessions. Fixed for the session's lifetime.
 * @type {boolean}
 */
 get isServer() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_APPLICATION_TYPE);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_IS_SERVER) !== 0;
 }

 /**
 * The negotiated application protocol's "no error" code, populated
 * by the C++ layer when the application is selected during ALPN
 * negotiation. For raw QUIC this is `0n`; for HTTP/3 this is
 * The installed application's "no error" code, populated
 * by the C++ layer when the application is installed.
 * For raw QUIC this is `0n`; for HTTP/3 this is
 * `0x100n` (`H3_NO_ERROR`).
 * @type {bigint}
 */
Expand All@@ -522,7 +509,7 @@ class QuicSessionState {
 }

 /**
 * The negotiated application protocol's "internal error" code,
 * The installed application's "internal error" code,
 * populated by the C++ layer when the application is selected
 * during ALPN negotiation. Used as the wire code for `RESET_STREAM`
 * frames when a stream is aborted without a more specific code.
Expand DownExpand Up@@ -590,10 +577,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -615,10 +601,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode: `${noErrorCode}`,
 internalErrorCode: `${internalErrorCode}`,
 maxDatagramSize: `${maxDatagramSize}`,
Expand DownExpand Up@@ -656,10 +641,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -681,10 +665,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand Down

14 changes: 0 additions & 14 deletions
lib/internal/quic/symbols.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,30 +35,23 @@ const kDatagram = Symbol('kDatagram');
const kDatagramStatus = Symbol('kDatagramStatus');
const kEarlyDataRejected = Symbol('kEarlyDataRejected');
const kFinishClose = Symbol('kFinishClose');
const kGoaway = Symbol('kGoaway');
const kHandshake = Symbol('kHandshake');
const kHandshakeCompleted = Symbol('kHandshakeCompleted');
const kVerifyPeer = Symbol('kVerifyPeer');
const kHeaders = Symbol('kHeaders');
const kKeylog = Symbol('kKeylog');
const kListen = Symbol('kListen');
const kQlog = Symbol('kQlog');
const kNewSession = Symbol('kNewSession');
const kNewStream = Symbol('kNewStream');
const kNewToken = Symbol('kNewToken');
const kStreamCallbacks = Symbol('kStreamCallbacks');
const kOrigin = Symbol('kOrigin');
const kOwner = Symbol('kOwner');
const kPathValidation = Symbol('kPathValidation');
const kPrivateConstructor = Symbol('kPrivateConstructor');
const kRemoveSession = Symbol('kRemoveSession');
const kRemoveStream = Symbol('kRemoveStream');
const kReset = Symbol('kReset');
const kSendHeaders = Symbol('kSendHeaders');
const kSessionApplication = Symbol('kSessionApplication');
const kSessionTicket = Symbol('kSessionTicket');
const kStopSending = Symbol('kStopSending');
const kTrailers = Symbol('kTrailers');
const kVersionNegotiation = Symbol('kVersionNegotiation');

module.exports = {
Expand All@@ -70,32 +63,25 @@ module.exports = {
 kDrain,
 kEarlyDataRejected,
 kFinishClose,
 kGoaway,
 kHandshake,
 kHandshakeCompleted,
 kVerifyPeer,
 kHeaders,
 kInspect,
 kKeylog,
 kKeyObjectHandle,
 kListen,
 kNewSession,
 kNewStream,
 kNewToken,
 kStreamCallbacks,
 kOrigin,
 kOwner,
 kQlog,
 kPathValidation,
 kPrivateConstructor,
 kRemoveSession,
 kRemoveStream,
 kReset,
 kSendHeaders,
 kSessionApplication,
 kSessionTicket,
 kStopSending,
 kTrailers,
 kVersionNegotiation,
};

Expand Down

11 changes: 11 additions & 0 deletions
lib/quic.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -20,6 +20,13 @@ const {
 DEFAULT_GROUPS,
} = require('internal/quic/quic');

const {
 connect: connectHttp3,
 listen: listenHttp3,
 Http3Session,
 Http3Stream,
} = require('internal/quic/http3');

const cc = {
 get RENO() { return CC_ALGO_RENO; },
 get CUBIC() { return CC_ALGO_CUBIC; },
Expand All@@ -35,7 +42,11 @@ const constants = {
module.exports = {
 connect,
 listen,
 connectHttp3,
 listenHttp3,
@jasnelljasnellAug 17, 2026

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.

Do we really need separate connect and listen variants for http3?
@pimterrypimterryAug 17, 2026

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.

Strictly speaking, no.
Those two APIs create a auto-H3 client/server with sensible H3 defaults that automatically wires up the h3 application. It's roughly the equivalent to the current auto-HTTP3 support. But with this PR you can now use new Http3Session(quicSession) to dynamically create an HTTP/3 session on top of QUIC instead, so a separate server/client API is no longer necessary.
It is mildly more fiddly this way: you have to manually create the H3 session every time, and we wouldn't offer a way to set up any HTTP/3 specific defaults (e.g. ALPN) for you. Given we now intend this only for low-level use cases that's fine though, it gives you more control en route anyway.
There is one practical limitation right now: you can't do server 0RTT with dynamic attach like this (because by the time session event fires on the server to attach, that's been partially processed already). That is fixable I think, it's just a separate step I was going to leave until later. I could investigate that further within this PR instead though, and then if there's a good solution then we could drop these with no practical downside.
 listEndpoints,
 Http3Session,
 Http3Stream,
 QuicEndpoint,
 QuicError,
 QuicSession,
Expand Down

3 changes: 2 additions & 1 deletion
src/node_builtins.cc

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -138,7 +138,8 @@ BuiltinLoader::BuiltinCategories BuiltinLoader::GetBuiltinCategories() const {
#endif // !HAVE_OPENSSL
#ifndef OPENSSL_NO_QUIC
 "internal/quic/quic", "internal/quic/symbols", "internal/quic/stats",
 "internal/quic/state",
 "internal/quic/state", "internal/quic/diagnostics",
 "internal/quic/http3",
#endif // !OPENSSL_NO_QUIC
#if HAVE_DTLS
 "internal/dtls/dtls", "internal/dtls/symbols", "internal/dtls/stats",
Expand Down
Loading
Loading

, '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
Split HTTP/3 module out from QUIC#63995

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

pimterry
wants to merge
11
commits into

base:main
Choose a base branch

from

 Open


Split HTTP/3 module out from QUIC
#63995
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


11 commits


Select commit
Hold shift + click to select a range
b9cffb3

quic: create standalone Http3Session APIs around QUIC


pimterry Jun 10, 2026
35691fa

quic: split out full http3 module with separate request() API


pimterry Jun 10, 2026
92f5d2c

quic: use 'kApplication' not ALPN to explicitly connect QUIC to H3


pimterry Jun 11, 2026
0efd303

quic: make Applications optional, with raw stream support in sessions


pimterry Jun 16, 2026
dd48939

quic: move HTTP/3 protocol machinery into node:http3


pimterry Jun 16, 2026
55450be

quic: bring in a related performance optimizations en route


pimterry Jun 12, 2026
58eae6b

quic: move HTTP/3 event emit logic into Http3Application


pimterry Jun 15, 2026
33e84b7

quic: use http3Binding to drop header & priority stream logic from QUIC


pimterry Jun 16, 2026
ec1dc6e

quic: add docs for http3 module, update quic docs & internal README


pimterry Jun 18, 2026
9d175ef

quic: move HTTP/3 APIs back inside node:quic


pimterry Aug 9, 2026
4882960

quic: resolve various small further issues & omissions in HTTP/3 API


pimterry Aug 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1,404 changes: 764 additions & 640 deletions
doc/api/quic.md

View file


Open in desktop


Large diffs are not rendered by default.


874 changes: 874 additions & 0 deletions
lib/internal/quic/http3.js

View file


Open in desktop


Large diffs are not rendered by default.


889 changes: 114 additions & 775 deletions
lib/internal/quic/quic.js

View file


Open in desktop


Large diffs are not rendered by default.


73 changes: 28 additions & 45 deletions
lib/internal/quic/state.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -70,10 +70,9 @@ const {
 IDX_STATE_SESSION_HANDSHAKE_COMPLETED,
 IDX_STATE_SESSION_HANDSHAKE_CONFIRMED,
 IDX_STATE_SESSION_STREAM_OPEN_ALLOWED,
 IDX_STATE_SESSION_PRIORITY_SUPPORTED,
 IDX_STATE_SESSION_HEADERS_SUPPORTED,
 IDX_STATE_SESSION_WRAPPED,
 IDX_STATE_SESSION_APPLICATION_TYPE,
 IDX_STATE_SESSION_IS_SERVER,
 IDX_STATE_SESSION_HAS_APPLICATION,
 IDX_STATE_SESSION_NO_ERROR_CODE,
 IDX_STATE_SESSION_INTERNAL_ERROR_CODE,
 IDX_STATE_SESSION_MAX_DATAGRAM_SIZE,
Expand DownExpand Up@@ -117,10 +116,9 @@ assert(IDX_STATE_SESSION_STATELESS_RESET !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_COMPLETED !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_CONFIRMED !== undefined);
assert(IDX_STATE_SESSION_STREAM_OPEN_ALLOWED !== undefined);
assert(IDX_STATE_SESSION_PRIORITY_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HEADERS_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HAS_APPLICATION !== undefined);
assert(IDX_STATE_SESSION_IS_SERVER !== undefined);
assert(IDX_STATE_SESSION_WRAPPED !== undefined);
assert(IDX_STATE_SESSION_APPLICATION_TYPE !== undefined);
assert(IDX_STATE_SESSION_NO_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_INTERNAL_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_MAX_DATAGRAM_SIZE !== undefined);
Expand DownExpand Up@@ -351,7 +349,6 @@ class QuicSessionState {
 static #LISTENER_SESSION_TICKET = 1 << 3;
 static #LISTENER_NEW_TOKEN = 1 << 4;
 static #LISTENER_ORIGIN = 1 << 5;
 static #LISTENER_APPLICATION = 1 << 6;

 #getListenerFlag(flag) {
 const handle = this.#handle;
Expand All@@ -370,13 +367,6 @@ class QuicSessionState {
 val ? (current | flag) : (current & ~flag), kIsLittleEndian);
 }

 /** @type {boolean} */
 get hasApplicationListener() {
 return this.#getListenerFlag(QuicSessionState.#LISTENER_APPLICATION);
 }
 set hasApplicationListener(val) {
 this.#setListenerFlag(QuicSessionState.#LISTENER_APPLICATION, val);
 }

 /** @type {boolean} */
 get hasPathValidationListener() {
Expand DownExpand Up@@ -475,22 +465,15 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_STREAM_OPEN_ALLOWED) !== 0;
 }

 /** @type {boolean} */
 get isPrioritySupported() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_PRIORITY_SUPPORTED) !== 0;
 }

 /**
 * Whether the negotiated application protocol supports headers.
 * Returns 0 (unknown), 1 (supported), or 2 (not supported).
 * @type {number}
 * Whether a protocol application (vs the native raw-stream path) is
 * installed on the session.
 * @type {boolean}
 */
 get headersSupported() {
 get hasApplication() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HEADERS_SUPPORTED);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HAS_APPLICATION) !== 0;
 }

 /** @type {boolean} */
Expand All@@ -500,17 +483,21 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_WRAPPED) !== 0;
 }

 /** @type {number} */
 get applicationType() {
 /**
 * True for server (accepted) sessions, false for client (initiated)
 * sessions. Fixed for the session's lifetime.
 * @type {boolean}
 */
 get isServer() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_APPLICATION_TYPE);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_IS_SERVER) !== 0;
 }

 /**
 * The negotiated application protocol's "no error" code, populated
 * by the C++ layer when the application is selected during ALPN
 * negotiation. For raw QUIC this is `0n`; for HTTP/3 this is
 * The installed application's "no error" code, populated
 * by the C++ layer when the application is installed.
 * For raw QUIC this is `0n`; for HTTP/3 this is
 * `0x100n` (`H3_NO_ERROR`).
 * @type {bigint}
 */
Expand All@@ -522,7 +509,7 @@ class QuicSessionState {
 }

 /**
 * The negotiated application protocol's "internal error" code,
 * The installed application's "internal error" code,
 * populated by the C++ layer when the application is selected
 * during ALPN negotiation. Used as the wire code for `RESET_STREAM`
 * frames when a stream is aborted without a more specific code.
Expand DownExpand Up@@ -590,10 +577,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -615,10 +601,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode: `${noErrorCode}`,
 internalErrorCode: `${internalErrorCode}`,
 maxDatagramSize: `${maxDatagramSize}`,
Expand DownExpand Up@@ -656,10 +641,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -681,10 +665,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand Down

14 changes: 0 additions & 14 deletions
lib/internal/quic/symbols.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,30 +35,23 @@ const kDatagram = Symbol('kDatagram');
const kDatagramStatus = Symbol('kDatagramStatus');
const kEarlyDataRejected = Symbol('kEarlyDataRejected');
const kFinishClose = Symbol('kFinishClose');
const kGoaway = Symbol('kGoaway');
const kHandshake = Symbol('kHandshake');
const kHandshakeCompleted = Symbol('kHandshakeCompleted');
const kVerifyPeer = Symbol('kVerifyPeer');
const kHeaders = Symbol('kHeaders');
const kKeylog = Symbol('kKeylog');
const kListen = Symbol('kListen');
const kQlog = Symbol('kQlog');
const kNewSession = Symbol('kNewSession');
const kNewStream = Symbol('kNewStream');
const kNewToken = Symbol('kNewToken');
const kStreamCallbacks = Symbol('kStreamCallbacks');
const kOrigin = Symbol('kOrigin');
const kOwner = Symbol('kOwner');
const kPathValidation = Symbol('kPathValidation');
const kPrivateConstructor = Symbol('kPrivateConstructor');
const kRemoveSession = Symbol('kRemoveSession');
const kRemoveStream = Symbol('kRemoveStream');
const kReset = Symbol('kReset');
const kSendHeaders = Symbol('kSendHeaders');
const kSessionApplication = Symbol('kSessionApplication');
const kSessionTicket = Symbol('kSessionTicket');
const kStopSending = Symbol('kStopSending');
const kTrailers = Symbol('kTrailers');
const kVersionNegotiation = Symbol('kVersionNegotiation');

module.exports = {
Expand All@@ -70,32 +63,25 @@ module.exports = {
 kDrain,
 kEarlyDataRejected,
 kFinishClose,
 kGoaway,
 kHandshake,
 kHandshakeCompleted,
 kVerifyPeer,
 kHeaders,
 kInspect,
 kKeylog,
 kKeyObjectHandle,
 kListen,
 kNewSession,
 kNewStream,
 kNewToken,
 kStreamCallbacks,
 kOrigin,
 kOwner,
 kQlog,
 kPathValidation,
 kPrivateConstructor,
 kRemoveSession,
 kRemoveStream,
 kReset,
 kSendHeaders,
 kSessionApplication,
 kSessionTicket,
 kStopSending,
 kTrailers,
 kVersionNegotiation,
};

Expand Down

11 changes: 11 additions & 0 deletions
lib/quic.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -20,6 +20,13 @@ const {
 DEFAULT_GROUPS,
} = require('internal/quic/quic');

const {
 connect: connectHttp3,
 listen: listenHttp3,
 Http3Session,
 Http3Stream,
} = require('internal/quic/http3');

const cc = {
 get RENO() { return CC_ALGO_RENO; },
 get CUBIC() { return CC_ALGO_CUBIC; },
Expand All@@ -35,7 +42,11 @@ const constants = {
module.exports = {
 connect,
 listen,
 connectHttp3,
 listenHttp3,
@jasnelljasnellAug 17, 2026

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.

Do we really need separate connect and listen variants for http3?
@pimterrypimterryAug 17, 2026

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.

Strictly speaking, no.
Those two APIs create a auto-H3 client/server with sensible H3 defaults that automatically wires up the h3 application. It's roughly the equivalent to the current auto-HTTP3 support. But with this PR you can now use new Http3Session(quicSession) to dynamically create an HTTP/3 session on top of QUIC instead, so a separate server/client API is no longer necessary.
It is mildly more fiddly this way: you have to manually create the H3 session every time, and we wouldn't offer a way to set up any HTTP/3 specific defaults (e.g. ALPN) for you. Given we now intend this only for low-level use cases that's fine though, it gives you more control en route anyway.
There is one practical limitation right now: you can't do server 0RTT with dynamic attach like this (because by the time session event fires on the server to attach, that's been partially processed already). That is fixable I think, it's just a separate step I was going to leave until later. I could investigate that further within this PR instead though, and then if there's a good solution then we could drop these with no practical downside.
 listEndpoints,
 Http3Session,
 Http3Stream,
 QuicEndpoint,
 QuicError,
 QuicSession,
Expand Down

3 changes: 2 additions & 1 deletion
src/node_builtins.cc

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -138,7 +138,8 @@ BuiltinLoader::BuiltinCategories BuiltinLoader::GetBuiltinCategories() const {
#endif // !HAVE_OPENSSL
#ifndef OPENSSL_NO_QUIC
 "internal/quic/quic", "internal/quic/symbols", "internal/quic/stats",
 "internal/quic/state",
 "internal/quic/state", "internal/quic/diagnostics",
 "internal/quic/http3",
#endif // !OPENSSL_NO_QUIC
#if HAVE_DTLS
 "internal/dtls/dtls", "internal/dtls/symbols", "internal/dtls/stats",
Expand Down
Loading
Loading

, '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
Split HTTP/3 module out from QUIC#63995

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

pimterry
wants to merge
11
commits into

base:main
Choose a base branch

from

 Open


Split HTTP/3 module out from QUIC
#63995
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


11 commits


Select commit
Hold shift + click to select a range
b9cffb3

quic: create standalone Http3Session APIs around QUIC


pimterry Jun 10, 2026
35691fa

quic: split out full http3 module with separate request() API


pimterry Jun 10, 2026
92f5d2c

quic: use 'kApplication' not ALPN to explicitly connect QUIC to H3


pimterry Jun 11, 2026
0efd303

quic: make Applications optional, with raw stream support in sessions


pimterry Jun 16, 2026
dd48939

quic: move HTTP/3 protocol machinery into node:http3


pimterry Jun 16, 2026
55450be

quic: bring in a related performance optimizations en route


pimterry Jun 12, 2026
58eae6b

quic: move HTTP/3 event emit logic into Http3Application


pimterry Jun 15, 2026
33e84b7

quic: use http3Binding to drop header & priority stream logic from QUIC


pimterry Jun 16, 2026
ec1dc6e

quic: add docs for http3 module, update quic docs & internal README


pimterry Jun 18, 2026
9d175ef

quic: move HTTP/3 APIs back inside node:quic


pimterry Aug 9, 2026
4882960

quic: resolve various small further issues & omissions in HTTP/3 API


pimterry Aug 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1,404 changes: 764 additions & 640 deletions
doc/api/quic.md

View file


Open in desktop


Large diffs are not rendered by default.


874 changes: 874 additions & 0 deletions
lib/internal/quic/http3.js

View file


Open in desktop


Large diffs are not rendered by default.


889 changes: 114 additions & 775 deletions
lib/internal/quic/quic.js

View file


Open in desktop


Large diffs are not rendered by default.


73 changes: 28 additions & 45 deletions
lib/internal/quic/state.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -70,10 +70,9 @@ const {
 IDX_STATE_SESSION_HANDSHAKE_COMPLETED,
 IDX_STATE_SESSION_HANDSHAKE_CONFIRMED,
 IDX_STATE_SESSION_STREAM_OPEN_ALLOWED,
 IDX_STATE_SESSION_PRIORITY_SUPPORTED,
 IDX_STATE_SESSION_HEADERS_SUPPORTED,
 IDX_STATE_SESSION_WRAPPED,
 IDX_STATE_SESSION_APPLICATION_TYPE,
 IDX_STATE_SESSION_IS_SERVER,
 IDX_STATE_SESSION_HAS_APPLICATION,
 IDX_STATE_SESSION_NO_ERROR_CODE,
 IDX_STATE_SESSION_INTERNAL_ERROR_CODE,
 IDX_STATE_SESSION_MAX_DATAGRAM_SIZE,
Expand DownExpand Up@@ -117,10 +116,9 @@ assert(IDX_STATE_SESSION_STATELESS_RESET !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_COMPLETED !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_CONFIRMED !== undefined);
assert(IDX_STATE_SESSION_STREAM_OPEN_ALLOWED !== undefined);
assert(IDX_STATE_SESSION_PRIORITY_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HEADERS_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HAS_APPLICATION !== undefined);
assert(IDX_STATE_SESSION_IS_SERVER !== undefined);
assert(IDX_STATE_SESSION_WRAPPED !== undefined);
assert(IDX_STATE_SESSION_APPLICATION_TYPE !== undefined);
assert(IDX_STATE_SESSION_NO_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_INTERNAL_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_MAX_DATAGRAM_SIZE !== undefined);
Expand DownExpand Up@@ -351,7 +349,6 @@ class QuicSessionState {
 static #LISTENER_SESSION_TICKET = 1 << 3;
 static #LISTENER_NEW_TOKEN = 1 << 4;
 static #LISTENER_ORIGIN = 1 << 5;
 static #LISTENER_APPLICATION = 1 << 6;

 #getListenerFlag(flag) {
 const handle = this.#handle;
Expand All@@ -370,13 +367,6 @@ class QuicSessionState {
 val ? (current | flag) : (current & ~flag), kIsLittleEndian);
 }

 /** @type {boolean} */
 get hasApplicationListener() {
 return this.#getListenerFlag(QuicSessionState.#LISTENER_APPLICATION);
 }
 set hasApplicationListener(val) {
 this.#setListenerFlag(QuicSessionState.#LISTENER_APPLICATION, val);
 }

 /** @type {boolean} */
 get hasPathValidationListener() {
Expand DownExpand Up@@ -475,22 +465,15 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_STREAM_OPEN_ALLOWED) !== 0;
 }

 /** @type {boolean} */
 get isPrioritySupported() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_PRIORITY_SUPPORTED) !== 0;
 }

 /**
 * Whether the negotiated application protocol supports headers.
 * Returns 0 (unknown), 1 (supported), or 2 (not supported).
 * @type {number}
 * Whether a protocol application (vs the native raw-stream path) is
 * installed on the session.
 * @type {boolean}
 */
 get headersSupported() {
 get hasApplication() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HEADERS_SUPPORTED);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HAS_APPLICATION) !== 0;
 }

 /** @type {boolean} */
Expand All@@ -500,17 +483,21 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_WRAPPED) !== 0;
 }

 /** @type {number} */
 get applicationType() {
 /**
 * True for server (accepted) sessions, false for client (initiated)
 * sessions. Fixed for the session's lifetime.
 * @type {boolean}
 */
 get isServer() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_APPLICATION_TYPE);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_IS_SERVER) !== 0;
 }

 /**
 * The negotiated application protocol's "no error" code, populated
 * by the C++ layer when the application is selected during ALPN
 * negotiation. For raw QUIC this is `0n`; for HTTP/3 this is
 * The installed application's "no error" code, populated
 * by the C++ layer when the application is installed.
 * For raw QUIC this is `0n`; for HTTP/3 this is
 * `0x100n` (`H3_NO_ERROR`).
 * @type {bigint}
 */
Expand All@@ -522,7 +509,7 @@ class QuicSessionState {
 }

 /**
 * The negotiated application protocol's "internal error" code,
 * The installed application's "internal error" code,
 * populated by the C++ layer when the application is selected
 * during ALPN negotiation. Used as the wire code for `RESET_STREAM`
 * frames when a stream is aborted without a more specific code.
Expand DownExpand Up@@ -590,10 +577,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -615,10 +601,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode: `${noErrorCode}`,
 internalErrorCode: `${internalErrorCode}`,
 maxDatagramSize: `${maxDatagramSize}`,
Expand DownExpand Up@@ -656,10 +641,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -681,10 +665,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand Down

14 changes: 0 additions & 14 deletions
lib/internal/quic/symbols.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,30 +35,23 @@ const kDatagram = Symbol('kDatagram');
const kDatagramStatus = Symbol('kDatagramStatus');
const kEarlyDataRejected = Symbol('kEarlyDataRejected');
const kFinishClose = Symbol('kFinishClose');
const kGoaway = Symbol('kGoaway');
const kHandshake = Symbol('kHandshake');
const kHandshakeCompleted = Symbol('kHandshakeCompleted');
const kVerifyPeer = Symbol('kVerifyPeer');
const kHeaders = Symbol('kHeaders');
const kKeylog = Symbol('kKeylog');
const kListen = Symbol('kListen');
const kQlog = Symbol('kQlog');
const kNewSession = Symbol('kNewSession');
const kNewStream = Symbol('kNewStream');
const kNewToken = Symbol('kNewToken');
const kStreamCallbacks = Symbol('kStreamCallbacks');
const kOrigin = Symbol('kOrigin');
const kOwner = Symbol('kOwner');
const kPathValidation = Symbol('kPathValidation');
const kPrivateConstructor = Symbol('kPrivateConstructor');
const kRemoveSession = Symbol('kRemoveSession');
const kRemoveStream = Symbol('kRemoveStream');
const kReset = Symbol('kReset');
const kSendHeaders = Symbol('kSendHeaders');
const kSessionApplication = Symbol('kSessionApplication');
const kSessionTicket = Symbol('kSessionTicket');
const kStopSending = Symbol('kStopSending');
const kTrailers = Symbol('kTrailers');
const kVersionNegotiation = Symbol('kVersionNegotiation');

module.exports = {
Expand All@@ -70,32 +63,25 @@ module.exports = {
 kDrain,
 kEarlyDataRejected,
 kFinishClose,
 kGoaway,
 kHandshake,
 kHandshakeCompleted,
 kVerifyPeer,
 kHeaders,
 kInspect,
 kKeylog,
 kKeyObjectHandle,
 kListen,
 kNewSession,
 kNewStream,
 kNewToken,
 kStreamCallbacks,
 kOrigin,
 kOwner,
 kQlog,
 kPathValidation,
 kPrivateConstructor,
 kRemoveSession,
 kRemoveStream,
 kReset,
 kSendHeaders,
 kSessionApplication,
 kSessionTicket,
 kStopSending,
 kTrailers,
 kVersionNegotiation,
};

Expand Down

11 changes: 11 additions & 0 deletions
lib/quic.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -20,6 +20,13 @@ const {
 DEFAULT_GROUPS,
} = require('internal/quic/quic');

const {
 connect: connectHttp3,
 listen: listenHttp3,
 Http3Session,
 Http3Stream,
} = require('internal/quic/http3');

const cc = {
 get RENO() { return CC_ALGO_RENO; },
 get CUBIC() { return CC_ALGO_CUBIC; },
Expand All@@ -35,7 +42,11 @@ const constants = {
module.exports = {
 connect,
 listen,
 connectHttp3,
 listenHttp3,
@jasnelljasnellAug 17, 2026

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.

Do we really need separate connect and listen variants for http3?
@pimterrypimterryAug 17, 2026

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.

Strictly speaking, no.
Those two APIs create a auto-H3 client/server with sensible H3 defaults that automatically wires up the h3 application. It's roughly the equivalent to the current auto-HTTP3 support. But with this PR you can now use new Http3Session(quicSession) to dynamically create an HTTP/3 session on top of QUIC instead, so a separate server/client API is no longer necessary.
It is mildly more fiddly this way: you have to manually create the H3 session every time, and we wouldn't offer a way to set up any HTTP/3 specific defaults (e.g. ALPN) for you. Given we now intend this only for low-level use cases that's fine though, it gives you more control en route anyway.
There is one practical limitation right now: you can't do server 0RTT with dynamic attach like this (because by the time session event fires on the server to attach, that's been partially processed already). That is fixable I think, it's just a separate step I was going to leave until later. I could investigate that further within this PR instead though, and then if there's a good solution then we could drop these with no practical downside.
 listEndpoints,
 Http3Session,
 Http3Stream,
 QuicEndpoint,
 QuicError,
 QuicSession,
Expand Down

3 changes: 2 additions & 1 deletion
src/node_builtins.cc

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -138,7 +138,8 @@ BuiltinLoader::BuiltinCategories BuiltinLoader::GetBuiltinCategories() const {
#endif // !HAVE_OPENSSL
#ifndef OPENSSL_NO_QUIC
 "internal/quic/quic", "internal/quic/symbols", "internal/quic/stats",
 "internal/quic/state",
 "internal/quic/state", "internal/quic/diagnostics",
 "internal/quic/http3",
#endif // !OPENSSL_NO_QUIC
#if HAVE_DTLS
 "internal/dtls/dtls", "internal/dtls/symbols", "internal/dtls/stats",
Expand Down
Loading
Loading

, '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
Split HTTP/3 module out from QUIC#63995

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

 Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and
privacy statement. We’ll occasionally send you account related emails.

Already on GitHub?
Sign in
to your account

 Open

pimterry
wants to merge
11
commits into

base:main
Choose a base branch

from

 Open


Split HTTP/3 module out from QUIC
#63995
Show file tree
Hide file tree
 Changes from all commits
Commits

Show all changes


11 commits


Select commit
Hold shift + click to select a range
b9cffb3

quic: create standalone Http3Session APIs around QUIC


pimterry Jun 10, 2026
35691fa

quic: split out full http3 module with separate request() API


pimterry Jun 10, 2026
92f5d2c

quic: use 'kApplication' not ALPN to explicitly connect QUIC to H3


pimterry Jun 11, 2026
0efd303

quic: make Applications optional, with raw stream support in sessions


pimterry Jun 16, 2026
dd48939

quic: move HTTP/3 protocol machinery into node:http3


pimterry Jun 16, 2026
55450be

quic: bring in a related performance optimizations en route


pimterry Jun 12, 2026
58eae6b

quic: move HTTP/3 event emit logic into Http3Application


pimterry Jun 15, 2026
33e84b7

quic: use http3Binding to drop header & priority stream logic from QUIC


pimterry Jun 16, 2026
ec1dc6e

quic: add docs for http3 module, update quic docs & internal README


pimterry Jun 18, 2026
9d175ef

quic: move HTTP/3 APIs back inside node:quic


pimterry Aug 9, 2026
4882960

quic: resolve various small further issues & omissions in HTTP/3 API


pimterry Aug 10, 2026

File filter

Filter by extension
Filter by extension
Conversations

Failed to load comments. 
Loading
Jump to

Jump to file


Failed to load files. 
Loading
 Diff view

 Diff view


1,404 changes: 764 additions & 640 deletions
doc/api/quic.md

View file


Open in desktop


Large diffs are not rendered by default.


874 changes: 874 additions & 0 deletions
lib/internal/quic/http3.js

View file


Open in desktop


Large diffs are not rendered by default.


889 changes: 114 additions & 775 deletions
lib/internal/quic/quic.js

View file


Open in desktop


Large diffs are not rendered by default.


73 changes: 28 additions & 45 deletions
lib/internal/quic/state.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -70,10 +70,9 @@ const {
 IDX_STATE_SESSION_HANDSHAKE_COMPLETED,
 IDX_STATE_SESSION_HANDSHAKE_CONFIRMED,
 IDX_STATE_SESSION_STREAM_OPEN_ALLOWED,
 IDX_STATE_SESSION_PRIORITY_SUPPORTED,
 IDX_STATE_SESSION_HEADERS_SUPPORTED,
 IDX_STATE_SESSION_WRAPPED,
 IDX_STATE_SESSION_APPLICATION_TYPE,
 IDX_STATE_SESSION_IS_SERVER,
 IDX_STATE_SESSION_HAS_APPLICATION,
 IDX_STATE_SESSION_NO_ERROR_CODE,
 IDX_STATE_SESSION_INTERNAL_ERROR_CODE,
 IDX_STATE_SESSION_MAX_DATAGRAM_SIZE,
Expand DownExpand Up@@ -117,10 +116,9 @@ assert(IDX_STATE_SESSION_STATELESS_RESET !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_COMPLETED !== undefined);
assert(IDX_STATE_SESSION_HANDSHAKE_CONFIRMED !== undefined);
assert(IDX_STATE_SESSION_STREAM_OPEN_ALLOWED !== undefined);
assert(IDX_STATE_SESSION_PRIORITY_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HEADERS_SUPPORTED !== undefined);
assert(IDX_STATE_SESSION_HAS_APPLICATION !== undefined);
assert(IDX_STATE_SESSION_IS_SERVER !== undefined);
assert(IDX_STATE_SESSION_WRAPPED !== undefined);
assert(IDX_STATE_SESSION_APPLICATION_TYPE !== undefined);
assert(IDX_STATE_SESSION_NO_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_INTERNAL_ERROR_CODE !== undefined);
assert(IDX_STATE_SESSION_MAX_DATAGRAM_SIZE !== undefined);
Expand DownExpand Up@@ -351,7 +349,6 @@ class QuicSessionState {
 static #LISTENER_SESSION_TICKET = 1 << 3;
 static #LISTENER_NEW_TOKEN = 1 << 4;
 static #LISTENER_ORIGIN = 1 << 5;
 static #LISTENER_APPLICATION = 1 << 6;

 #getListenerFlag(flag) {
 const handle = this.#handle;
Expand All@@ -370,13 +367,6 @@ class QuicSessionState {
 val ? (current | flag) : (current & ~flag), kIsLittleEndian);
 }

 /** @type {boolean} */
 get hasApplicationListener() {
 return this.#getListenerFlag(QuicSessionState.#LISTENER_APPLICATION);
 }
 set hasApplicationListener(val) {
 this.#setListenerFlag(QuicSessionState.#LISTENER_APPLICATION, val);
 }

 /** @type {boolean} */
 get hasPathValidationListener() {
Expand DownExpand Up@@ -475,22 +465,15 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_STREAM_OPEN_ALLOWED) !== 0;
 }

 /** @type {boolean} */
 get isPrioritySupported() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_PRIORITY_SUPPORTED) !== 0;
 }

 /**
 * Whether the negotiated application protocol supports headers.
 * Returns 0 (unknown), 1 (supported), or 2 (not supported).
 * @type {number}
 * Whether a protocol application (vs the native raw-stream path) is
 * installed on the session.
 * @type {boolean}
 */
 get headersSupported() {
 get hasApplication() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HEADERS_SUPPORTED);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_HAS_APPLICATION) !== 0;
 }

 /** @type {boolean} */
Expand All@@ -500,17 +483,21 @@ class QuicSessionState {
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_WRAPPED) !== 0;
 }

 /** @type {number} */
 get applicationType() {
 /**
 * True for server (accepted) sessions, false for client (initiated)
 * sessions. Fixed for the session's lifetime.
 * @type {boolean}
 */
 get isServer() {
 const handle = this.#handle;
 if (handle === undefined) return undefined;
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_APPLICATION_TYPE);
 return DataViewPrototypeGetUint8(handle, this.#offset + IDX_STATE_SESSION_IS_SERVER) !== 0;
 }

 /**
 * The negotiated application protocol's "no error" code, populated
 * by the C++ layer when the application is selected during ALPN
 * negotiation. For raw QUIC this is `0n`; for HTTP/3 this is
 * The installed application's "no error" code, populated
 * by the C++ layer when the application is installed.
 * For raw QUIC this is `0n`; for HTTP/3 this is
 * `0x100n` (`H3_NO_ERROR`).
 * @type {bigint}
 */
Expand All@@ -522,7 +509,7 @@ class QuicSessionState {
 }

 /**
 * The negotiated application protocol's "internal error" code,
 * The installed application's "internal error" code,
 * populated by the C++ layer when the application is selected
 * during ALPN negotiation. Used as the wire code for `RESET_STREAM`
 * frames when a stream is aborted without a more specific code.
Expand DownExpand Up@@ -590,10 +577,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -615,10 +601,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode: `${noErrorCode}`,
 internalErrorCode: `${internalErrorCode}`,
 maxDatagramSize: `${maxDatagramSize}`,
Expand DownExpand Up@@ -656,10 +641,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand All@@ -681,10 +665,9 @@ class QuicSessionState {
 isHandshakeCompleted,
 isHandshakeConfirmed,
 isStreamOpenAllowed,
 isPrioritySupported,
 headersSupported,
 hasApplication,
 isWrapped,
applicationType,
isServer,
 noErrorCode,
 internalErrorCode,
 maxDatagramSize,
Expand Down

14 changes: 0 additions & 14 deletions
lib/internal/quic/symbols.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -35,30 +35,23 @@ const kDatagram = Symbol('kDatagram');
const kDatagramStatus = Symbol('kDatagramStatus');
const kEarlyDataRejected = Symbol('kEarlyDataRejected');
const kFinishClose = Symbol('kFinishClose');
const kGoaway = Symbol('kGoaway');
const kHandshake = Symbol('kHandshake');
const kHandshakeCompleted = Symbol('kHandshakeCompleted');
const kVerifyPeer = Symbol('kVerifyPeer');
const kHeaders = Symbol('kHeaders');
const kKeylog = Symbol('kKeylog');
const kListen = Symbol('kListen');
const kQlog = Symbol('kQlog');
const kNewSession = Symbol('kNewSession');
const kNewStream = Symbol('kNewStream');
const kNewToken = Symbol('kNewToken');
const kStreamCallbacks = Symbol('kStreamCallbacks');
const kOrigin = Symbol('kOrigin');
const kOwner = Symbol('kOwner');
const kPathValidation = Symbol('kPathValidation');
const kPrivateConstructor = Symbol('kPrivateConstructor');
const kRemoveSession = Symbol('kRemoveSession');
const kRemoveStream = Symbol('kRemoveStream');
const kReset = Symbol('kReset');
const kSendHeaders = Symbol('kSendHeaders');
const kSessionApplication = Symbol('kSessionApplication');
const kSessionTicket = Symbol('kSessionTicket');
const kStopSending = Symbol('kStopSending');
const kTrailers = Symbol('kTrailers');
const kVersionNegotiation = Symbol('kVersionNegotiation');

module.exports = {
Expand All@@ -70,32 +63,25 @@ module.exports = {
 kDrain,
 kEarlyDataRejected,
 kFinishClose,
 kGoaway,
 kHandshake,
 kHandshakeCompleted,
 kVerifyPeer,
 kHeaders,
 kInspect,
 kKeylog,
 kKeyObjectHandle,
 kListen,
 kNewSession,
 kNewStream,
 kNewToken,
 kStreamCallbacks,
 kOrigin,
 kOwner,
 kQlog,
 kPathValidation,
 kPrivateConstructor,
 kRemoveSession,
 kRemoveStream,
 kReset,
 kSendHeaders,
 kSessionApplication,
 kSessionTicket,
 kStopSending,
 kTrailers,
 kVersionNegotiation,
};

Expand Down

11 changes: 11 additions & 0 deletions
lib/quic.js

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -20,6 +20,13 @@ const {
 DEFAULT_GROUPS,
} = require('internal/quic/quic');

const {
 connect: connectHttp3,
 listen: listenHttp3,
 Http3Session,
 Http3Stream,
} = require('internal/quic/http3');

const cc = {
 get RENO() { return CC_ALGO_RENO; },
 get CUBIC() { return CC_ALGO_CUBIC; },
Expand All@@ -35,7 +42,11 @@ const constants = {
module.exports = {
 connect,
 listen,
 connectHttp3,
 listenHttp3,
@jasnelljasnellAug 17, 2026

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.

Do we really need separate connect and listen variants for http3?
@pimterrypimterryAug 17, 2026

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.

Strictly speaking, no.
Those two APIs create a auto-H3 client/server with sensible H3 defaults that automatically wires up the h3 application. It's roughly the equivalent to the current auto-HTTP3 support. But with this PR you can now use new Http3Session(quicSession) to dynamically create an HTTP/3 session on top of QUIC instead, so a separate server/client API is no longer necessary.
It is mildly more fiddly this way: you have to manually create the H3 session every time, and we wouldn't offer a way to set up any HTTP/3 specific defaults (e.g. ALPN) for you. Given we now intend this only for low-level use cases that's fine though, it gives you more control en route anyway.
There is one practical limitation right now: you can't do server 0RTT with dynamic attach like this (because by the time session event fires on the server to attach, that's been partially processed already). That is fixable I think, it's just a separate step I was going to leave until later. I could investigate that further within this PR instead though, and then if there's a good solution then we could drop these with no practical downside.
 listEndpoints,
 Http3Session,
 Http3Stream,
 QuicEndpoint,
 QuicError,
 QuicSession,
Expand Down

3 changes: 2 additions & 1 deletion
src/node_builtins.cc

View file


Open in desktop

Original file line numberDiff line numberDiff line change
Expand Up@@ -138,7 +138,8 @@ BuiltinLoader::BuiltinCategories BuiltinLoader::GetBuiltinCategories() const {
#endif // !HAVE_OPENSSL
#ifndef OPENSSL_NO_QUIC
 "internal/quic/quic", "internal/quic/symbols", "internal/quic/stats",
 "internal/quic/state",
 "internal/quic/state", "internal/quic/diagnostics",
 "internal/quic/http3",
#endif // !OPENSSL_NO_QUIC
#if HAVE_DTLS
 "internal/dtls/dtls", "internal/dtls/symbols", "internal/dtls/stats",
Expand Down
Loading
Loading