https-proxy-agent
npmv9.1.0An HTTP(s) proxy `http.Agent` implementation for HTTPS
Safe to adopt
Yes — https-proxy-agent scores well across adoption, maintenance, weight, supply chain, and licensing. 225.1M downloads per week and 10 known dependents. Last published 93 days ago. 4 releases in the last 2 years.
- AAdoption: grade A, Excellent.
225.1M downloads per week and 10 known dependents.
- BMaintenance: grade B, Good.
Last published 93 days ago. 4 releases in the last 2 years.
- AWeight: grade A, Excellent.
Pulls in 4 transitive packages, about 106 KB installed.
- 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 https-proxy-agent to a project.
Runtime packages this one declares itself.
Distinct packages in the full runtime tree, deduplicated the way a package manager would.
Unpacked size of this package plus its entire runtime tree.
Longest resolved dependency chain below this package.
Licenses in the dependency tree
Every license you inherit by installing https-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 https-proxy-agent README.
import * as https from 'https';
import { HttpsProxyAgent } from 'https-proxy-agent';
const agent = new HttpsProxyAgent('http://168.63.76.32:3128');
https.get('https://example.com', { agent }, (res) => {
console.log('"response" event!', res.headers);
res.pipe(process.stdout);
});https-proxy-agent vs the alternatives
Packages solving a similar problem in the npm ecosystem, compared on the signals that drive an adoption decision.
| Package | Weekly downloads | Dependents | License | Last release |
|---|---|---|---|---|
| https-proxy-agentthis page | 225.1M | 10 | MIT | 3 months ago |
| http-proxy-agent | 0 | 5 | MIT | 1 day ago |
| socks-proxy-agent | 0 | 3 | MIT | 1 day ago |
| pac-proxy-agent | 0 | 1 | MIT | 1 day ago |
| proxy-agent | 0 | 1 | MIT | 1 day ago |
| agent-base | 0 | 6 | MIT | 1 day ago |
Dependencies
Declared by https-proxy-agent v9.1.0. Runtime dependencies are installed with the package; dev dependencies are not.
Dev (8)
Used by
Popular packages that depend on https-proxy-agent.
Promise based HTTP client for the browser and node.js
Low-level network interception library for Node.js.
A Node.js bindings implementation for the W3C WebDriver and Mobile JSONWire Protocol
Microsofts' EdgeDriver for Node.js
Mozilla's Geckodriver for Node.js
A simple common HTTP client specifically for Google APIs and services.
🚇 Cache layers for Metro.
Maps proxy protocols to `http.Agent` implementations
A PAC file proxy `http.Agent` implementation for HTTP
the http/https agent used by the npm cli
Relationship graph
Dependencies (left) and dependents (right) of https-proxy-agent.
Frequently installed together
TypeScript definitions for node
TypeScript definitions for ws
An HTTP/1.1 client, written from scratch for Node.js
A helper utility for logging of WebdriverIO packages
Fast, unopinionated, minimalist web framework
A helper utility to parse and validate WebdriverIO options
Utility package providing information about automation protocols
Utility package providing type information for a variety of WebdriverIO interfaces
A WDIO helper utility to provide several utility functions used across the project.
Next generation testing framework powered by Vite
A light-weight module that brings Fetch API to node.js
HTTP and HTTPS modules that follow redirects.
Release history
4 releases in the last two years, typically about 47 days apart.
| Version | Published | Size | License |
|---|---|---|---|
| 9.1.0latest | 3 months ago | 33 KB | MIT |
| 9.0.0 | 5 months ago | 25 KB | MIT |
| 8.0.0 | 6 months ago | 25 KB | MIT |
| 7.0.6 | 1 year ago | 34 KB | MIT |
| 7.0.5 | 2 years ago | 34 KB | MIT |
| 7.0.4 | 2 years ago | 34 KB | MIT |
| 7.0.3 | 2 years ago | 34 KB | MIT |
| 7.0.2 | 3 years ago | 34 KB | MIT |
| 7.0.1 | 3 years ago | 34 KB | MIT |
| 7.0.0 | 3 years ago | 34 KB | MIT |
| 6.2.1 | 3 years ago | 34 KB | MIT |
| 6.2.0 | 3 years ago | 34 KB | MIT |
| 6.1.0 | 3 years ago | 34 KB | MIT |
| 6.0.0 | 3 years ago | 31 KB | MIT |
| 5.0.1 | 4 years ago | 25 KB | MIT |
Overview
https-proxy-agent is an npm package that an HTTP(s) proxy `http.Agent` implementation for HTTPS. It is extremely widely used, with about 225.1M downloads per week and 10 known dependents in the graph. The latest version is 9.1.0, released under the MIT license.
Who should use it
Teams working in the npm ecosystem who need an HTTP(s) proxy `http.Agent` implementation for HTTPS and value a battle-tested, widely-adopted solution.
When not to use it
Consider an alternative if you need to have first-class TypeScript types out of the box, or if a more actively-maintained option better fits your npm stack.
Pros
- Large, well-established user base (225.1M weekly downloads).
- Clear open-source license (MIT).
Cons
- No bundled TypeScript types (may require a separate @types package).
Auto-generated from collected registry metadata. No external claims are inferred.
Maintainers
Frequently asked questions
Should I use https-proxy-agent?
Yes — https-proxy-agent scores well across adoption, maintenance, weight, supply chain, and licensing. 225.1M downloads per week and 10 known dependents. Last published 93 days ago. 4 releases in the last 2 years.
How do I install https-proxy-agent?
Run `npm install https-proxy-agent` to add https-proxy-agent to your npm project.
How many dependencies does https-proxy-agent have?
https-proxy-agent declares 11 direct dependencies and pulls in 4 packages in total once its runtime tree is resolved totalling about 106 KB on disk.
What license is https-proxy-agent released under?
https-proxy-agent is distributed under the MIT license.
How popular is https-proxy-agent?
https-proxy-agent has approximately 225,102,746 downloads per week and 10 known dependent packages.
Is https-proxy-agent still maintained?
The most recent release of https-proxy-agent (v9.1.0) was published 3 months ago.
Does https-proxy-agent run install scripts?
No. https-proxy-agent does not define preinstall, install, or postinstall scripts, so installing it does not execute publisher-supplied code.