npmpackage.info

Gathering detailed insights and metrics for agent-base

Other packages similar to agent-base

@types/agent-base

5.0.0

Stub TypeScript definitions entry for agent-base, which provides its own types definitions

@agent-base/types

0.59.0

Shared agent types and utilities

@agent-base/api-client

0.72.0

Typed API clients for inter-service communication

puppeteer-extra-plugin

3.2.3

Base class for puppeteer-extra plugins.

Gathering detailed insights and metrics for agent-base

agent-base - 7.1.3 | npmpackage.info

agent-base

Node.js HTTP Proxy Agents Monorepo

7.1.3

1,060

TypeScript

1.43 kB

11,265,321,854 3

Installations

npm install agent-base

Developer Guide

BETA

Typescript

Yes

Module System

CommonJS

Min. Node Version

>= 14

Node Version

20.18.1

NPM Version

10.8.2 Score

98.7

Supply Chain

89.5

Quality

77.7

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

11,265,321,854

Last Day

4,803,858

Last Week

84,991,146

Last Month

365,016,491

Last Year

3,717,284,486

GitHub Statistics

1,060 Stars

298 Commits

258 Forks

19 Watchers

3 Branches

40 Contributors

Updated on Jul 01, 2025

Bundle Size

4.05 kB

Minified

1.43 kB

Minified + Gzipped

Bundlephobia

Maintainers

View All 40 Contributors

Package Meta Information

Latest Version

7.1.3

Package Id

agent-base@7.1.3

Unpacked Size

30.81 kB

Size

7.66 kB

File Count

NPM Version

10.8.2

Node Version

20.18.1

Published on

Dec 08, 2024

Total Downloads

Cumulative downloads

Total Downloads

11,265,321,854

Last Day

-3.9%

4,803,858

Compared to previous day

Last Week

-6.6%

84,991,146

Compared to previous week

Last Month

2.9%

365,016,491

Compared to previous month

Last Year

41.8%

3,717,284,486

Compared to previous year

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

@types/debug @types/jest @types/node @types/semver @types/ws async-listen jest ts-jest typescript ws tsconfig

agent-base

Turn a function into an `http.Agent` instance

This module is a thin wrapper around the base http.Agent class.

It provides an abstract class that must define a connect() function, which is responsible for creating the underlying socket that the HTTP client requests will use.

The connect() function may return an arbitrary Duplex stream, or another http.Agent instance to delegate the request to, and may be asynchronous (by defining an async function).

Instances of this agent can be used with the http and https modules. To differentiate, the options parameter in the connect() function includes a secureEndpoint property, which can be checked to determine what type of socket should be returned.

Some subclasses:

Here are some more interesting uses of agent-base. Send a pull request to list yours!

http-proxy-agent: An HTTP(s) proxy http.Agent implementation for HTTP endpoints
https-proxy-agent: An HTTP(s) proxy http.Agent implementation for HTTPS endpoints
pac-proxy-agent: A PAC file proxy http.Agent implementation for HTTP and HTTPS
socks-proxy-agent: A SOCKS proxy http.Agent implementation for HTTP and HTTPS

Example

Here's a minimal example that creates a new net.Socket or tls.Socket based on the secureEndpoint property. This agent can be used with both the http and https modules.

1import * as net from 'net';
2import * as tls from 'tls';
3import * as http from 'http';
4import { Agent } from 'agent-base';
5
6class MyAgent extends Agent {
7  connect(req, opts) {
8    // `secureEndpoint` is true when using the "https" module
9    if (opts.secureEndpoint) {
10      return tls.connect(opts);
11    } else {
12      return net.connect(opts);
13    }
14  }
15});
16
17// Keep alive enabled means that `connect()` will only be
18// invoked when a new connection needs to be created
19const agent = new MyAgent({ keepAlive: true });
20
21// Pass the `agent` option when creating the HTTP request
22http.get('http://nodejs.org/api/', { agent }, (res) => {
23  console.log('"response" event!', res.headers);
24  res.pipe(process.stdout);
25});

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 agent-base

Other packages similar to agent-base

agent-base

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

4.05 kB

1.43 kB

Maintainers

Package Meta Information

Total Downloads

11,265,321,854

Weekly Downloads

Monthly Downloads

Yearly Downloads

Dev Dependencies

agent-base

Turn a function into an http.Agent instance

Some subclasses:

Example

10

10

5

1

0

0

0

0

0

0

0

0

3

/10

Turn a function into an `http.Agent` instance