quic: convert incoming :status header to number

doc/api/quic.md

@@ -3990,8 +3990,9 @@ A few things to note:
  the request is `HEADERS` followed by `END_STREAM`.
 * The `onheaders` callback receives the response pseudo-headers and
  regular headers in a single object with lowercase string keys.
- After the callback returns, the same object is also accessible
- via [`stream.headers`][].
+ For incoming headers, the `:status` pseudo-header is converted to
+ a `number`, matching HTTP/2 behavior. After the callback returns,
+ the same object is also accessible via [`stream.headers`][].
 * Reading `for await (const chunks of stream)` consumes the response
  body. Each iteration yields a `Uint8Array[]` batch of chunks.
 * HTTP semantic helpers (URL parsing, method/status validation,

lib/internal/quic/quic.js

@@ -1285,14 +1285,19 @@ function parseHeaderPairs(pairs) {
  assert(pairs.length % 2 === 0);
  const block = { __proto__: null };
  for (let n = 0; n + 1 < pairs.length; n += 2) {
- if (block[pairs[n]] !== undefined) {
- if (ArrayIsArray(block[pairs[n]])) {
- ArrayPrototypePush(block[pairs[n]], pairs[n + 1]);
+ const name = pairs[n];
+ let value = pairs[n + 1];
+ // Match HTTP/2 behavior: incoming :status is exposed as a number.
+ if (name === ':status')
+ value |= 0;
+ if (block[name] !== undefined) {
+ if (ArrayIsArray(block[name])) {
+ ArrayPrototypePush(block[name], value);
  } else {
- block[pairs[n]] = [block[pairs[n]], pairs[n + 1]];
+ block[name] = [block[name], value];
  }
  } else {
- block[pairs[n]] = pairs[n + 1];
+ block[name] = value;
  }
  }
  return block;

test/parallel/test-quic-h3-callback-errors.mjs

@@ -151,7 +151,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  ontrailers: mustCall(function() {
  throw new Error('ontrailers sync error');
@@ -265,7 +265,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-close-behavior.mjs

@@ -62,7 +62,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -74,7 +74,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-concurrent-requests.mjs

@@ -72,7 +72,7 @@ const requests = paths.map(mustCall(async (path) => {
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  headersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-datagram.mjs

@@ -87,7 +87,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -151,7 +151,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-error-codes.mjs

@@ -55,7 +55,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -106,7 +106,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-goaway.mjs

@@ -78,7 +78,7 @@ dc.subscribe('quic.session.goaway', mustCall((msg) => {
  await clientSession.opened;
 
  const onClientHeaders = mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  if (++clientHeaderCount === 2) {
  bothHeadersReceived.resolve();
  }

test/parallel/test-quic-h3-header-validation.mjs

@@ -91,7 +91,7 @@ const decoder = new TextDecoder();
  },
  onheaders: mustCall(function(headers) {
  // Client should also receive lowercased response header names.
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/html');
  assert.strictEqual(headers['x-response-header'], 'ResponseValue');
 
@@ -148,7 +148,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '204');
+ assert.strictEqual(headers[':status'], 204);
  }),
  });
 

test/parallel/test-quic-h3-informational-headers.mjs

@@ -34,7 +34,7 @@ dc.subscribe('quic.stream.info', mustCall((msg) => {
  assert.ok(msg.stream, 'stream.info should include stream');
  assert.ok(msg.session, 'stream.info should include session');
  assert.ok(msg.headers, 'stream.info should include headers');
- assert.strictEqual(msg.headers[':status'], '103');
+ assert.strictEqual(msg.headers[':status'], 103);
 }));
 
 // quic.stream.headers also fires for the final response headers.
@@ -89,12 +89,12 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  oninfo: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '103');
+ assert.strictEqual(headers[':status'], 103);
  assert.strictEqual(headers.link, '</style.css>; rel=preload; as=style');
  clientInfoReceived.resolve();
  }),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -107,7 +107,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the final (initial) headers, not 1xx.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-origin.mjs

@@ -77,7 +77,7 @@ const decoder = new TextDecoder();
  ':authority': 'example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -173,7 +173,7 @@ const decoder = new TextDecoder();
  ':authority': 'custom-port.example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-pending-stream.mjs

@@ -64,7 +64,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-post-filehandle.mjs

@@ -76,7 +76,7 @@ writeFileSync(testFile, testContent);
  },
  body: fh,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-post-request.mjs

@@ -84,7 +84,7 @@ const stream = await clientSession.createBidirectionalStream({
  },
  body: encoder.encode(requestBody),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
 });

test/parallel/test-quic-h3-priority.mjs

@@ -67,7 +67,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: false,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -85,7 +85,7 @@ const decoder = new TextDecoder();
  priority: 'low',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream2.priority, { level: 'low', incremental: true });
@@ -99,7 +99,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream3.priority, { level: 'default', incremental: false });
@@ -113,7 +113,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  // Default priority initially.
@@ -215,7 +215,7 @@ const decoder = new TextDecoder();
  },
  body: encoder.encode('signal'),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream.priority, { level: 'default', incremental: false });

test/parallel/test-quic-h3-qpack-settings.mjs

@@ -35,7 +35,7 @@ async function makeRequest(clientSession, path) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  const body = await bytes(stream);

test/parallel/test-quic-h3-request-response.mjs

@@ -93,7 +93,7 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -106,7 +106,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the buffered response headers.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-settings.mjs

@@ -71,7 +71,7 @@ const decoder = new TextDecoder();
  'x-second': 'two',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -129,7 +129,7 @@ const decoder = new TextDecoder();
  'x-long': longValue,
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -185,7 +185,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-status-code-type.mjs

@@ -0,0 +1,64 @@
+// Flags: --experimental-quic --experimental-stream-iter --no-warnings
+
+// Verify incoming :status is exposed as a number, matching HTTP/2 behavior.
+// See https://github.com/nodejs/node/issues/63557
+
+import { hasQuic, skip, mustCall } from '../common/index.mjs';
+import assert from 'node:assert';
+import * as fixtures from '../common/fixtures.mjs';
+
+if (!hasQuic) {
+ skip('QUIC is not enabled');
+}
+
+const { listen, connect } = await import('node:quic');
+const { createPrivateKey } = await import('node:crypto');
+
+const key = createPrivateKey(fixtures.readKey('agent1-key.pem'));
+const cert = fixtures.readKey('agent1-cert.pem');
+
+const codes = [200, 204, 404];
+let serverResponses = 0;
+const serverDone = Promise.withResolvers();
+
+const serverEndpoint = await listen(mustCall(async (ss) => {
+ ss.onstream = mustCall(() => {
+ if (++serverResponses === codes.length) {
+ ss.close();
+ serverDone.resolve();
+ }
+ }, codes.length);
+}), {
+ sni: { '*': { keys: [key], certs: [cert] } },
+ onheaders: mustCall(function() {
+ const status = codes[serverResponses - 1];
+ this.sendHeaders({ ':status': String(status) }, { terminal: true });
+ this.writer.endSync();
+ }, codes.length),
+});
+
+const clientSession = await connect(serverEndpoint.address, {
+ servername: 'localhost',
+ verifyPeer: 'manual',
+});
+await clientSession.opened;
+
+for (const expected of codes) {
+ const stream = await clientSession.createBidirectionalStream({
+ headers: {
+ ':method': 'GET',
+ ':path': '/',
+ ':scheme': 'https',
+ ':authority': 'localhost',
+ },
+ onheaders: mustCall(function(headers) {
+ assert.strictEqual(typeof headers[':status'], 'number');
+ assert.strictEqual(headers[':status'], expected);
+ }),
+ });
+ await stream.closed;
+}
+
+await serverDone.promise;
+await clientSession.close();
+await serverEndpoint.close();

doc/api/quic.md

@@ -3990,8 +3990,9 @@ A few things to note:
  the request is `HEADERS` followed by `END_STREAM`.
 * The `onheaders` callback receives the response pseudo-headers and
  regular headers in a single object with lowercase string keys.
- After the callback returns, the same object is also accessible
- via [`stream.headers`][].
+ For incoming headers, the `:status` pseudo-header is converted to
+ a `number`, matching HTTP/2 behavior. After the callback returns,
+ the same object is also accessible via [`stream.headers`][].
 * Reading `for await (const chunks of stream)` consumes the response
  body. Each iteration yields a `Uint8Array[]` batch of chunks.
 * HTTP semantic helpers (URL parsing, method/status validation,

lib/internal/quic/quic.js

@@ -1285,14 +1285,19 @@ function parseHeaderPairs(pairs) {
  assert(pairs.length % 2 === 0);
  const block = { __proto__: null };
  for (let n = 0; n + 1 < pairs.length; n += 2) {
- if (block[pairs[n]] !== undefined) {
- if (ArrayIsArray(block[pairs[n]])) {
- ArrayPrototypePush(block[pairs[n]], pairs[n + 1]);
+ const name = pairs[n];
+ let value = pairs[n + 1];
+ // Match HTTP/2 behavior: incoming :status is exposed as a number.
+ if (name === ':status')
+ value |= 0;
+ if (block[name] !== undefined) {
+ if (ArrayIsArray(block[name])) {
+ ArrayPrototypePush(block[name], value);
  } else {
- block[pairs[n]] = [block[pairs[n]], pairs[n + 1]];
+ block[name] = [block[name], value];
  }
  } else {
- block[pairs[n]] = pairs[n + 1];
+ block[name] = value;
  }
  }
  return block;

test/parallel/test-quic-h3-callback-errors.mjs

@@ -151,7 +151,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  ontrailers: mustCall(function() {
  throw new Error('ontrailers sync error');
@@ -265,7 +265,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-close-behavior.mjs

@@ -62,7 +62,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -74,7 +74,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-concurrent-requests.mjs

@@ -72,7 +72,7 @@ const requests = paths.map(mustCall(async (path) => {
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  headersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-datagram.mjs

@@ -87,7 +87,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -151,7 +151,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-error-codes.mjs

@@ -55,7 +55,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -106,7 +106,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-goaway.mjs

@@ -78,7 +78,7 @@ dc.subscribe('quic.session.goaway', mustCall((msg) => {
  await clientSession.opened;
 
  const onClientHeaders = mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  if (++clientHeaderCount === 2) {
  bothHeadersReceived.resolve();
  }

test/parallel/test-quic-h3-header-validation.mjs

@@ -91,7 +91,7 @@ const decoder = new TextDecoder();
  },
  onheaders: mustCall(function(headers) {
  // Client should also receive lowercased response header names.
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/html');
  assert.strictEqual(headers['x-response-header'], 'ResponseValue');
 
@@ -148,7 +148,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '204');
+ assert.strictEqual(headers[':status'], 204);
  }),
  });
 

test/parallel/test-quic-h3-informational-headers.mjs

@@ -34,7 +34,7 @@ dc.subscribe('quic.stream.info', mustCall((msg) => {
  assert.ok(msg.stream, 'stream.info should include stream');
  assert.ok(msg.session, 'stream.info should include session');
  assert.ok(msg.headers, 'stream.info should include headers');
- assert.strictEqual(msg.headers[':status'], '103');
+ assert.strictEqual(msg.headers[':status'], 103);
 }));
 
 // quic.stream.headers also fires for the final response headers.
@@ -89,12 +89,12 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  oninfo: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '103');
+ assert.strictEqual(headers[':status'], 103);
  assert.strictEqual(headers.link, '</style.css>; rel=preload; as=style');
  clientInfoReceived.resolve();
  }),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -107,7 +107,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the final (initial) headers, not 1xx.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-origin.mjs

@@ -77,7 +77,7 @@ const decoder = new TextDecoder();
  ':authority': 'example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -173,7 +173,7 @@ const decoder = new TextDecoder();
  ':authority': 'custom-port.example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-pending-stream.mjs

@@ -64,7 +64,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-post-filehandle.mjs

@@ -76,7 +76,7 @@ writeFileSync(testFile, testContent);
  },
  body: fh,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-post-request.mjs

@@ -84,7 +84,7 @@ const stream = await clientSession.createBidirectionalStream({
  },
  body: encoder.encode(requestBody),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
 });

test/parallel/test-quic-h3-priority.mjs

@@ -67,7 +67,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: false,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -85,7 +85,7 @@ const decoder = new TextDecoder();
  priority: 'low',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream2.priority, { level: 'low', incremental: true });
@@ -99,7 +99,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream3.priority, { level: 'default', incremental: false });
@@ -113,7 +113,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  // Default priority initially.
@@ -215,7 +215,7 @@ const decoder = new TextDecoder();
  },
  body: encoder.encode('signal'),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream.priority, { level: 'default', incremental: false });

test/parallel/test-quic-h3-qpack-settings.mjs

@@ -35,7 +35,7 @@ async function makeRequest(clientSession, path) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  const body = await bytes(stream);

test/parallel/test-quic-h3-request-response.mjs

@@ -93,7 +93,7 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -106,7 +106,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the buffered response headers.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-settings.mjs

@@ -71,7 +71,7 @@ const decoder = new TextDecoder();
  'x-second': 'two',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -129,7 +129,7 @@ const decoder = new TextDecoder();
  'x-long': longValue,
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -185,7 +185,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-status-code-type.mjs

@@ -0,0 +1,64 @@
+// Flags: --experimental-quic --experimental-stream-iter --no-warnings
+
+// Verify incoming :status is exposed as a number, matching HTTP/2 behavior.
+// See https://github.com/nodejs/node/issues/63557
+
+import { hasQuic, skip, mustCall } from '../common/index.mjs';
+import assert from 'node:assert';
+import * as fixtures from '../common/fixtures.mjs';
+
+if (!hasQuic) {
+ skip('QUIC is not enabled');
+}
+
+const { listen, connect } = await import('node:quic');
+const { createPrivateKey } = await import('node:crypto');
+
+const key = createPrivateKey(fixtures.readKey('agent1-key.pem'));
+const cert = fixtures.readKey('agent1-cert.pem');
+
+const codes = [200, 204, 404];
+let serverResponses = 0;
+const serverDone = Promise.withResolvers();
+
+const serverEndpoint = await listen(mustCall(async (ss) => {
+ ss.onstream = mustCall(() => {
+ if (++serverResponses === codes.length) {
+ ss.close();
+ serverDone.resolve();
+ }
+ }, codes.length);
+}), {
+ sni: { '*': { keys: [key], certs: [cert] } },
+ onheaders: mustCall(function() {
+ const status = codes[serverResponses - 1];
+ this.sendHeaders({ ':status': String(status) }, { terminal: true });
+ this.writer.endSync();
+ }, codes.length),
+});
+
+const clientSession = await connect(serverEndpoint.address, {
+ servername: 'localhost',
+ verifyPeer: 'manual',
+});
+await clientSession.opened;
+
+for (const expected of codes) {
+ const stream = await clientSession.createBidirectionalStream({
+ headers: {
+ ':method': 'GET',
+ ':path': '/',
+ ':scheme': 'https',
+ ':authority': 'localhost',
+ },
+ onheaders: mustCall(function(headers) {
+ assert.strictEqual(typeof headers[':status'], 'number');
+ assert.strictEqual(headers[':status'], expected);
+ }),
+ });
+ await stream.closed;
+}
+
+await serverDone.promise;
+await clientSession.close();
+await serverEndpoint.close();

doc/api/quic.md

@@ -3990,8 +3990,9 @@ A few things to note:
  the request is `HEADERS` followed by `END_STREAM`.
 * The `onheaders` callback receives the response pseudo-headers and
  regular headers in a single object with lowercase string keys.
- After the callback returns, the same object is also accessible
- via [`stream.headers`][].
+ For incoming headers, the `:status` pseudo-header is converted to
+ a `number`, matching HTTP/2 behavior. After the callback returns,
+ the same object is also accessible via [`stream.headers`][].
 * Reading `for await (const chunks of stream)` consumes the response
  body. Each iteration yields a `Uint8Array[]` batch of chunks.
 * HTTP semantic helpers (URL parsing, method/status validation,

lib/internal/quic/quic.js

@@ -1285,14 +1285,19 @@ function parseHeaderPairs(pairs) {
  assert(pairs.length % 2 === 0);
  const block = { __proto__: null };
  for (let n = 0; n + 1 < pairs.length; n += 2) {
- if (block[pairs[n]] !== undefined) {
- if (ArrayIsArray(block[pairs[n]])) {
- ArrayPrototypePush(block[pairs[n]], pairs[n + 1]);
+ const name = pairs[n];
+ let value = pairs[n + 1];
+ // Match HTTP/2 behavior: incoming :status is exposed as a number.
+ if (name === ':status')
+ value |= 0;
+ if (block[name] !== undefined) {
+ if (ArrayIsArray(block[name])) {
+ ArrayPrototypePush(block[name], value);
  } else {
- block[pairs[n]] = [block[pairs[n]], pairs[n + 1]];
+ block[name] = [block[name], value];
  }
  } else {
- block[pairs[n]] = pairs[n + 1];
+ block[name] = value;
  }
  }
  return block;

test/parallel/test-quic-h3-callback-errors.mjs

@@ -151,7 +151,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  ontrailers: mustCall(function() {
  throw new Error('ontrailers sync error');
@@ -265,7 +265,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-close-behavior.mjs

@@ -62,7 +62,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -74,7 +74,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-concurrent-requests.mjs

@@ -72,7 +72,7 @@ const requests = paths.map(mustCall(async (path) => {
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  headersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-datagram.mjs

@@ -87,7 +87,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -151,7 +151,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-error-codes.mjs

@@ -55,7 +55,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -106,7 +106,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-goaway.mjs

@@ -78,7 +78,7 @@ dc.subscribe('quic.session.goaway', mustCall((msg) => {
  await clientSession.opened;
 
  const onClientHeaders = mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  if (++clientHeaderCount === 2) {
  bothHeadersReceived.resolve();
  }

test/parallel/test-quic-h3-header-validation.mjs

@@ -91,7 +91,7 @@ const decoder = new TextDecoder();
  },
  onheaders: mustCall(function(headers) {
  // Client should also receive lowercased response header names.
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/html');
  assert.strictEqual(headers['x-response-header'], 'ResponseValue');
 
@@ -148,7 +148,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '204');
+ assert.strictEqual(headers[':status'], 204);
  }),
  });
 

test/parallel/test-quic-h3-informational-headers.mjs

@@ -34,7 +34,7 @@ dc.subscribe('quic.stream.info', mustCall((msg) => {
  assert.ok(msg.stream, 'stream.info should include stream');
  assert.ok(msg.session, 'stream.info should include session');
  assert.ok(msg.headers, 'stream.info should include headers');
- assert.strictEqual(msg.headers[':status'], '103');
+ assert.strictEqual(msg.headers[':status'], 103);
 }));
 
 // quic.stream.headers also fires for the final response headers.
@@ -89,12 +89,12 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  oninfo: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '103');
+ assert.strictEqual(headers[':status'], 103);
  assert.strictEqual(headers.link, '</style.css>; rel=preload; as=style');
  clientInfoReceived.resolve();
  }),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -107,7 +107,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the final (initial) headers, not 1xx.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-origin.mjs

@@ -77,7 +77,7 @@ const decoder = new TextDecoder();
  ':authority': 'example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -173,7 +173,7 @@ const decoder = new TextDecoder();
  ':authority': 'custom-port.example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-pending-stream.mjs

@@ -64,7 +64,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-post-filehandle.mjs

@@ -76,7 +76,7 @@ writeFileSync(testFile, testContent);
  },
  body: fh,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-post-request.mjs

@@ -84,7 +84,7 @@ const stream = await clientSession.createBidirectionalStream({
  },
  body: encoder.encode(requestBody),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
 });

test/parallel/test-quic-h3-priority.mjs

@@ -67,7 +67,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: false,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -85,7 +85,7 @@ const decoder = new TextDecoder();
  priority: 'low',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream2.priority, { level: 'low', incremental: true });
@@ -99,7 +99,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream3.priority, { level: 'default', incremental: false });
@@ -113,7 +113,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  // Default priority initially.
@@ -215,7 +215,7 @@ const decoder = new TextDecoder();
  },
  body: encoder.encode('signal'),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream.priority, { level: 'default', incremental: false });

test/parallel/test-quic-h3-qpack-settings.mjs

@@ -35,7 +35,7 @@ async function makeRequest(clientSession, path) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  const body = await bytes(stream);

test/parallel/test-quic-h3-request-response.mjs

@@ -93,7 +93,7 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -106,7 +106,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the buffered response headers.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-settings.mjs

@@ -71,7 +71,7 @@ const decoder = new TextDecoder();
  'x-second': 'two',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -129,7 +129,7 @@ const decoder = new TextDecoder();
  'x-long': longValue,
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -185,7 +185,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-status-code-type.mjs

@@ -0,0 +1,64 @@
+// Flags: --experimental-quic --experimental-stream-iter --no-warnings
+
+// Verify incoming :status is exposed as a number, matching HTTP/2 behavior.
+// See https://github.com/nodejs/node/issues/63557
+
+import { hasQuic, skip, mustCall } from '../common/index.mjs';
+import assert from 'node:assert';
+import * as fixtures from '../common/fixtures.mjs';
+
+if (!hasQuic) {
+ skip('QUIC is not enabled');
+}
+
+const { listen, connect } = await import('node:quic');
+const { createPrivateKey } = await import('node:crypto');
+
+const key = createPrivateKey(fixtures.readKey('agent1-key.pem'));
+const cert = fixtures.readKey('agent1-cert.pem');
+
+const codes = [200, 204, 404];
+let serverResponses = 0;
+const serverDone = Promise.withResolvers();
+
+const serverEndpoint = await listen(mustCall(async (ss) => {
+ ss.onstream = mustCall(() => {
+ if (++serverResponses === codes.length) {
+ ss.close();
+ serverDone.resolve();
+ }
+ }, codes.length);
+}), {
+ sni: { '*': { keys: [key], certs: [cert] } },
+ onheaders: mustCall(function() {
+ const status = codes[serverResponses - 1];
+ this.sendHeaders({ ':status': String(status) }, { terminal: true });
+ this.writer.endSync();
+ }, codes.length),
+});
+
+const clientSession = await connect(serverEndpoint.address, {
+ servername: 'localhost',
+ verifyPeer: 'manual',
+});
+await clientSession.opened;
+
+for (const expected of codes) {
+ const stream = await clientSession.createBidirectionalStream({
+ headers: {
+ ':method': 'GET',
+ ':path': '/',
+ ':scheme': 'https',
+ ':authority': 'localhost',
+ },
+ onheaders: mustCall(function(headers) {
+ assert.strictEqual(typeof headers[':status'], 'number');
+ assert.strictEqual(headers[':status'], expected);
+ }),
+ });
+ await stream.closed;
+}
+
+await serverDone.promise;
+await clientSession.close();
+await serverEndpoint.close();

doc/api/quic.md

@@ -3990,8 +3990,9 @@ A few things to note:
  the request is `HEADERS` followed by `END_STREAM`.
 * The `onheaders` callback receives the response pseudo-headers and
  regular headers in a single object with lowercase string keys.
- After the callback returns, the same object is also accessible
- via [`stream.headers`][].
+ For incoming headers, the `:status` pseudo-header is converted to
+ a `number`, matching HTTP/2 behavior. After the callback returns,
+ the same object is also accessible via [`stream.headers`][].
 * Reading `for await (const chunks of stream)` consumes the response
  body. Each iteration yields a `Uint8Array[]` batch of chunks.
 * HTTP semantic helpers (URL parsing, method/status validation,

lib/internal/quic/quic.js

@@ -1285,14 +1285,19 @@ function parseHeaderPairs(pairs) {
  assert(pairs.length % 2 === 0);
  const block = { __proto__: null };
  for (let n = 0; n + 1 < pairs.length; n += 2) {
- if (block[pairs[n]] !== undefined) {
- if (ArrayIsArray(block[pairs[n]])) {
- ArrayPrototypePush(block[pairs[n]], pairs[n + 1]);
+ const name = pairs[n];
+ let value = pairs[n + 1];
+ // Match HTTP/2 behavior: incoming :status is exposed as a number.
+ if (name === ':status')
+ value |= 0;
+ if (block[name] !== undefined) {
+ if (ArrayIsArray(block[name])) {
+ ArrayPrototypePush(block[name], value);
  } else {
- block[pairs[n]] = [block[pairs[n]], pairs[n + 1]];
+ block[name] = [block[name], value];
  }
  } else {
- block[pairs[n]] = pairs[n + 1];
+ block[name] = value;
  }
  }
  return block;

test/parallel/test-quic-h3-callback-errors.mjs

@@ -151,7 +151,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  ontrailers: mustCall(function() {
  throw new Error('ontrailers sync error');
@@ -265,7 +265,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-close-behavior.mjs

@@ -62,7 +62,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -74,7 +74,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-concurrent-requests.mjs

@@ -72,7 +72,7 @@ const requests = paths.map(mustCall(async (path) => {
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  headersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-datagram.mjs

@@ -87,7 +87,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -151,7 +151,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-error-codes.mjs

@@ -55,7 +55,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -106,7 +106,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-goaway.mjs

@@ -78,7 +78,7 @@ dc.subscribe('quic.session.goaway', mustCall((msg) => {
  await clientSession.opened;
 
  const onClientHeaders = mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  if (++clientHeaderCount === 2) {
  bothHeadersReceived.resolve();
  }

test/parallel/test-quic-h3-header-validation.mjs

@@ -91,7 +91,7 @@ const decoder = new TextDecoder();
  },
  onheaders: mustCall(function(headers) {
  // Client should also receive lowercased response header names.
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/html');
  assert.strictEqual(headers['x-response-header'], 'ResponseValue');
 
@@ -148,7 +148,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '204');
+ assert.strictEqual(headers[':status'], 204);
  }),
  });
 

test/parallel/test-quic-h3-informational-headers.mjs

@@ -34,7 +34,7 @@ dc.subscribe('quic.stream.info', mustCall((msg) => {
  assert.ok(msg.stream, 'stream.info should include stream');
  assert.ok(msg.session, 'stream.info should include session');
  assert.ok(msg.headers, 'stream.info should include headers');
- assert.strictEqual(msg.headers[':status'], '103');
+ assert.strictEqual(msg.headers[':status'], 103);
 }));
 
 // quic.stream.headers also fires for the final response headers.
@@ -89,12 +89,12 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  oninfo: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '103');
+ assert.strictEqual(headers[':status'], 103);
  assert.strictEqual(headers.link, '</style.css>; rel=preload; as=style');
  clientInfoReceived.resolve();
  }),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -107,7 +107,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the final (initial) headers, not 1xx.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-origin.mjs

@@ -77,7 +77,7 @@ const decoder = new TextDecoder();
  ':authority': 'example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -173,7 +173,7 @@ const decoder = new TextDecoder();
  ':authority': 'custom-port.example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-pending-stream.mjs

@@ -64,7 +64,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-post-filehandle.mjs

@@ -76,7 +76,7 @@ writeFileSync(testFile, testContent);
  },
  body: fh,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-post-request.mjs

@@ -84,7 +84,7 @@ const stream = await clientSession.createBidirectionalStream({
  },
  body: encoder.encode(requestBody),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
 });

test/parallel/test-quic-h3-priority.mjs

@@ -67,7 +67,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: false,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -85,7 +85,7 @@ const decoder = new TextDecoder();
  priority: 'low',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream2.priority, { level: 'low', incremental: true });
@@ -99,7 +99,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream3.priority, { level: 'default', incremental: false });
@@ -113,7 +113,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  // Default priority initially.
@@ -215,7 +215,7 @@ const decoder = new TextDecoder();
  },
  body: encoder.encode('signal'),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream.priority, { level: 'default', incremental: false });

test/parallel/test-quic-h3-qpack-settings.mjs

@@ -35,7 +35,7 @@ async function makeRequest(clientSession, path) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  const body = await bytes(stream);

test/parallel/test-quic-h3-request-response.mjs

@@ -93,7 +93,7 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -106,7 +106,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the buffered response headers.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-settings.mjs

@@ -71,7 +71,7 @@ const decoder = new TextDecoder();
  'x-second': 'two',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -129,7 +129,7 @@ const decoder = new TextDecoder();
  'x-long': longValue,
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -185,7 +185,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-status-code-type.mjs

@@ -0,0 +1,64 @@
+// Flags: --experimental-quic --experimental-stream-iter --no-warnings
+
+// Verify incoming :status is exposed as a number, matching HTTP/2 behavior.
+// See https://github.com/nodejs/node/issues/63557
+
+import { hasQuic, skip, mustCall } from '../common/index.mjs';
+import assert from 'node:assert';
+import * as fixtures from '../common/fixtures.mjs';
+
+if (!hasQuic) {
+ skip('QUIC is not enabled');
+}
+
+const { listen, connect } = await import('node:quic');
+const { createPrivateKey } = await import('node:crypto');
+
+const key = createPrivateKey(fixtures.readKey('agent1-key.pem'));
+const cert = fixtures.readKey('agent1-cert.pem');
+
+const codes = [200, 204, 404];
+let serverResponses = 0;
+const serverDone = Promise.withResolvers();
+
+const serverEndpoint = await listen(mustCall(async (ss) => {
+ ss.onstream = mustCall(() => {
+ if (++serverResponses === codes.length) {
+ ss.close();
+ serverDone.resolve();
+ }
+ }, codes.length);
+}), {
+ sni: { '*': { keys: [key], certs: [cert] } },
+ onheaders: mustCall(function() {
+ const status = codes[serverResponses - 1];
+ this.sendHeaders({ ':status': String(status) }, { terminal: true });
+ this.writer.endSync();
+ }, codes.length),
+});
+
+const clientSession = await connect(serverEndpoint.address, {
+ servername: 'localhost',
+ verifyPeer: 'manual',
+});
+await clientSession.opened;
+
+for (const expected of codes) {
+ const stream = await clientSession.createBidirectionalStream({
+ headers: {
+ ':method': 'GET',
+ ':path': '/',
+ ':scheme': 'https',
+ ':authority': 'localhost',
+ },
+ onheaders: mustCall(function(headers) {
+ assert.strictEqual(typeof headers[':status'], 'number');
+ assert.strictEqual(headers[':status'], expected);
+ }),
+ });
+ await stream.closed;
+}
+
+await serverDone.promise;
+await clientSession.close();
+await serverEndpoint.close();

doc/api/quic.md

@@ -3990,8 +3990,9 @@ A few things to note:
  the request is `HEADERS` followed by `END_STREAM`.
 * The `onheaders` callback receives the response pseudo-headers and
  regular headers in a single object with lowercase string keys.
- After the callback returns, the same object is also accessible
- via [`stream.headers`][].
+ For incoming headers, the `:status` pseudo-header is converted to
+ a `number`, matching HTTP/2 behavior. After the callback returns,
+ the same object is also accessible via [`stream.headers`][].
 * Reading `for await (const chunks of stream)` consumes the response
  body. Each iteration yields a `Uint8Array[]` batch of chunks.
 * HTTP semantic helpers (URL parsing, method/status validation,

lib/internal/quic/quic.js

@@ -1285,14 +1285,19 @@ function parseHeaderPairs(pairs) {
  assert(pairs.length % 2 === 0);
  const block = { __proto__: null };
  for (let n = 0; n + 1 < pairs.length; n += 2) {
- if (block[pairs[n]] !== undefined) {
- if (ArrayIsArray(block[pairs[n]])) {
- ArrayPrototypePush(block[pairs[n]], pairs[n + 1]);
+ const name = pairs[n];
+ let value = pairs[n + 1];
+ // Match HTTP/2 behavior: incoming :status is exposed as a number.
+ if (name === ':status')
+ value |= 0;
+ if (block[name] !== undefined) {
+ if (ArrayIsArray(block[name])) {
+ ArrayPrototypePush(block[name], value);
  } else {
- block[pairs[n]] = [block[pairs[n]], pairs[n + 1]];
+ block[name] = [block[name], value];
  }
  } else {
- block[pairs[n]] = pairs[n + 1];
+ block[name] = value;
  }
  }
  return block;

test/parallel/test-quic-h3-callback-errors.mjs

@@ -151,7 +151,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  ontrailers: mustCall(function() {
  throw new Error('ontrailers sync error');
@@ -265,7 +265,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-close-behavior.mjs

@@ -62,7 +62,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -74,7 +74,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-concurrent-requests.mjs

@@ -72,7 +72,7 @@ const requests = paths.map(mustCall(async (path) => {
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  headersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-datagram.mjs

@@ -87,7 +87,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -151,7 +151,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-error-codes.mjs

@@ -55,7 +55,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -106,7 +106,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-goaway.mjs

@@ -78,7 +78,7 @@ dc.subscribe('quic.session.goaway', mustCall((msg) => {
  await clientSession.opened;
 
  const onClientHeaders = mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  if (++clientHeaderCount === 2) {
  bothHeadersReceived.resolve();
  }

test/parallel/test-quic-h3-header-validation.mjs

@@ -91,7 +91,7 @@ const decoder = new TextDecoder();
  },
  onheaders: mustCall(function(headers) {
  // Client should also receive lowercased response header names.
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/html');
  assert.strictEqual(headers['x-response-header'], 'ResponseValue');
 
@@ -148,7 +148,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '204');
+ assert.strictEqual(headers[':status'], 204);
  }),
  });
 

test/parallel/test-quic-h3-informational-headers.mjs

@@ -34,7 +34,7 @@ dc.subscribe('quic.stream.info', mustCall((msg) => {
  assert.ok(msg.stream, 'stream.info should include stream');
  assert.ok(msg.session, 'stream.info should include session');
  assert.ok(msg.headers, 'stream.info should include headers');
- assert.strictEqual(msg.headers[':status'], '103');
+ assert.strictEqual(msg.headers[':status'], 103);
 }));
 
 // quic.stream.headers also fires for the final response headers.
@@ -89,12 +89,12 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  oninfo: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '103');
+ assert.strictEqual(headers[':status'], 103);
  assert.strictEqual(headers.link, '</style.css>; rel=preload; as=style');
  clientInfoReceived.resolve();
  }),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -107,7 +107,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the final (initial) headers, not 1xx.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-origin.mjs

@@ -77,7 +77,7 @@ const decoder = new TextDecoder();
  ':authority': 'example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -173,7 +173,7 @@ const decoder = new TextDecoder();
  ':authority': 'custom-port.example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-pending-stream.mjs

@@ -64,7 +64,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-post-filehandle.mjs

@@ -76,7 +76,7 @@ writeFileSync(testFile, testContent);
  },
  body: fh,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-post-request.mjs

@@ -84,7 +84,7 @@ const stream = await clientSession.createBidirectionalStream({
  },
  body: encoder.encode(requestBody),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
 });

test/parallel/test-quic-h3-priority.mjs

@@ -67,7 +67,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: false,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -85,7 +85,7 @@ const decoder = new TextDecoder();
  priority: 'low',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream2.priority, { level: 'low', incremental: true });
@@ -99,7 +99,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream3.priority, { level: 'default', incremental: false });
@@ -113,7 +113,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  // Default priority initially.
@@ -215,7 +215,7 @@ const decoder = new TextDecoder();
  },
  body: encoder.encode('signal'),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream.priority, { level: 'default', incremental: false });

test/parallel/test-quic-h3-qpack-settings.mjs

@@ -35,7 +35,7 @@ async function makeRequest(clientSession, path) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  const body = await bytes(stream);

test/parallel/test-quic-h3-request-response.mjs

@@ -93,7 +93,7 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -106,7 +106,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the buffered response headers.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-settings.mjs

@@ -71,7 +71,7 @@ const decoder = new TextDecoder();
  'x-second': 'two',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -129,7 +129,7 @@ const decoder = new TextDecoder();
  'x-long': longValue,
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -185,7 +185,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-status-code-type.mjs

@@ -0,0 +1,64 @@
+// Flags: --experimental-quic --experimental-stream-iter --no-warnings
+
+// Verify incoming :status is exposed as a number, matching HTTP/2 behavior.
+// See https://github.com/nodejs/node/issues/63557
+
+import { hasQuic, skip, mustCall } from '../common/index.mjs';
+import assert from 'node:assert';
+import * as fixtures from '../common/fixtures.mjs';
+
+if (!hasQuic) {
+ skip('QUIC is not enabled');
+}
+
+const { listen, connect } = await import('node:quic');
+const { createPrivateKey } = await import('node:crypto');
+
+const key = createPrivateKey(fixtures.readKey('agent1-key.pem'));
+const cert = fixtures.readKey('agent1-cert.pem');
+
+const codes = [200, 204, 404];
+let serverResponses = 0;
+const serverDone = Promise.withResolvers();
+
+const serverEndpoint = await listen(mustCall(async (ss) => {
+ ss.onstream = mustCall(() => {
+ if (++serverResponses === codes.length) {
+ ss.close();
+ serverDone.resolve();
+ }
+ }, codes.length);
+}), {
+ sni: { '*': { keys: [key], certs: [cert] } },
+ onheaders: mustCall(function() {
+ const status = codes[serverResponses - 1];
+ this.sendHeaders({ ':status': String(status) }, { terminal: true });
+ this.writer.endSync();
+ }, codes.length),
+});
+
+const clientSession = await connect(serverEndpoint.address, {
+ servername: 'localhost',
+ verifyPeer: 'manual',
+});
+await clientSession.opened;
+
+for (const expected of codes) {
+ const stream = await clientSession.createBidirectionalStream({
+ headers: {
+ ':method': 'GET',
+ ':path': '/',
+ ':scheme': 'https',
+ ':authority': 'localhost',
+ },
+ onheaders: mustCall(function(headers) {
+ assert.strictEqual(typeof headers[':status'], 'number');
+ assert.strictEqual(headers[':status'], expected);
+ }),
+ });
+ await stream.closed;
+}
+
+await serverDone.promise;
+await clientSession.close();
+await serverEndpoint.close();

doc/api/quic.md

@@ -3990,8 +3990,9 @@ A few things to note:
  the request is `HEADERS` followed by `END_STREAM`.
 * The `onheaders` callback receives the response pseudo-headers and
  regular headers in a single object with lowercase string keys.
- After the callback returns, the same object is also accessible
- via [`stream.headers`][].
+ For incoming headers, the `:status` pseudo-header is converted to
+ a `number`, matching HTTP/2 behavior. After the callback returns,
+ the same object is also accessible via [`stream.headers`][].
 * Reading `for await (const chunks of stream)` consumes the response
  body. Each iteration yields a `Uint8Array[]` batch of chunks.
 * HTTP semantic helpers (URL parsing, method/status validation,

lib/internal/quic/quic.js

@@ -1285,14 +1285,19 @@ function parseHeaderPairs(pairs) {
  assert(pairs.length % 2 === 0);
  const block = { __proto__: null };
  for (let n = 0; n + 1 < pairs.length; n += 2) {
- if (block[pairs[n]] !== undefined) {
- if (ArrayIsArray(block[pairs[n]])) {
- ArrayPrototypePush(block[pairs[n]], pairs[n + 1]);
+ const name = pairs[n];
+ let value = pairs[n + 1];
+ // Match HTTP/2 behavior: incoming :status is exposed as a number.
+ if (name === ':status')
+ value |= 0;
+ if (block[name] !== undefined) {
+ if (ArrayIsArray(block[name])) {
+ ArrayPrototypePush(block[name], value);
  } else {
- block[pairs[n]] = [block[pairs[n]], pairs[n + 1]];
+ block[name] = [block[name], value];
  }
  } else {
- block[pairs[n]] = pairs[n + 1];
+ block[name] = value;
  }
  }
  return block;

test/parallel/test-quic-h3-callback-errors.mjs

@@ -151,7 +151,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  ontrailers: mustCall(function() {
  throw new Error('ontrailers sync error');
@@ -265,7 +265,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-close-behavior.mjs

@@ -62,7 +62,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -74,7 +74,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-concurrent-requests.mjs

@@ -72,7 +72,7 @@ const requests = paths.map(mustCall(async (path) => {
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  headersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-datagram.mjs

@@ -87,7 +87,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -151,7 +151,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-error-codes.mjs

@@ -55,7 +55,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -106,7 +106,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-goaway.mjs

@@ -78,7 +78,7 @@ dc.subscribe('quic.session.goaway', mustCall((msg) => {
  await clientSession.opened;
 
  const onClientHeaders = mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  if (++clientHeaderCount === 2) {
  bothHeadersReceived.resolve();
  }

test/parallel/test-quic-h3-header-validation.mjs

@@ -91,7 +91,7 @@ const decoder = new TextDecoder();
  },
  onheaders: mustCall(function(headers) {
  // Client should also receive lowercased response header names.
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/html');
  assert.strictEqual(headers['x-response-header'], 'ResponseValue');
 
@@ -148,7 +148,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '204');
+ assert.strictEqual(headers[':status'], 204);
  }),
  });
 

test/parallel/test-quic-h3-informational-headers.mjs

@@ -34,7 +34,7 @@ dc.subscribe('quic.stream.info', mustCall((msg) => {
  assert.ok(msg.stream, 'stream.info should include stream');
  assert.ok(msg.session, 'stream.info should include session');
  assert.ok(msg.headers, 'stream.info should include headers');
- assert.strictEqual(msg.headers[':status'], '103');
+ assert.strictEqual(msg.headers[':status'], 103);
 }));
 
 // quic.stream.headers also fires for the final response headers.
@@ -89,12 +89,12 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  oninfo: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '103');
+ assert.strictEqual(headers[':status'], 103);
  assert.strictEqual(headers.link, '</style.css>; rel=preload; as=style');
  clientInfoReceived.resolve();
  }),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -107,7 +107,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the final (initial) headers, not 1xx.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-origin.mjs

@@ -77,7 +77,7 @@ const decoder = new TextDecoder();
  ':authority': 'example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -173,7 +173,7 @@ const decoder = new TextDecoder();
  ':authority': 'custom-port.example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-pending-stream.mjs

@@ -64,7 +64,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-post-filehandle.mjs

@@ -76,7 +76,7 @@ writeFileSync(testFile, testContent);
  },
  body: fh,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-post-request.mjs

@@ -84,7 +84,7 @@ const stream = await clientSession.createBidirectionalStream({
  },
  body: encoder.encode(requestBody),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
 });

test/parallel/test-quic-h3-priority.mjs

@@ -67,7 +67,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: false,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -85,7 +85,7 @@ const decoder = new TextDecoder();
  priority: 'low',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream2.priority, { level: 'low', incremental: true });
@@ -99,7 +99,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream3.priority, { level: 'default', incremental: false });
@@ -113,7 +113,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  // Default priority initially.
@@ -215,7 +215,7 @@ const decoder = new TextDecoder();
  },
  body: encoder.encode('signal'),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream.priority, { level: 'default', incremental: false });

test/parallel/test-quic-h3-qpack-settings.mjs

@@ -35,7 +35,7 @@ async function makeRequest(clientSession, path) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  const body = await bytes(stream);

test/parallel/test-quic-h3-request-response.mjs

@@ -93,7 +93,7 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -106,7 +106,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the buffered response headers.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-settings.mjs

@@ -71,7 +71,7 @@ const decoder = new TextDecoder();
  'x-second': 'two',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -129,7 +129,7 @@ const decoder = new TextDecoder();
  'x-long': longValue,
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -185,7 +185,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-status-code-type.mjs

@@ -0,0 +1,64 @@
+// Flags: --experimental-quic --experimental-stream-iter --no-warnings
+
+// Verify incoming :status is exposed as a number, matching HTTP/2 behavior.
+// See https://github.com/nodejs/node/issues/63557
+
+import { hasQuic, skip, mustCall } from '../common/index.mjs';
+import assert from 'node:assert';
+import * as fixtures from '../common/fixtures.mjs';
+
+if (!hasQuic) {
+ skip('QUIC is not enabled');
+}
+
+const { listen, connect } = await import('node:quic');
+const { createPrivateKey } = await import('node:crypto');
+
+const key = createPrivateKey(fixtures.readKey('agent1-key.pem'));
+const cert = fixtures.readKey('agent1-cert.pem');
+
+const codes = [200, 204, 404];
+let serverResponses = 0;
+const serverDone = Promise.withResolvers();
+
+const serverEndpoint = await listen(mustCall(async (ss) => {
+ ss.onstream = mustCall(() => {
+ if (++serverResponses === codes.length) {
+ ss.close();
+ serverDone.resolve();
+ }
+ }, codes.length);
+}), {
+ sni: { '*': { keys: [key], certs: [cert] } },
+ onheaders: mustCall(function() {
+ const status = codes[serverResponses - 1];
+ this.sendHeaders({ ':status': String(status) }, { terminal: true });
+ this.writer.endSync();
+ }, codes.length),
+});
+
+const clientSession = await connect(serverEndpoint.address, {
+ servername: 'localhost',
+ verifyPeer: 'manual',
+});
+await clientSession.opened;
+
+for (const expected of codes) {
+ const stream = await clientSession.createBidirectionalStream({
+ headers: {
+ ':method': 'GET',
+ ':path': '/',
+ ':scheme': 'https',
+ ':authority': 'localhost',
+ },
+ onheaders: mustCall(function(headers) {
+ assert.strictEqual(typeof headers[':status'], 'number');
+ assert.strictEqual(headers[':status'], expected);
+ }),
+ });
+ await stream.closed;
+}
+
+await serverDone.promise;
+await clientSession.close();
+await serverEndpoint.close();

doc/api/quic.md

@@ -3990,8 +3990,9 @@ A few things to note:
  the request is `HEADERS` followed by `END_STREAM`.
 * The `onheaders` callback receives the response pseudo-headers and
  regular headers in a single object with lowercase string keys.
- After the callback returns, the same object is also accessible
- via [`stream.headers`][].
+ For incoming headers, the `:status` pseudo-header is converted to
+ a `number`, matching HTTP/2 behavior. After the callback returns,
+ the same object is also accessible via [`stream.headers`][].
 * Reading `for await (const chunks of stream)` consumes the response
  body. Each iteration yields a `Uint8Array[]` batch of chunks.
 * HTTP semantic helpers (URL parsing, method/status validation,

lib/internal/quic/quic.js

@@ -1285,14 +1285,19 @@ function parseHeaderPairs(pairs) {
  assert(pairs.length % 2 === 0);
  const block = { __proto__: null };
  for (let n = 0; n + 1 < pairs.length; n += 2) {
- if (block[pairs[n]] !== undefined) {
- if (ArrayIsArray(block[pairs[n]])) {
- ArrayPrototypePush(block[pairs[n]], pairs[n + 1]);
+ const name = pairs[n];
+ let value = pairs[n + 1];
+ // Match HTTP/2 behavior: incoming :status is exposed as a number.
+ if (name === ':status')
+ value |= 0;
+ if (block[name] !== undefined) {
+ if (ArrayIsArray(block[name])) {
+ ArrayPrototypePush(block[name], value);
  } else {
- block[pairs[n]] = [block[pairs[n]], pairs[n + 1]];
+ block[name] = [block[name], value];
  }
  } else {
- block[pairs[n]] = pairs[n + 1];
+ block[name] = value;
  }
  }
  return block;

test/parallel/test-quic-h3-callback-errors.mjs

@@ -151,7 +151,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  ontrailers: mustCall(function() {
  throw new Error('ontrailers sync error');
@@ -265,7 +265,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-close-behavior.mjs

@@ -62,7 +62,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -74,7 +74,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-concurrent-requests.mjs

@@ -72,7 +72,7 @@ const requests = paths.map(mustCall(async (path) => {
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  headersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-datagram.mjs

@@ -87,7 +87,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -151,7 +151,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-error-codes.mjs

@@ -55,7 +55,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -106,7 +106,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-goaway.mjs

@@ -78,7 +78,7 @@ dc.subscribe('quic.session.goaway', mustCall((msg) => {
  await clientSession.opened;
 
  const onClientHeaders = mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  if (++clientHeaderCount === 2) {
  bothHeadersReceived.resolve();
  }

test/parallel/test-quic-h3-header-validation.mjs

@@ -91,7 +91,7 @@ const decoder = new TextDecoder();
  },
  onheaders: mustCall(function(headers) {
  // Client should also receive lowercased response header names.
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/html');
  assert.strictEqual(headers['x-response-header'], 'ResponseValue');
 
@@ -148,7 +148,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '204');
+ assert.strictEqual(headers[':status'], 204);
  }),
  });
 

test/parallel/test-quic-h3-informational-headers.mjs

@@ -34,7 +34,7 @@ dc.subscribe('quic.stream.info', mustCall((msg) => {
  assert.ok(msg.stream, 'stream.info should include stream');
  assert.ok(msg.session, 'stream.info should include session');
  assert.ok(msg.headers, 'stream.info should include headers');
- assert.strictEqual(msg.headers[':status'], '103');
+ assert.strictEqual(msg.headers[':status'], 103);
 }));
 
 // quic.stream.headers also fires for the final response headers.
@@ -89,12 +89,12 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  oninfo: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '103');
+ assert.strictEqual(headers[':status'], 103);
  assert.strictEqual(headers.link, '</style.css>; rel=preload; as=style');
  clientInfoReceived.resolve();
  }),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -107,7 +107,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the final (initial) headers, not 1xx.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-origin.mjs

@@ -77,7 +77,7 @@ const decoder = new TextDecoder();
  ':authority': 'example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -173,7 +173,7 @@ const decoder = new TextDecoder();
  ':authority': 'custom-port.example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-pending-stream.mjs

@@ -64,7 +64,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-post-filehandle.mjs

@@ -76,7 +76,7 @@ writeFileSync(testFile, testContent);
  },
  body: fh,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-post-request.mjs

@@ -84,7 +84,7 @@ const stream = await clientSession.createBidirectionalStream({
  },
  body: encoder.encode(requestBody),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
 });

test/parallel/test-quic-h3-priority.mjs

@@ -67,7 +67,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: false,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -85,7 +85,7 @@ const decoder = new TextDecoder();
  priority: 'low',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream2.priority, { level: 'low', incremental: true });
@@ -99,7 +99,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream3.priority, { level: 'default', incremental: false });
@@ -113,7 +113,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  // Default priority initially.
@@ -215,7 +215,7 @@ const decoder = new TextDecoder();
  },
  body: encoder.encode('signal'),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream.priority, { level: 'default', incremental: false });

test/parallel/test-quic-h3-qpack-settings.mjs

@@ -35,7 +35,7 @@ async function makeRequest(clientSession, path) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  const body = await bytes(stream);

test/parallel/test-quic-h3-request-response.mjs

@@ -93,7 +93,7 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -106,7 +106,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the buffered response headers.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-settings.mjs

@@ -71,7 +71,7 @@ const decoder = new TextDecoder();
  'x-second': 'two',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -129,7 +129,7 @@ const decoder = new TextDecoder();
  'x-long': longValue,
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -185,7 +185,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-status-code-type.mjs

@@ -0,0 +1,64 @@
+// Flags: --experimental-quic --experimental-stream-iter --no-warnings
+
+// Verify incoming :status is exposed as a number, matching HTTP/2 behavior.
+// See https://github.com/nodejs/node/issues/63557
+
+import { hasQuic, skip, mustCall } from '../common/index.mjs';
+import assert from 'node:assert';
+import * as fixtures from '../common/fixtures.mjs';
+
+if (!hasQuic) {
+ skip('QUIC is not enabled');
+}
+
+const { listen, connect } = await import('node:quic');
+const { createPrivateKey } = await import('node:crypto');
+
+const key = createPrivateKey(fixtures.readKey('agent1-key.pem'));
+const cert = fixtures.readKey('agent1-cert.pem');
+
+const codes = [200, 204, 404];
+let serverResponses = 0;
+const serverDone = Promise.withResolvers();
+
+const serverEndpoint = await listen(mustCall(async (ss) => {
+ ss.onstream = mustCall(() => {
+ if (++serverResponses === codes.length) {
+ ss.close();
+ serverDone.resolve();
+ }
+ }, codes.length);
+}), {
+ sni: { '*': { keys: [key], certs: [cert] } },
+ onheaders: mustCall(function() {
+ const status = codes[serverResponses - 1];
+ this.sendHeaders({ ':status': String(status) }, { terminal: true });
+ this.writer.endSync();
+ }, codes.length),
+});
+
+const clientSession = await connect(serverEndpoint.address, {
+ servername: 'localhost',
+ verifyPeer: 'manual',
+});
+await clientSession.opened;
+
+for (const expected of codes) {
+ const stream = await clientSession.createBidirectionalStream({
+ headers: {
+ ':method': 'GET',
+ ':path': '/',
+ ':scheme': 'https',
+ ':authority': 'localhost',
+ },
+ onheaders: mustCall(function(headers) {
+ assert.strictEqual(typeof headers[':status'], 'number');
+ assert.strictEqual(headers[':status'], expected);
+ }),
+ });
+ await stream.closed;
+}
+
+await serverDone.promise;
+await clientSession.close();
+await serverEndpoint.close();

doc/api/quic.md

@@ -3990,8 +3990,9 @@ A few things to note:
  the request is `HEADERS` followed by `END_STREAM`.
 * The `onheaders` callback receives the response pseudo-headers and
  regular headers in a single object with lowercase string keys.
- After the callback returns, the same object is also accessible
- via [`stream.headers`][].
+ For incoming headers, the `:status` pseudo-header is converted to
+ a `number`, matching HTTP/2 behavior. After the callback returns,
+ the same object is also accessible via [`stream.headers`][].
 * Reading `for await (const chunks of stream)` consumes the response
  body. Each iteration yields a `Uint8Array[]` batch of chunks.
 * HTTP semantic helpers (URL parsing, method/status validation,

lib/internal/quic/quic.js

@@ -1285,14 +1285,19 @@ function parseHeaderPairs(pairs) {
  assert(pairs.length % 2 === 0);
  const block = { __proto__: null };
  for (let n = 0; n + 1 < pairs.length; n += 2) {
- if (block[pairs[n]] !== undefined) {
- if (ArrayIsArray(block[pairs[n]])) {
- ArrayPrototypePush(block[pairs[n]], pairs[n + 1]);
+ const name = pairs[n];
+ let value = pairs[n + 1];
+ // Match HTTP/2 behavior: incoming :status is exposed as a number.
+ if (name === ':status')
+ value |= 0;
+ if (block[name] !== undefined) {
+ if (ArrayIsArray(block[name])) {
+ ArrayPrototypePush(block[name], value);
  } else {
- block[pairs[n]] = [block[pairs[n]], pairs[n + 1]];
+ block[name] = [block[name], value];
  }
  } else {
- block[pairs[n]] = pairs[n + 1];
+ block[name] = value;
  }
  }
  return block;

test/parallel/test-quic-h3-callback-errors.mjs

@@ -151,7 +151,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  ontrailers: mustCall(function() {
  throw new Error('ontrailers sync error');
@@ -265,7 +265,7 @@ async function makeServer(onheadersHandler, extraOpts = {}) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-close-behavior.mjs

@@ -62,7 +62,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -74,7 +74,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-concurrent-requests.mjs

@@ -72,7 +72,7 @@ const requests = paths.map(mustCall(async (path) => {
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  headersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-datagram.mjs

@@ -87,7 +87,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -151,7 +151,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-error-codes.mjs

@@ -55,7 +55,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -106,7 +106,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-goaway.mjs

@@ -78,7 +78,7 @@ dc.subscribe('quic.session.goaway', mustCall((msg) => {
  await clientSession.opened;
 
  const onClientHeaders = mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  if (++clientHeaderCount === 2) {
  bothHeadersReceived.resolve();
  }

test/parallel/test-quic-h3-header-validation.mjs

@@ -91,7 +91,7 @@ const decoder = new TextDecoder();
  },
  onheaders: mustCall(function(headers) {
  // Client should also receive lowercased response header names.
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/html');
  assert.strictEqual(headers['x-response-header'], 'ResponseValue');
 
@@ -148,7 +148,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall((headers) => {
- assert.strictEqual(headers[':status'], '204');
+ assert.strictEqual(headers[':status'], 204);
  }),
  });
 

test/parallel/test-quic-h3-informational-headers.mjs

@@ -34,7 +34,7 @@ dc.subscribe('quic.stream.info', mustCall((msg) => {
  assert.ok(msg.stream, 'stream.info should include stream');
  assert.ok(msg.session, 'stream.info should include session');
  assert.ok(msg.headers, 'stream.info should include headers');
- assert.strictEqual(msg.headers[':status'], '103');
+ assert.strictEqual(msg.headers[':status'], 103);
 }));
 
 // quic.stream.headers also fires for the final response headers.
@@ -89,12 +89,12 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  oninfo: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '103');
+ assert.strictEqual(headers[':status'], 103);
  assert.strictEqual(headers.link, '</style.css>; rel=preload; as=style');
  clientInfoReceived.resolve();
  }),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -107,7 +107,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the final (initial) headers, not 1xx.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-origin.mjs

@@ -77,7 +77,7 @@ const decoder = new TextDecoder();
  ':authority': 'example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -173,7 +173,7 @@ const decoder = new TextDecoder();
  ':authority': 'custom-port.example.com',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-pending-stream.mjs

@@ -64,7 +64,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-post-filehandle.mjs

@@ -76,7 +76,7 @@ writeFileSync(testFile, testContent);
  },
  body: fh,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
  });

test/parallel/test-quic-h3-post-request.mjs

@@ -84,7 +84,7 @@ const stream = await clientSession.createBidirectionalStream({
  },
  body: encoder.encode(requestBody),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  clientHeadersReceived.resolve();
  }),
 });

test/parallel/test-quic-h3-priority.mjs

@@ -67,7 +67,7 @@ const decoder = new TextDecoder();
  priority: 'high',
  incremental: false,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -85,7 +85,7 @@ const decoder = new TextDecoder();
  priority: 'low',
  incremental: true,
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream2.priority, { level: 'low', incremental: true });
@@ -99,7 +99,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream3.priority, { level: 'default', incremental: false });
@@ -113,7 +113,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  // Default priority initially.
@@ -215,7 +215,7 @@ const decoder = new TextDecoder();
  },
  body: encoder.encode('signal'),
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  assert.deepStrictEqual(stream.priority, { level: 'default', incremental: false });

test/parallel/test-quic-h3-qpack-settings.mjs

@@ -35,7 +35,7 @@ async function makeRequest(clientSession, path) {
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
  const body = await bytes(stream);

test/parallel/test-quic-h3-request-response.mjs

@@ -93,7 +93,7 @@ const stream = await clientSession.createBidirectionalStream({
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  assert.strictEqual(headers['content-type'], 'text/plain');
  clientHeadersReceived.resolve();
  }),
@@ -106,7 +106,7 @@ const body = await bytes(stream);
 assert.strictEqual(decoder.decode(body), responseBody);
 
 // stream.headers should return the buffered response headers.
-assert.strictEqual(stream.headers[':status'], '200');
+assert.strictEqual(stream.headers[':status'], 200);
 
 await Promise.all([stream.closed, serverDone.promise]);
 await clientSession.close();

test/parallel/test-quic-h3-settings.mjs

@@ -71,7 +71,7 @@ const decoder = new TextDecoder();
  'x-second': 'two',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -129,7 +129,7 @@ const decoder = new TextDecoder();
  'x-long': longValue,
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 
@@ -185,7 +185,7 @@ const decoder = new TextDecoder();
  ':authority': 'localhost',
  },
  onheaders: mustCall(function(headers) {
- assert.strictEqual(headers[':status'], '200');
+ assert.strictEqual(headers[':status'], 200);
  }),
  });
 

test/parallel/test-quic-h3-status-code-type.mjs

@@ -0,0 +1,64 @@
+// Flags: --experimental-quic --experimental-stream-iter --no-warnings
+
+// Verify incoming :status is exposed as a number, matching HTTP/2 behavior.
+// See https://github.com/nodejs/node/issues/63557
+
+import { hasQuic, skip, mustCall } from '../common/index.mjs';
+import assert from 'node:assert';
+import * as fixtures from '../common/fixtures.mjs';
+
+if (!hasQuic) {
+ skip('QUIC is not enabled');
+}
+
+const { listen, connect } = await import('node:quic');
+const { createPrivateKey } = await import('node:crypto');
+
+const key = createPrivateKey(fixtures.readKey('agent1-key.pem'));
+const cert = fixtures.readKey('agent1-cert.pem');
+
+const codes = [200, 204, 404];
+let serverResponses = 0;
+const serverDone = Promise.withResolvers();
+
+const serverEndpoint = await listen(mustCall(async (ss) => {
+ ss.onstream = mustCall(() => {
+ if (++serverResponses === codes.length) {
+ ss.close();
+ serverDone.resolve();
+ }
+ }, codes.length);
+}), {
+ sni: { '*': { keys: [key], certs: [cert] } },
+ onheaders: mustCall(function() {
+ const status = codes[serverResponses - 1];
+ this.sendHeaders({ ':status': String(status) }, { terminal: true });
+ this.writer.endSync();
+ }, codes.length),
+});
+
+const clientSession = await connect(serverEndpoint.address, {
+ servername: 'localhost',
+ verifyPeer: 'manual',
+});
+await clientSession.opened;
+
+for (const expected of codes) {
+ const stream = await clientSession.createBidirectionalStream({
+ headers: {
+ ':method': 'GET',
+ ':path': '/',
+ ':scheme': 'https',
+ ':authority': 'localhost',
+ },
+ onheaders: mustCall(function(headers) {
+ assert.strictEqual(typeof headers[':status'], 'number');
+ assert.strictEqual(headers[':status'], expected);
+ }),
+ });
+ await stream.closed;
+}
+
+await serverDone.promise;
+await clientSession.close();
+await serverEndpoint.close();