npmpackage.info

Gathering detailed insights and metrics for hpagent

Other packages similar to hpagent

hpagent-catchfix

1.2.0

A ready to use http and https agent for working with proxies that keeps connections alive!

hpagent-custom-headers

0.1.2

A ready to use http and https agent for working with proxies that keeps connections alive!. Forked from 'https://github.com/delvedor/hpagent'

hpagent

A ready to use http and https agent for working with proxies that keeps connections alive!

1.2.0

185

MIT

JavaScript

786.00 B

256,658,148 3.6

Installations

npm install hpagent

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS, ESM

Min. Node Version

>=14

Node Version

16.14.2

NPM Version

8.5.0 Score

98.3

Supply Chain

100

Quality

75.6

Maintenance

100

Vulnerability

100

License

Pull Requests

Open

10

Total

95

Closed

68

Merged

17

Issues

Open

11

Total

27

Closed

16

Releases

v1.2.0

Published on 29 Oct 2022

v1.1.0

Published on 07 Oct 2022

v1.0.0

Published on 02 May 2022

v0.1.2

Published on 30 Jun 2021

v0.1.1

Published on 17 Jul 2020

v0.1.0

Published on 17 Jul 2020

View all 6 releases

Contributors

Unable to fetch Contributors

View all 8 contributors

Languages

JavaScript

TypeScript

Shell

JavaScript (98.61%)

TypeScript (1.24%)

Shell (0.15%)

Developer

delvedor

Download Statistics

Total Downloads

256,658,148

Last Day

461,244

Last Week

2,095,751

Last Month

9,272,872

Last Year

114,264,615

GitHub Statistics

185 Stars

35 Commits

37 Forks

5 Watching

5 Branches

8 Contributors

Bundle Size

2.60 kB

Minified

786.00 B

Minified + Gzipped

Bundlephobia

Maintainers

Package Meta Information

Latest Version

1.2.0

Package Id

hpagent@1.2.0

Unpacked Size

72.14 kB

Size

7.54 kB

File Count

NPM Version

8.5.0

Node Version

16.14.2

Total Downloads

Cumulative downloads

Total Downloads

256,658,148

Last day

-6.8%

461,244

Compared to previous day

Last week

-14.4%

2,095,751

Compared to previous week

Last month

4.5%

9,272,872

Compared to previous month

Last year

44.5%

114,264,615

Compared to previous year

Daily Downloads

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

ava got needle node-fetch proxy simple-get standard tsd

Versions

hpagent

. npm

A ready to use http and https agent for working with proxies that keeps connections alive!

Install

npm install hpagent

Usage

Based on your infrastructure, you should use the http agent or the https agent. The following table will help you picking the right one.

Type	Proxy	Server
`HttpProxyAgent`	HTTP	HTTP
`HttpProxyAgent`	HTTPS	HTTP
`HttpsProxyAgent`	HTTP	HTTPS
`HttpsProxyAgent`	HTTPS	HTTPS

1const { HttpProxyAgent, HttpsProxyAgent } = require('hpagent')

Once you have understood the right agent for your use case, you can instance it. It takes the same parameter of the Node.js core's http(s) agent and an additional proxy option, which is the url of your proxy.

1const http = require('http')
2const { HttpProxyAgent } = require('hpagent')
3
4const agent = new HttpProxyAgent({
5  keepAlive: true,
6  keepAliveMsecs: 1000,
7  maxSockets: 256,
8  maxFreeSockets: 256,
9  proxy: 'http://localhost:8080'
10})
11
12http.get('http://localhost:9200', { agent })
13    .on('response', console.log)
14    .end()

If your proxy requires basic authentication, you can configure it in the proxy url:

1const http = require('http')
2const { HttpProxyAgent } = require('hpagent')
3
4const agent = new HttpProxyAgent({
5  keepAlive: true,
6  keepAliveMsecs: 1000,
7  maxSockets: 256,
8  maxFreeSockets: 256,
9  proxy: 'http://user:pwd@localhost:8080'
10})
11
12http.get('http://localhost:9200', { agent })
13    .on('response', console.log)
14    .end()

You can also pass custom options intended only for the proxy CONNECT request with the proxyConnectOptions option, such as headers or tls.connect() options:

1const fs = require('fs')
2const http = require('http')
3const { HttpProxyAgent } = require('hpagent')
4
5const agent = new HttpProxyAgent({
6  keepAlive: true,
7  keepAliveMsecs: 1000,
8  maxSockets: 256,
9  maxFreeSockets: 256,
10  proxy: 'https://localhost:8080',
11  proxyConnectOptions: {
12    headers: {
13      'Proxy-Authorization': 'Basic YWxhZGRpbjpvcGVuc2VzYW1l',
14    },
15    ca: [ fs.readFileSync('custom-proxy-cert.pem') ]
16  }
17})
18
19http.get('http://localhost:9200', { agent })
20    .on('response', console.log)
21    .end()

Integrations

Following you can find the list of userland http libraries that are tested with this agent.

got

1got('http://localhost:9200', {
2  agent: {
3    http: new HttpProxyAgent({
4      keepAlive: true,
5      keepAliveMsecs: 1000,
6      maxSockets: 256,
7      maxFreeSockets: 256,
8      scheduling: 'lifo',
9      proxy: 'http://localhost:8080'
10    })
11  }
12})

needle

1needle('get', 'http://localhost:9200', {
2  agent: new HttpProxyAgent({
3    keepAlive: true,
4    keepAliveMsecs: 1000,
5    maxSockets: 256,
6    maxFreeSockets: 256,
7    scheduling: 'lifo',
8    proxy: 'http://localhost:8080'
9  })
10})

node-fetch

1fetch('http://localhost:9200', {
2  agent: new HttpProxyAgent({
3    keepAlive: true,
4    keepAliveMsecs: 1000,
5    maxSockets: 256,
6    maxFreeSockets: 256,
7    scheduling: 'lifo',
8    proxy: 'http://localhost:8080'
9  })
10})

simple-get

1sget.concat({
2  url: `http://${server.address().address}:${server.address().port}`,
3  agent: new HttpProxyAgent({
4    keepAlive: true,
5    keepAliveMsecs: 1000,
6    maxSockets: 256,
7    maxFreeSockets: 256,
8    scheduling: 'lifo',
9    proxy: `https://${proxy.address().address}:${proxy.address().port}`
10  })
11}, function (err, response, data) {
12  // handle the response
13})

License

This software is licensed under the MIT.

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.

10

Vulnerabilities

Determines if the project has open, known unfixed vulnerabilities.

10

License

Determines if the project has defined a license.

2

Code-Review

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

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

Pinned-Dependencies

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

0

CII-Best-Practices

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

0

Security-Policy

Determines if the project has published a security policy.

0

Fuzzing

Determines if the project uses fuzzing.

0

Branch-Protection

Determines if the default and release branches are protected with GitHub's branch protection settings.

0

SAST

Determines if the project uses static code analysis.

Score

3.6

/10

Last Scanned on 2025-01-27

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