Socket
Socket
Sign inDemoInstall

proxy-agent

Package Overview
Dependencies
32
Maintainers
1
Versions
28
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

proxy-agent

Maps proxy protocols to `http.Agent` implementations


Version published
Maintainers
1
Weekly downloads
7,389,745
decreased by-12.36%

Weekly downloads

Package description

What is proxy-agent?

The proxy-agent npm package is a module that provides an HTTP(s) proxy Agent which can be used to proxy HTTP and HTTPS requests through a specified proxy server. This is useful in scenarios where network requests need to be routed through a proxy for reasons such as security, privacy, or circumventing network restrictions.

What are proxy-agent's main functionalities?

Creating an HTTP proxy agent

This feature allows you to create an HTTP proxy agent that will route HTTP requests through the specified proxy server.

const ProxyAgent = require('proxy-agent');
const agent = new ProxyAgent('http://proxy-server.com:8080');
const http = require('http');

const requestOptions = {
  host: 'example.com',
  port: 80,
  path: '/',
  agent: agent
};

http.get(requestOptions, (res) => {
  console.log(`Got response: ${res.statusCode}`);
});

Creating an HTTPS proxy agent

This feature allows you to create an HTTPS proxy agent that will route HTTPS requests through the specified proxy server using TLS/SSL encryption.

const ProxyAgent = require('proxy-agent');
const agent = new ProxyAgent('https://proxy-server.com:443');
const https = require('https');

const requestOptions = {
  host: 'example.com',
  port: 443,
  path: '/',
  agent: agent
};

https.get(requestOptions, (res) => {
  console.log(`Got response: ${res.statusCode}`);
});

Support for different proxy protocols

The proxy-agent package supports various proxy protocols including HTTP, HTTPS, SOCKS, and PAC (Proxy Auto-Config).

const ProxyAgent = require('proxy-agent');

const httpAgent = new ProxyAgent('http://proxy-server.com:8080');
const httpsAgent = new ProxyAgent('https://proxy-server.com:443');
const socksAgent = new ProxyAgent('socks://proxy-server.com:1080');
const pacAgent = new ProxyAgent('pac+http://proxy-server.com/proxy.pac');

// Use the appropriate agent for the request protocol

Other packages similar to proxy-agent

Readme

Source

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:

ProtocolProxy Agent for http requestsProxy Agent for https requestsExample
httphttp-proxy-agenthttps-proxy-agenthttp://proxy-server-over-tcp.com:3128
httpshttp-proxy-agenthttps-proxy-agenthttps://proxy-server-over-tls.com:3129
socks(v5)socks-proxy-agentsocks-proxy-agentsocks://username:password@some-socks-proxy.com:9050 (username & password are optional)
socks5socks-proxy-agentsocks-proxy-agentsocks5://username:password@some-socks-proxy.com:9050 (username & password are optional)
socks4socks-proxy-agentsocks-proxy-agentsocks4://some-socks-proxy.com:9050
pac-*pac-proxy-agentpac-proxy-agentpac+http://www.example.com/proxy.pac

Example

import * as https from 'https';
import { ProxyAgent } from 'proxy-agent';

// The correct proxy `Agent` implementation to use will be determined
// via the `http_proxy` / `https_proxy` / `no_proxy` / etc. env vars
const agent = new ProxyAgent();

// The rest works just like any other normal HTTP request
https.get('https://jsonip.com', { agent }, (res) => {
  console.log(res.statusCode, res.headers);
  res.pipe(process.stdout);
});

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.

Keywords

FAQs

Last updated on 12 Feb 2024

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

  • Package Alerts
  • Integrations
  • Docs
  • Pricing
  • FAQ
  • Roadmap

Stay in touch

Get open source security insights delivered straight into your inbox.


  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc