Skip to content

http: free socket when response cannot have a body - #66865

Open
mweberxyz wants to merge 1 commit into
nodejs:mainfrom
mweberxyz:http-free-socket-when-response-cannot-have-a-body
Open

mweberxyz wants to merge 1 commit into
nodejs:mainfrom
mweberxyz:http-free-socket-when-response-cannot-have-a-body

Conversation

@mweberxyz

Copy link
Copy Markdown

HEAD requests and 204/304 status code responses cannot have a message body per RFC 9112, section 6.3.

This commit ensures that an http response that cannot have a body does not end up tying up the socket or keepalive pool.

This PR supersedes #52329, which I left long orphaned (apologies) and had flaws that change behavior of existing code in small ways (ordering of events, side effects).

Tests

The new test sends unconsumed HEAD, 204 and 304 requests through a keep-alive agent and checks that the process exits without hanging.

The test was extracted from the previous PR unchanged (except for the addition of comments) to ensure the new approach matches the behavior of the previous implementation. @aduh95 pushed a fix to my original tests, let me know if you would like me to add a Co-authored-by trailer to this commit.

AI assistance

Claude Code was used to identify flaws in the original approach, add comments to the test file, and verify the robustness of the implementation.

Per RFC 9112 section 6.3, responses to HEAD requests, and 204 and 304
responses, cannot contain a message body. When such a response is
complete and nobody has started reading it, release its socket back to
the agent's free pool instead of waiting for an 'end' that only a reader
can cause.

Refs: nodejs#47228
Assisted-by: claude:sonnet-5.5
Signed-off-by: Matt Weber <hello@mweber.xyz>
@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/http
  • @nodejs/net

@nodejs-github-bot nodejs-github-bot added http Issues and PRs related to the http subsystem. needs-ci PRs that need a full CI run. labels Oct 20, 2026
@github-actions

Copy link
Copy Markdown
Contributor

Welcome to Node.js, and thank you for your first contribution!

Before review, please take a moment to read:

Please make sure every commit is signed off. For a first pull request, GitHub Actions require collaborator approval and Jenkins CI must be started by a collaborator or triager, so an initial wait is normal.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

http Issues and PRs related to the http subsystem. needs-ci PRs that need a full CI run.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants