Gathering detailed insights and metrics for https-proxy-agent
Gathering detailed insights and metrics for https-proxy-agent
Installations
npm install https-proxy-agentDeveloper 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
Releases
76
pac-proxy-agent@7.2.0
pac-proxy-agent@7.2.0
Updated on Feb 18, 2025
agent-base@7.1.3
agent-base@7.1.3
Updated on Dec 08, 2024
socks-proxy-agent@8.0.5
socks-proxy-agent@8.0.5
Updated on Dec 07, 2024
proxy-agent@6.5.0
proxy-agent@6.5.0
Updated on Dec 07, 2024
pac-proxy-agent@7.1.0
pac-proxy-agent@7.1.0
Updated on Dec 07, 2024
https-proxy-agent@7.0.6
https-proxy-agent@7.0.6
Updated on Dec 07, 2024
Languages
2
TypeScript
JavaScript
TypeScript (93.57%)
JavaScript (6.43%)
Developer
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
Maintainers
1
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
12
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
Last Day
-4.2%
4,505,919
Compared to previous day
Last Week
-6.8%
81,660,366
Compared to previous week
Last Month
3.1%
351,496,885
Compared to previous month
Last Year
38.8%
3,608,629,460
Compared to previous year
Weekly Downloads
Monthly Downloads
Yearly Downloads
Dependencies
2
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 theCONNECTrequest.
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
Reason
no dangerous workflow patterns detected
Reason
no binaries found in the repo
Reason
Found 13/23 approved changesets -- score normalized to 5
Reason
9 existing vulnerabilities detected
Details
- Warn: Project is vulnerable to: GHSA-968p-4wvh-cqc8
- Warn: Project is vulnerable to: GHSA-67hx-6x53-jw92
- Warn: Project is vulnerable to: GHSA-v6h2-p8h4-qcjw
- Warn: Project is vulnerable to: GHSA-grv7-fg5c-xmjg
- Warn: Project is vulnerable to: GHSA-6cpc-mj5c-m9rq
- Warn: Project is vulnerable to: GHSA-3xgq-45jj-v275
- Warn: Project is vulnerable to: GHSA-952p-6rrq-rcjv
- Warn: Project is vulnerable to: GHSA-c2qf-rxjj-qqgw
- Warn: Project is vulnerable to: GHSA-3h5v-q93c-6h6q
Reason
detected GitHub workflow tokens with excessive permissions
Details
- Warn: no topLevel permission defined: .github/workflows/release.yml:1
- Warn: no topLevel permission defined: .github/workflows/test.yml:1
- Info: no jobLevel write permissions found
Reason
0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0
Reason
no effort to earn an OpenSSF best practices badge detected
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
Reason
license file not detected
Details
- Warn: project does not have a license file
Reason
security policy file not detected
Details
- Warn: no security policy file detected
- Warn: no security file to analyze
- Warn: no security file to analyze
- Warn: no security file to analyze
Reason
project is not fuzzed
Details
- Warn: no fuzzer integrations found
Reason
SAST tool is not run on all commits -- score normalized to 0
Details
- Warn: 0 commits out of 28 are checked with a SAST tool
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