On this page

Extends: undici.Dispatcher

EnvHttpProxyAgent automatically reads the proxy configuration from the environment variables http_proxy, https_proxy, and no_proxy and sets up the proxy agents accordingly. When http_proxy and https_proxy are set, http_proxy is used for HTTP requests and https_proxy is used for HTTPS requests. If only http_proxy is set, http_proxy is used for both HTTP and HTTPS requests. If only https_proxy is set, it is only used for HTTPS requests.

no_proxy is a comma or space-separated list of hostnames that should not be proxied. The list may contain leading wildcard characters (*). If no_proxy is set, the EnvHttpProxyAgent will bypass the proxy for requests to hosts that match the list. If no_proxy is set to "*", the EnvHttpProxyAgent will bypass the proxy for all requests.

Uppercase environment variables are also supported: HTTP_PROXY, HTTPS_PROXY, and NO_PROXY. However, if both the lowercase and uppercase environment variables are set, the uppercase environment variables will be ignored.

new EnvHttpProxyAgent(options?): void

Arguments:

  • options EnvHttpProxyAgentOptions (optional) - extends the Agent options.

Returns: EnvHttpProxyAgent

Extends: AgentOptions

  • httpProxy string (optional) - When set, it will override the HTTP_PROXY environment variable.
  • httpsProxy string (optional) - When set, it will override the HTTPS_PROXY environment variable.
  • noProxy string (optional) - When set, it will override the NO_PROXY environment variable.

Examples:

import { EnvHttpProxyAgent } from 'undici'

const envHttpProxyAgent = new EnvHttpProxyAgent()
// or
const envHttpProxyAgent = new EnvHttpProxyAgent({ httpProxy: 'my.proxy.server:8080', httpsProxy: 'my.proxy.server:8443', noProxy: 'localhost' })
JavaScript

This will instantiate the EnvHttpProxyAgent. It will not do anything until registered as the agent to use with requests.

import { EnvHttpProxyAgent } from 'undici'

const envHttpProxyAgent = new EnvHttpProxyAgent()
JavaScript
import { setGlobalDispatcher, fetch, EnvHttpProxyAgent } from 'undici'

const envHttpProxyAgent = new EnvHttpProxyAgent()
setGlobalDispatcher(envHttpProxyAgent)

const response = await fetch('http://localhost:3000/foo')

console.log('response received', response.status) // response received 200

const data = await response.json() // data { foo: "bar" }
JavaScript
import { setGlobalDispatcher, request, EnvHttpProxyAgent } from 'undici'

const envHttpProxyAgent = new EnvHttpProxyAgent()
setGlobalDispatcher(envHttpProxyAgent)

const { statusCode, body } = await request('http://localhost:3000/foo')

console.log('response received', statusCode) // response received 200

for await (const data of body) {
  console.log('data', data.toString('utf8')) // data foo
}
JavaScript
import { EnvHttpProxyAgent, request } from 'undici'

const envHttpProxyAgent = new EnvHttpProxyAgent()

const {
  statusCode,
  body
} = await request('http://localhost:3000/foo', { dispatcher: envHttpProxyAgent })

console.log('response received', statusCode) // response received 200

for await (const data of body) {
  console.log('data', data.toString('utf8')) // data foo
}
JavaScript
import { EnvHttpProxyAgent, fetch } from 'undici'

const envHttpProxyAgent = new EnvHttpProxyAgent()

const response = await fetch('http://localhost:3000/foo', { dispatcher: envHttpProxyAgent })

console.log('response received', response.status) // response received 200

const data = await response.json() // data { foo: "bar" }
JavaScript
EnvHttpProxyAgent.close(callback?): void

Implements Dispatcher.close([callback]).

EnvHttpProxyAgent.destroy(error?, callback?): void

Implements Dispatcher.destroy([error, callback]).

EnvHttpProxyAgent.dispatch(options, handler: AgentDispatchOptions): void

Implements Dispatcher.dispatch(options, handler).

Extends: DispatchOptions

  • origin string | URL

Implements Dispatcher.destroy([error, callback]).

EnvHttpProxyAgent.connect(options, callback?): void

See Dispatcher.connect(options[, callback]).

EnvHttpProxyAgent.dispatch(options, handler): void

Implements Dispatcher.dispatch(options, handler).

EnvHttpProxyAgent.pipeline(options, handler): void

See Dispatcher.pipeline(options, handler).

EnvHttpProxyAgent.request(options, callback?): void

See Dispatcher.request(options [, callback]).

EnvHttpProxyAgent.stream(options, factory, callback?): void

See Dispatcher.stream(options, factory[, callback]).

EnvHttpProxyAgent.upgrade(options, callback?): void

See Dispatcher.upgrade(options[, callback]).