</>PackageGraphPackageGraph

proxy-agent

npmv8.0.2

Maps proxy protocols to `http.Agent` implementations

Adopt with care

proxy-agent is usable, with caveats. Pulls in 24 transitive packages, about 3.0 MB installed (at least — some of the tree is still being crawled).

  • ?Adoption: grade ?, Not reported by this registry.

    No download data reported for this package yet.

  • BMaintenance: grade B, Good.

    Last published 93 days ago. 5 releases in the last 2 years.

  • CWeight: grade C, Fair — worth a look.

    Pulls in 24 transitive packages, about 3.0 MB installed (at least — some of the tree is still being crawled).

  • BSupply chain: grade B, Good.

    This package has a single maintainer (bus factor of 1).

  • ALicense: grade A, Excellent.

    MIT — permissive, with no copyleft found in the dependency tree.

Grades are computed deterministically from registry metadata collected by PackageGraph — downloads, dependents, publish dates, the resolved dependency tree, maintainer count, and declared licenses. No third-party scores are used.

Install cost

What you actually take on by adding proxy-agent to a project.

8
Direct dependencies

Runtime packages this one declares itself.

24
Total installed

Distinct packages in the full runtime tree, deduplicated the way a package manager would.

3.0 MB
Install size

Unpacked size of this package plus its entire runtime tree.

5
Tree depth

Longest resolved dependency chain below this package.

Part of this dependency tree has not been crawled yet, so these figures are a lower bound rather than a final total.

Licenses in the dependency tree

BSD-2-ClauseBSD-3-ClauseMIT

Every license you inherit by installing proxy-agent, not just its own. Check this before a legal review, not after.

Compatibility

Node.js
node >= 20
Module format
ESM only
TypeScript
No bundled types
Install scripts
None

Quick start

A usage example from the proxy-agent README.

tsFull README ↗
import * as https from 'https';
import { ProxyAgent } from 'proxy-agent';

// The correct proxy `Agent` implementation to use will be determined
// via the `http_proxy` / `https_proxy` / `no_proxy` / etc. env vars
const agent = new ProxyAgent();

// The rest works just like any other normal HTTP request
https.get('https://jsonip.com', { agent }, (res) => {
  console.log(res.statusCode, res.headers);
  res.pipe(process.stdout);
});

proxy-agent vs the alternatives

Packages solving a similar problem in the npm ecosystem, compared on the signals that drive an adoption decision.

PackageWeekly downloadsDependentsLicenseLast release
proxy-agentthis page01MIT3 months ago
socks-proxy-agent03MIT1 day ago
pac-proxy-agent01MIT1 day ago
https-proxy-agent225.1M10MIT1 day ago
agent-base06MIT1 day ago
http-proxy-agent05MIT1 day ago

Dependencies

Declared by proxy-agent v8.0.2. Runtime dependencies are installed with the package; dev dependencies are not.

Runtime (8)

agent-base 9.0.0debug ^4.3.4http-proxy-agent 9.1.0https-proxy-agent 9.1.0lru-cache ^7.14.1pac-proxy-agent 9.1.0proxy-from-env ^2.0.0socks-proxy-agent 10.1.0

Dev (11)

@types/agent-base ^4.2.0@types/debug ^4.1.7@types/node ^22.13.0@types/proxy-from-env ^1.0.1@types/ws ^8.5.4async-listen ^3.0.0proxy 4.1.0socksv5 github:TooTallNate/socksv5#d937368b28e929396166d77a06d387a4a902bd51tsconfig 0.0.0typescript ^5.1.6ws ^8.20.1

Used by

Popular packages that depend on proxy-agent.

@puppeteer/browsersnpm

Download and launch browsers

↓ 0/wk◈ 3 dependents⚖ Apache-2.0TS

Relationship graph

Dependencies (left) and dependents (right) of proxy-agent.

proxy-from-envagent-basehttp-proxy-agenthttps-proxy-agentpac-proxy-agentsocks-proxy-agentdebug@puppeteer/browse…proxy-agent
proxy-agent dependencies dependents

Frequently installed together

@types/yargsnpm

TypeScript definitions for yargs

↓ 0/wk◈ 7 dependents⚖ MITTS
yargsnpm

yargs the modern, pirate-themed, successor to optimist.

↓ 0/wk◈ 12 dependents⚖ MIT
modern-tarnpm

Zero dependency streaming tar parser and writer for JavaScript.

↓ 0/wk◈ 3 dependents⚖ MITTS

Release history

5 releases in the last two years, typically about 50 days apart.

Recent versions of proxy-agent
VersionPublishedSizeLicense
8.0.2latest3 months ago17 KBMIT
8.0.15 months ago17 KBMIT
8.0.05 months ago17 KBMIT
7.0.06 months ago17 KBMIT
6.5.01 year ago24 KBMIT
6.4.02 years ago23 KBMIT
6.3.13 years ago23 KBMIT
6.3.03 years ago23 KBMIT
6.2.23 years ago23 KBMIT
6.2.13 years ago23 KBMIT
6.2.03 years ago22 KBMIT
6.1.23 years ago22 KBMIT
6.1.13 years ago22 KBMIT
6.1.03 years ago20 KBMIT
6.0.03 years ago19 KBMIT

Overview

proxy-agent is an npm package that maps proxy protocols to `http.Agent` implementations. It has 1 known dependents in the graph. The latest version is 8.0.2, released under the MIT license.

Who should use it

Teams working in the npm ecosystem who need maps proxy protocols to `http.Agent` implementations and value a focused solution.

When not to use it

Consider an alternative if you need to minimize your dependency tree, have first-class TypeScript types out of the box, or if a more actively-maintained option better fits your npm stack.

Pros

  • Clear open-source license (MIT).

Cons

  • Large dependency tree (19 direct dependencies) increases install size and audit surface.
  • No bundled TypeScript types (may require a separate @types package).

Auto-generated from collected registry metadata. No external claims are inferred.

Maintainers

tootallnate

Keywords

agenthttphttpsmappingproxysocks

Frequently asked questions

Should I use proxy-agent?

proxy-agent is usable, with caveats. Pulls in 24 transitive packages, about 3.0 MB installed (at least — some of the tree is still being crawled).

How do I install proxy-agent?

Run `npm install proxy-agent` to add proxy-agent to your npm project.

How many dependencies does proxy-agent have?

proxy-agent declares 19 direct dependencies and pulls in 24 packages in total once its runtime tree is resolved totalling about 3.0 MB on disk.

What license is proxy-agent released under?

proxy-agent is distributed under the MIT license. Its dependency tree also includes: BSD-2-Clause, BSD-3-Clause, MIT.

How popular is proxy-agent?

npm does not publish download counts. Within PackageGraph's crawl, 1 known packages depend on proxy-agent.

Is proxy-agent still maintained?

The most recent release of proxy-agent (v8.0.2) was published 3 months ago.

Does proxy-agent run install scripts?

No. proxy-agent does not define preinstall, install, or postinstall scripts, so installing it does not execute publisher-supplied code.