From d47a54accbb959c301abdb74c23f77e5468e8e13 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jind=C5=99ich=20B=C3=A4r?= Date: Sun, 1 Feb 2026 17:34:42 +0100 Subject: [PATCH 1/2] docs: add warning about HTTP/3 and proxy incompatibility Proxies are not supported when HTTP/3 is enabled. This documents the limitation in both Python and Node.js client options. Closes #364 Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude Co-Authored-By: Happy --- impit-node/index.d.ts | 4 ++++ impit-node/src/impit_builder.rs | 4 ++++ impit-python/python/impit/impit.pyi | 12 ++++++++++++ 3 files changed, 20 insertions(+) diff --git a/impit-node/index.d.ts b/impit-node/index.d.ts index a2498482..66c040f0 100644 --- a/impit-node/index.d.ts +++ b/impit-node/index.d.ts @@ -266,6 +266,8 @@ export interface ImpitOptions { * * Supports HTTP, HTTPS, SOCKS4 and SOCKS5 proxies. * + * **Warning:** Not supported when HTTP/3 is enabled. + * * @default `undefined` (no proxy) */ proxyUrl?: string @@ -274,6 +276,8 @@ export interface ImpitOptions { /** * Enable HTTP/3 support. * + * **Warning:** Proxies are not supported when HTTP/3 is enabled. + * * @default `false` */ http3?: boolean diff --git a/impit-node/src/impit_builder.rs b/impit-node/src/impit_builder.rs index 9bf9c0b3..75565141 100644 --- a/impit-node/src/impit_builder.rs +++ b/impit-node/src/impit_builder.rs @@ -60,12 +60,16 @@ pub struct ImpitOptions<'a> { /// /// Supports HTTP, HTTPS, SOCKS4 and SOCKS5 proxies. /// + /// **Warning:** Not supported when HTTP/3 is enabled. + /// /// @default `undefined` (no proxy) pub proxy_url: Option, /// Default timeout for this Impit instance in milliseconds. pub timeout: Option, /// Enable HTTP/3 support. /// + /// **Warning:** Proxies are not supported when HTTP/3 is enabled. + /// /// @default `false` pub http3: Option, /// Whether to follow redirects or not. diff --git a/impit-python/python/impit/impit.pyi b/impit-python/python/impit/impit.pyi index 7b38966e..6dceab15 100644 --- a/impit-python/python/impit/impit.pyi +++ b/impit-python/python/impit/impit.pyi @@ -385,11 +385,17 @@ class Client: .. note:: The HTTP/3 support is experimental and may not work with all servers. The impersonation capabilities are limited when using HTTP/3. + .. warning:: + Proxies are not supported when HTTP/3 is enabled. + proxy: The proxy URL to use for all the requests made by this client. This can be an HTTP, HTTPS, or SOCKS proxy. + + .. warning:: + Not supported when HTTP/3 is enabled. timeout: Default request timeout in seconds. @@ -716,11 +722,17 @@ class AsyncClient: .. note:: The HTTP/3 support is experimental and may not work with all servers. The impersonation capabilities are limited when using HTTP/3. + .. warning:: + Proxies are not supported when HTTP/3 is enabled. + proxy: The proxy URL to use for all the requests made by this client. This can be an HTTP, HTTPS, or SOCKS proxy. + + .. warning:: + Not supported when HTTP/3 is enabled. timeout: Default request timeout in seconds. From f592d60b32a37c2abbea823c15be4bf604df4e90 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jind=C5=99ich=20B=C3=A4r?= Date: Sun, 1 Feb 2026 17:38:07 +0100 Subject: [PATCH 2/2] chore: update yarn.lock --- impit-node/yarn.lock | 64 ++++++++++++++++++++++---------------------- 1 file changed, 32 insertions(+), 32 deletions(-) diff --git a/impit-node/yarn.lock b/impit-node/yarn.lock index 3ba66c15..f0c7baa8 100644 --- a/impit-node/yarn.lock +++ b/impit-node/yarn.lock @@ -2406,58 +2406,58 @@ __metadata: languageName: node linkType: hard -"impit-darwin-arm64@npm:0.8.2": - version: 0.8.2 - resolution: "impit-darwin-arm64@npm:0.8.2" +"impit-darwin-arm64@npm:0.9.0": + version: 0.9.0 + resolution: "impit-darwin-arm64@npm:0.9.0" conditions: os=darwin & cpu=arm64 languageName: node linkType: hard -"impit-darwin-x64@npm:0.8.2": - version: 0.8.2 - resolution: "impit-darwin-x64@npm:0.8.2" +"impit-darwin-x64@npm:0.9.0": + version: 0.9.0 + resolution: "impit-darwin-x64@npm:0.9.0" conditions: os=darwin & cpu=x64 languageName: node linkType: hard -"impit-linux-arm64-gnu@npm:0.8.2": - version: 0.8.2 - resolution: "impit-linux-arm64-gnu@npm:0.8.2" +"impit-linux-arm64-gnu@npm:0.9.0": + version: 0.9.0 + resolution: "impit-linux-arm64-gnu@npm:0.9.0" conditions: os=linux & cpu=arm64 & libc=glibc languageName: node linkType: hard -"impit-linux-arm64-musl@npm:0.8.2": - version: 0.8.2 - resolution: "impit-linux-arm64-musl@npm:0.8.2" +"impit-linux-arm64-musl@npm:0.9.0": + version: 0.9.0 + resolution: "impit-linux-arm64-musl@npm:0.9.0" conditions: os=linux & cpu=arm64 & libc=musl languageName: node linkType: hard -"impit-linux-x64-gnu@npm:0.8.2": - version: 0.8.2 - resolution: "impit-linux-x64-gnu@npm:0.8.2" +"impit-linux-x64-gnu@npm:0.9.0": + version: 0.9.0 + resolution: "impit-linux-x64-gnu@npm:0.9.0" conditions: os=linux & cpu=x64 & libc=glibc languageName: node linkType: hard -"impit-linux-x64-musl@npm:0.8.2": - version: 0.8.2 - resolution: "impit-linux-x64-musl@npm:0.8.2" +"impit-linux-x64-musl@npm:0.9.0": + version: 0.9.0 + resolution: "impit-linux-x64-musl@npm:0.9.0" conditions: os=linux & cpu=x64 & libc=musl languageName: node linkType: hard -"impit-win32-arm64-msvc@npm:0.8.2": - version: 0.8.2 - resolution: "impit-win32-arm64-msvc@npm:0.8.2" +"impit-win32-arm64-msvc@npm:0.9.0": + version: 0.9.0 + resolution: "impit-win32-arm64-msvc@npm:0.9.0" conditions: os=win32 & cpu=arm64 languageName: node linkType: hard -"impit-win32-x64-msvc@npm:0.8.2": - version: 0.8.2 - resolution: "impit-win32-x64-msvc@npm:0.8.2" +"impit-win32-x64-msvc@npm:0.9.0": + version: 0.9.0 + resolution: "impit-win32-x64-msvc@npm:0.9.0" conditions: os=win32 & cpu=x64 languageName: node linkType: hard @@ -2470,14 +2470,14 @@ __metadata: "@types/express": "npm:^5.0.0" "@types/node": "npm:^24.0.0" express: "npm:^5.0.0" - impit-darwin-arm64: "npm:0.8.2" - impit-darwin-x64: "npm:0.8.2" - impit-linux-arm64-gnu: "npm:0.8.2" - impit-linux-arm64-musl: "npm:0.8.2" - impit-linux-x64-gnu: "npm:0.8.2" - impit-linux-x64-musl: "npm:0.8.2" - impit-win32-arm64-msvc: "npm:0.8.2" - impit-win32-x64-msvc: "npm:0.8.2" + impit-darwin-arm64: "npm:0.9.0" + impit-darwin-x64: "npm:0.9.0" + impit-linux-arm64-gnu: "npm:0.9.0" + impit-linux-arm64-musl: "npm:0.9.0" + impit-linux-x64-gnu: "npm:0.9.0" + impit-linux-x64-musl: "npm:0.9.0" + impit-win32-arm64-msvc: "npm:0.9.0" + impit-win32-x64-msvc: "npm:0.9.0" proxy-chain: "npm:^2.5.9" socks-server-lib: "npm:^0.0.3" tough-cookie: "npm:^6.0.0"