Skip to content

http: normalize CONNECT request paths - #64876

Open
efekrskl wants to merge 3 commits into
nodejs:mainfrom
efekrskl:fix/http-connect-path-url
Open

efekrskl wants to merge 3 commits into
nodejs:mainfrom
efekrskl:fix/http-connect-path-url

Conversation

@efekrskl

Copy link
Copy Markdown
Member

Fixes #34347

Partially a revival of #34412 which was apparently moving in the right direction but got stalled and closed

@nodejs-github-bot

Copy link
Copy Markdown
Collaborator

Review requested:

  • @nodejs/http
  • @nodejs/net

@efekrskl
efekrskl force-pushed the fix/http-connect-path-url branch from 987fc94 to 8172f67 Compare July 31, 2026 16:37
@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 Jul 31, 2026
Comment thread lib/_http_client.js Outdated
Comment thread lib/_http_client.js Outdated
@codecov

codecov Bot commented Jul 31, 2026

Copy link
Copy Markdown

Codecov Report

❌ Patch coverage is 94.44444% with 1 line in your changes missing coverage. Please review.
βœ… Project coverage is 90.26%. Comparing base (a46087d) to head (be15e66).
⚠️ Report is 882 commits behind head on main.

Files with missing lines Patch % Lines
lib/_http_client.js 94.44% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main   #64876      +/-   ##
==========================================
- Coverage   90.29%   90.26%   -0.04%     
==========================================
  Files         760      789      +29     
  Lines      247061   271499   +24438     
  Branches    46584    51818    +5234     
==========================================
+ Hits       223096   245064   +21968     
- Misses      15437    16902    +1465     
- Partials     8528     9533    +1005     
Files with missing lines Coverage Ξ”
lib/_http_client.js 97.38% <94.44%> (-0.26%) ⬇️

... and 397 files with indirect coverage changes

πŸš€ New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
  • πŸ“¦ JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

@efekrskl
efekrskl requested a review from anonrig August 1, 2026 12:46
@efekrskl
efekrskl force-pushed the fix/http-connect-path-url branch from 7cb68d6 to 673924c Compare August 1, 2026 12:55
Comment thread lib/_http_client.js Outdated
Comment thread lib/_http_client.js Outdated
Comment thread lib/_http_client.js Outdated
@pimterry

pimterry commented Sep 2, 2026

Copy link
Copy Markdown
Member

Sorry it's taken me so long to get to this. I've put some comments here, but I think generally I'm -0.5 on this. As is, I think it can be a breaking change, and the upside is quite small.

More broadly, it changes the scope of HTTP validation we do in these APIs. Right now we don't do anything similar for other methods - we enforce syntactic correctness (no unescaped spaces, must be correctly framed & parseable) but we don't generally police anything else beyond that. If you want to send random strings as a cookie header, or send GET ??? or Host: ??? then you can (I just tested). We make sure your data gets delivered in an unambiguous form, we leave the interpretation errors to the remote server.

We could change that, it's an interesting idea, but if we're going to break this we might as well do something much larger. And to be honest I think it's not helpful: there's plenty of use cases for sending weird HTTP, notably including testing that your server correctly rejects it. This fits into a broader discussion about node:http vs Fetch APIs, where I think we're slowly aligning towards supporting parallel raw low-level with node:http vs high-level with guardrails fetch.

I think there's a central core we can do here safely and sensibly, roughly: if you specifically pass a URL as the request target and the method is CONNECT, then use the path without any leading slash as the target. No new errors or further validation. The risk of breakage there I think is much smaller (URL usage like this is quite unusual anyway, the correct behaviour was always ambiguous, and it'd only break for servers who exclusively accept the wrong format) and it solves the original issue. What do you think @efekrskl?

@efekrskl

Copy link
Copy Markdown
Member Author

@pimterry thanks for the detailed review! Good points, and I agree.

I've narrowed down the change quite a bit to only strip the leading slash from URL derived CONNECT targets. This should keep the fix as surgical as possible while still solving the original issue.

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.

Passing a URL instance with a CONNECT method results in an invalid path

4 participants