Skip to content

doc: correct HTTP/2 HTTP/1 keepAliveTimeout default - #65189

Closed
arhxam wants to merge 1 commit into
nodejs:mainfrom
arhxam:doc-http2-http1-keepalive-default
Closed

doc: correct HTTP/2 HTTP/1 keepAliveTimeout default#65189
arhxam wants to merge 1 commit into
nodejs:mainfrom
arhxam:doc-http2-http1-keepalive-default

Conversation

@arhxam

@arhxam arhxam commented Aug 10, 2026

Copy link
Copy Markdown

Description

Both http2.createServer() and http2.createSecureServer() document the
default http1Options.keepAliveTimeout as 5000 milliseconds.

When HTTP/1 fallback is enabled, HTTP/2 passes http1Options to
storeHTTPOptions(). An omitted value therefore receives the current HTTP
server default of 65000 milliseconds, not 5000. A secure HTTP/2 server created
with allowHTTP1: true reports server.keepAliveTimeout === 65000.

This updates both API entries and records the underlying default change.
Documentation-only change.

HTTP/2 passes http1Options to storeHTTPOptions() when HTTP/1
fallback is enabled. An omitted keepAliveTimeout therefore uses the
current HTTP server default of 65 seconds, not 5 seconds. Correct both
API entries and record the underlying default change.

Signed-off-by: Arham Wani <arhamwani765@gmail.com>
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/http
  • @nodejs/http2
  • @nodejs/net

@nodejs-github-bot nodejs-github-bot added doc Issues and PRs related to the documentations. http2 Issues or PRs related to the http2 subsystem. labels Aug 10, 2026
@aduh95 aduh95 closed this Aug 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

doc Issues and PRs related to the documentations. http2 Issues or PRs related to the http2 subsystem.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants