socks-proxy-agent
10.1.0 · 8 Jun 2026MIT70.4M / weekRepositoryHomepagenpmAtom feed
33 stable releases, newest first, by release line. Notes are quoted as the maintainers published them.
- 10.x · latest line
10.1.0
8 Jun 2026Add
proxyevent emission on the request object for all proxy agents. After the proxy connection is established, the request emits aproxyevent with{ proxy, socket }whereproxyis the proxy URL string. This is useful for debugging and logging which proxy was used for a connection.
10.0.0
1 Apr 2026- Breaking
Set minimum Node.js version to 20
Simplify package.json exports to remove unnecessary imports restriction
Major Changes
- Breaking
Set minimum Node.js version to 20
Patch Changes
Simplify package.json exports to remove unnecessary imports restriction
- 9.x
9.0.0
11 Mar 2026- Breaking
Convert to ESM. All packages now use
"type": "module"and compile to ESM output instead of CommonJS.
Major Changes
- Breaking
Convert to ESM. All packages now use
"type": "module"and compile to ESM output instead of CommonJS.
- 8.x
8.0.5
7 Dec 2024Only overwrite servername in tls connect when host is not an IP address
Patch Changes
Only overwrite servername in tls connect when host is not an IP address
8.0.4
28 Jun 2024- Security
Resolve vulnerability in IP package
Remove
net.isIP()check for TLSservername
8.0.3
30 Mar 2024Pass
socket_optionstoSocksClient
Patch Changes
Pass
socket_optionstoSocksClient
8.0.2
4 Sep 2023Fix Electron support by using Node.js native URL object
8.0.1
5 May 2023Only updates dependencies:agent-base 7.0.1@types/node 14.18.45
8.0.0
4 May 2023- Breaking
Major version bump for all packages
- Breaking
Argument 1: Either (A) a
string, or (B) a WHATWGURLobject - Breaking
Argument 2 (optional): An object with standard
http.Agentproperties.
Major Changes
- Breaking
Major version bump for all packages
⚠️ This is a breaking change! The
SocksProxyAgentconstructor argument has been split into two arguments.
Upgrading from 5.x to 6.x
In version 5.x, the
SocksProxyAgentconstructor took a single argument of either (A) astring, or (B) an object with specific connection properties.Now the constructor takes two separate arguments:
- Breaking
Argument 1: Either (A) a
string, or (B) a WHATWGURLobject - Breaking
Argument 2 (optional): An object with standard
http.Agentproperties.
If you were using an object argument in 7.x, you'll need to change the first argument to match the structure of the
URLclass, and move any other options to the second argument.7.x usage:
const agent = new SocksProxyAgent({ hostname: 'myproxy.mydomain.com', userId: 'proxyUser', password: 'proxyPass' timeout: 1000 });Updated 8.x usage:
const agent = new SocksProxyAgent( { hostname: 'myproxy.mydomain.com' username: 'proxyUser', password: 'proxyPass' }, { timeout: 1000 } );Minor Changes
Add support for core
keepAlive: true
Patch Changes
Convert mocha tests to jest for all packages
- 7.x
7.0.0
31 May 2022- 6.x
- 5.x
5.0.0
4 Feb 2020- Breaking
Refactor to TypeScript
- 4.x
4.0.0
29 Mar 2018- 3.x
3.0.1
18 Sep 20173.0.0
13 Jun 2017- Breaking
Remove Node 5 and 7 from Travis: 590bc8b
- Breaking
Remove Node 4 from Travis: 6c804a2
Update
proxyto v1.0.0: d0e3c18
This release fixes the MitM vulnerability reported via HackerOne. It is a breaking change because Node 4, 5, and 7 are no longer tested in CI (note that Node 6 is still supported).
Major Changes
Minor Changes
Update
proxyto v1.0.0: d0e3c18Test on Node.js 10 and 12: 3535951
Fix compatibility with Node.js >= 10.0.0
Add
.editorconfigfile: 06ead2fAdd
.eslintrc.jsfile: ae53572
Patches
Update README with correct
secureProxybehaviorRemove unreachable code: 46aad09
Allow
portto be a stringUse an
EventEmitterto replay failed proxy connect HTTP requests
- 2.x
- 1.x
- 0.1.x
- 0.0.x
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.