npmpackage.info

Gathering detailed insights and metrics for https-proxy-agent

Other packages similar to https-proxy-agent

socks-proxy-agent

8.0.5

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

proxy-agent

6.5.0

Maps proxy protocols to `http.Agent` implementations

pac-proxy-agent

7.2.0

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

global-agent

3.0.0

Global HTTP/HTTPS proxy configurable using environment variables.

Gathering detailed insights and metrics for https-proxy-agent

https-proxy-agent - 7.0.6 | npmpackage.info

https-proxy-agent

Node.js HTTP Proxy Agents Monorepo

7.0.6

1,061

TypeScript

5.01 kB

10,775,437,438 3

Installations

npm install https-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

97.6

Supply Chain

89.9

Quality

76.9

Maintenance

100

Vulnerability

100

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

10,775,437,438

Last Day

4,505,919

Last Week

81,660,366

Last Month

351,496,885

Last Year

3,608,629,460

GitHub Statistics

1,061 Stars

298 Commits

258 Forks

19 Watchers

3 Branches

40 Contributors

Updated on Jul 03, 2025

Bundle Size

14.40 kB

Minified

5.01 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 40 Contributors

Package Meta Information

Latest Version

7.0.6

Package Id

https-proxy-agent@7.0.6

Unpacked Size

34.33 kB

Size

8.79 kB

File Count

NPM Version

10.8.2

Node Version

20.18.1

Published on

Dec 07, 2024

Total Downloads

Cumulative downloads

Total Downloads

10,775,437,438

Dependencies

agent-base debug

Dev Dependencies

@types/async-retry @types/debug @types/jest @types/node async-listen async-retry jest ts-jest typescript proxy tsconfig

https-proxy-agent

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

This module provides an http.Agent implementation that connects to a specified HTTP or HTTPS proxy server, and can be used with the built-in https module.

Specifically, this Agent implementation connects to an intermediary "proxy" server and issues the CONNECT HTTP method, which tells the proxy to open a direct TCP connection to the destination server.

Since this agent implements the CONNECT HTTP method, it also works with other protocols that use this method when connecting over proxies (i.e. WebSockets). See the "Examples" section below for more.

Examples

`https` module example

1import * as https from 'https';
2import { HttpsProxyAgent } from 'https-proxy-agent';
3
4const agent = new HttpsProxyAgent('http://168.63.76.32:3128');
5
6https.get('https://example.com', { agent }, (res) => {
7  console.log('"response" event!', res.headers);
8  res.pipe(process.stdout);
9});

`ws` WebSocket connection example

1import WebSocket from 'ws';
2import { HttpsProxyAgent } from 'https-proxy-agent';
3
4const agent = new HttpsProxyAgent('http://168.63.76.32:3128');
5const socket = new WebSocket('ws://echo.websocket.org', { agent });
6
7socket.on('open', function () {
8  console.log('"open" event!');
9  socket.send('hello world');
10});
11
12socket.on('message', function (data, flags) {
13  console.log('"message" event! %j %j', data, flags);
14  socket.close();
15});

API

new HttpsProxyAgent(proxy: string | URL, options?: HttpsProxyAgentOptions)

The HttpsProxyAgent class implements an http.Agent subclass that connects to the specified "HTTP(s) proxy server" in order to proxy HTTPS and/or WebSocket requests. This is achieved by using the HTTP CONNECT method.

The proxy argument is the URL for the proxy server.

The options argument accepts the usual http.Agent constructor options, and some additional properties:

headers - Object containing additional headers to send to the proxy server in the CONNECT request.

Critical

9.1/10

Summary

Denial of Service in https-proxy-agent

Affected Versions

< 2.2.0

Patched Versions

2.2.0

High

0/10

Summary

Denial of Service in https-proxy-agent

Affected Versions

< 2.2.0

Patched Versions

2.2.0

Moderate

6.1/10

Summary

Machine-In-The-Middle in https-proxy-agent

Affected Versions

< 2.2.3

Patched Versions

2.2.3

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 https-proxy-agent

Other packages similar to https-proxy-agent

https-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

14.40 kB

5.01 kB

Maintainers

Package Meta Information

Total Downloads

10,775,437,438

Dependencies

Dev Dependencies

https-proxy-agent

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

Examples

https module example

ws WebSocket connection example

API

new HttpsProxyAgent(proxy: string | URL, options?: HttpsProxyAgentOptions)

10

10

5

1

0

0

0

0

0

0

0

0

3

/10

Weekly Downloads

Monthly Downloads

Yearly Downloads

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

`https` module example

`ws` WebSocket connection example