Socket
Socket
Sign inDemoInstall

os-proxy-config

Package Overview
Dependencies
62
Maintainers
1
Versions
2
Alerts
File Explorer

Advanced tools

Install Socket

Detect and block malicious and high-risk dependencies

Install

os-proxy-config

Access the operating system proxy configuration from Node.js, for all platforms


Version published
Maintainers
1
Weekly downloads
143
increased by15.32%

Weekly downloads

Readme

Source

OS-Proxy-Config Build Status Available on NPM

Part of HTTP Toolkit: powerful tools for building, testing & debugging HTTP(S)

Access the operating system proxy configuration from Node.js, for all platforms. Use it like so:

import { getSystemProxy } from 'os-proxy-config';

const proxy = await getSystemProxy();

The promise from getSystemProxy resolves to something like:

{
    "proxyUrl": "https://proxy-server:123/",
    "noProxy": ["localhost", "example.com"]
}

The proxyUrl is returned in a format suitable for use with proxy-agent: it might be an HTTP or HTTPS URL (for an HTTP proxy), a socks:// or socks5:// URL for SOCKS proxies, or a pac+http:// URL (or similar) with the address of a PAC file for PAC-configured proxies.

If there's no proxy configured, it will resolve to undefined instead. If something major goes wrong and the settings can't be detected, the promise will be rejected.

This works slightly differently on each platform:

  • On Windows it uses windows-system-proxy, which reads proxy configuration from the registry using registry-js.
  • On Mac it uses mac-system-proxy, which reads proxy configuration using the scutil command-line tool.
  • On Linux it parses the various *_PROXY environment variables.

If you only need one platform, it's probably better to just use one of these approaches directly - this package is designed for use in cross-platform tools.

Keywords

FAQs

Last updated on 10 Jun 2021

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