Skip to content

http: normalize CONNECT request paths - #64876

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

http: normalize CONNECT request paths#64876
efekrskl wants to merge 2 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 97.14286% with 1 line in your changes missing coverage. Please review.
βœ… Project coverage is 90.29%. Comparing base (a46087d) to head (673924c).

Files with missing lines Patch % Lines
lib/_http_client.js 97.14% 1 Missing ⚠️
Additional details and impacted files
@@            Coverage Diff             @@
##             main   #64876      +/-   ##
==========================================
- Coverage   90.29%   90.29%   -0.01%     
==========================================
  Files         760      760              
  Lines      247061   247094      +33     
  Branches    46584    46601      +17     
==========================================
+ Hits       223096   223120      +24     
- Misses      15437    15454      +17     
+ Partials     8528     8520       -8     
Files with missing lines Coverage Ξ”
lib/_http_client.js 97.61% <97.14%> (-0.02%) ⬇️

... and 25 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
if (!isValidConnectPath(path)) {
throw new ERR_INVALID_ARG_VALUE(
'options.path',
path,

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: because this isn't options.path, we print the normalized value, not what the user actually passed.

Comment thread lib/_http_client.js

this[kPath] = options.path || '/';
let path = options.path || '/';
if (method === 'CONNECT' && options.path != null) {

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: path defaults to /, but then this checks options.path.

That means if you set no path, we will send /, but if you set path: '/' then we throw. We should make those consistent.

Comment thread lib/_http_client.js
}

if (!isValidConnectPath(path)) {
throw new ERR_INVALID_ARG_VALUE(

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This didn't used to throw, in fact it would have sent the path successfully. Servers could potentially accept it and use that (they shouldn't, but it's quite possible that weird ones do anyway) or people might have test suites that send invalid values to confirm they're rejected by their server implementation. With this change that working code would validate and throw instead.

@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?

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