npmpackage.info

Gathering detailed insights and metrics for proxy-agent

Other packages similar to proxy-agent

https-proxy-agent

7.0.6

An HTTP(s) proxy `http.Agent` implementation for HTTPS

http-proxy-agent

7.0.2

An HTTP(s) proxy `http.Agent` implementation for HTTP

socks-proxy-agent

8.0.5

A SOCKS proxy `http.Agent` implementation for HTTP and HTTPS

pac-proxy-agent

7.2.0

A PAC file proxy `http.Agent` implementation for HTTP

Gathering detailed insights and metrics for proxy-agent

proxy-agent - 6.5.0 | npmpackage.info

proxy-agent

Node.js HTTP Proxy Agents Monorepo

6.5.0

1,060

TypeScript

394.16 kB

1,696,196,126 3

Installations

npm install proxy-agent

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>= 14

Node Version

20.18.1

NPM Version

10.8.2 Score

68.1

Supply Chain

84.2

Quality

76.3

Maintenance

100

Vulnerability

99.6

License

Pull Requests

Open

13

Total

186

Closed

61

Merged

112

Issues

Open

30

Total

180

Closed

150

Releases

pac-proxy-agent@7.2.0

Updated on Feb 18, 2025

agent-base@7.1.3

Updated on Dec 08, 2024

socks-proxy-agent@8.0.5

Updated on Dec 07, 2024

proxy-agent@6.5.0

Updated on Dec 07, 2024

pac-proxy-agent@7.1.0

Updated on Dec 07, 2024

https-proxy-agent@7.0.6

Updated on Dec 07, 2024

View All 76 releases

Languages

TypeScript

JavaScript

TypeScript (93.57%)

JavaScript (6.43%)

Developer

TooTallNate

Download Statistics

Total Downloads

1,696,196,126

Last Day

705,658

Last Week

12,168,397

Last Month

52,423,800

Last Year

524,525,512

GitHub Statistics

1,060 Stars

298 Commits

258 Forks

19 Watchers

3 Branches

40 Contributors

Updated on Jul 01, 2025

Bundle Size

1.08 MB

Minified

394.16 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 40 Contributors

Package Meta Information

Latest Version

6.5.0

Package Id

proxy-agent@6.5.0

Unpacked Size

24.09 kB

Size

6.10 kB

File Count

NPM Version

10.8.2

Node Version

20.18.1

Published on

Dec 07, 2024

Total Downloads

Cumulative downloads

Total Downloads

1,696,196,126

Last Day

3.1%

705,658

Compared to previous day

Last Week

-6.5%

12,168,397

Compared to previous week

Last Month

2.1%

52,423,800

Compared to previous month

Last Year

38.5%

524,525,512

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

proxy-agent

Maps proxy protocols to `http.Agent` implementations

This module provides an http.Agent implementation which automatically uses proxy servers based off of the various proxy-related environment variables (HTTP_PROXY, HTTPS_PROXY and NO_PROXY among others).

Which proxy is used for each HTTP request is determined by the proxy-from-env module, so check its documentation for instructions on configuring your environment variables.

An LRU cache is used so that http.Agent instances are transparently re-used for subsequent HTTP requests to the same proxy server.

The currently implemented protocol mappings are listed in the table below:

Protocol	Proxy Agent for `http` requests	Proxy Agent for `https` requests	Example
`http`	http-proxy-agent	https-proxy-agent	`http://proxy-server-over-tcp.com:3128`
`https`	http-proxy-agent	https-proxy-agent	`https://proxy-server-over-tls.com:3129`
`socks(v5)`	socks-proxy-agent	socks-proxy-agent	`socks://username:password@some-socks-proxy.com:9050` (username & password are optional)
`socks5`	socks-proxy-agent	socks-proxy-agent	`socks5://username:password@some-socks-proxy.com:9050` (username & password are optional)
`socks4`	socks-proxy-agent	socks-proxy-agent	`socks4://some-socks-proxy.com:9050`
`pac-*`	pac-proxy-agent	pac-proxy-agent	`pac+http://www.example.com/proxy.pac`

Example

1import * as https from 'https';
2import { ProxyAgent } from 'proxy-agent';
3
4// The correct proxy `Agent` implementation to use will be determined
5// via the `http_proxy` / `https_proxy` / `no_proxy` / etc. env vars
6const agent = new ProxyAgent();
7
8// The rest works just like any other normal HTTP request
9https.get('https://jsonip.com', { agent }, (res) => {
10  console.log(res.statusCode, res.headers);
11  res.pipe(process.stdout);
12});

API

new ProxyAgent(options?: ProxyAgentOptions)

Creates an http.Agent instance which relies on the various proxy-related environment variables. An LRU cache is used, so the same http.Agent instance will be returned if identical args are passed in.

No vulnerabilities found.

10

Dangerous-Workflow

Determines if the project's GitHub Action workflows avoid dangerous patterns.

10

Binary-Artifacts

Determines if the project has generated executable (binary) artifacts in the source repository.

5

Code-Review

Determines if the project requires human code review before pull requests (aka merge requests) are merged.

1

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

0

Token-Permissions

Determines if the project's workflows follow the principle of least privilege.

0

Maintained

Determines if the project is "actively maintained".

0

CII-Best-Practices

Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.

0

Pinned-Dependencies

Determines if the project has declared and pinned the dependencies of its build process.

Reason

dependency not pinned by hash detected -- score normalized to 0

Details

Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:16: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/release.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:22: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/release.yml:27: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/release.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/release.yml:40: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/release.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:119: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/test.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:122: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/test.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:127: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/test.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:30: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/test.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:33: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/test.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:38: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/test.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:56: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/test.yml/main?enable=pin
Warn: third-party GitHubAction not pinned by hash: .github/workflows/test.yml:59: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/test.yml/main?enable=pin
Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/test.yml:64: update your workflow using https://app.stepsecurity.io/secureworkflow/TooTallNate/proxy-agents/test.yml/main?enable=pin
Info: 0 out of 8 GitHub-owned GitHubAction dependencies pinned
Info: 0 out of 5 third-party GitHubAction dependencies pinned

0

License

Determines if the project has defined a license.

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

SAST

Determines if the project uses static code analysis.

Score

3

/10

Last Scanned on 2025-06-30

The Open Source Security Foundation is a cross-industry collaboration to improve the security of open source software (OSS). The Scorecard provides security health metrics for open source projects.

Learn More

Other packages similar to proxy-agent

Other packages similar to proxy-agent

proxy-agent

Installations

Developer Guide

Yes

CommonJS

>= 14

20.18.1

10.8.2

Score

Pull Requests

13

186

61

112

Issues

30

180

150

Releases

Languages

Developer

Download Statistics

GitHub Statistics

Bundle Size

1.08 MB

394.16 kB

Maintainers

Package Meta Information

Total Downloads

1,696,196,126

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dependencies

Dev Dependencies

proxy-agent

Maps proxy protocols to http.Agent implementations

Example

API

new ProxyAgent(options?: ProxyAgentOptions)

10

10

5

1

0

0

0

0

0

0

0

0

3

/10

Maps proxy protocols to `http.Agent` implementations