sessionOptions.application


HTTP/3 应用特定选项。仅在协商的 ALPN 选择 HTTP/3 应用('h3')时适用。

🌐 HTTP/3 application-specific options. These only apply when the negotiated ALPN selects the HTTP/3 application ('h3').

  • maxHeaderPairs <number> 每个头块接收的最大头名称-值对数量。超过此限制的头将被静默丢弃。默认值: 128
  • maxHeaderLength <number> 每个头块中所有头名称和值总和的最大字节长度。会将导致总长度超过此限制的头静默丢弃。默认值:8192
  • maxFieldSectionSize <number> 压缩头字段部分的最大尺寸(QPACK)。0 表示无限制。默认值: 0
  • qpackMaxDTableCapacity <number> QPACK 动态表容量(字节)。设置为 0 可禁用动态表。默认值: 4096
  • qpackEncoderMaxDTableCapacity <number> QPACK 编码器最大动态表容量。默认值: 4096
  • qpackBlockedStreams <number> 等待 QPACK 动态表更新时可以被阻塞的最大流数。默认值: 100
  • enableConnectProtocol <boolean> 启用扩展 CONNECT 协议 (RFC 9220)。默认值:false
  • enableDatagrams <boolean> 启用 HTTP/3 数据报(RFC 9297)。默认值:false
const { listen } = await import('node:quic');

await listen((session) => { /* ... */ }, {
  application: {
    maxHeaderPairs: 64,
    qpackMaxDTableCapacity: 8192,
    enableDatagrams: true,
  },
  // ... other session options
});