TypeScript icon, indicating that this package has built-in type declarations

0.1.13 • Public • Published

Note: This project is not actively maintained. If some issues come up we'll look into fixing them but new features will most likely not make it.

System Proxy

Build Status npm version

This library support

  • Reading proxy settings from the HTTP_PROXY or HTTPS_PROXY environment variables
  • Reading proxy settings from the HTTP_PROXY or HTTPS_PROXY node configuration
  • Retrieving the settings from the internet settings on Windows in the registry
  • Validating the connection and asking for credentials if needed
  • Note that it doesn't support every proxy system. If you are using electron it is recommended to use electron/chromium built in proxy support which is much more advanced.


npm install --save get-proxy-settings



// With named import
import { getProxySettings, getAndTestProxySettings } from "get-proxy-settings";

// Or with commonjs
const { getProxySettings, getAndTestProxySettings } = require("get-proxy-settings");


async function basic() {
    const proxy = await getProxySettings();
    console.log("proxy", proxy.http, proxy.https);

// Get and validate the proxy settings
async function withValidation() {
    async function login() {
        // Do any async operation to retrieve the username and password of the user(prompt?)
        return {username: "abc", password: "123"}

    const proxy = await getAndTestProxySettings(login);
    console.log("proxy", proxy.http, proxy.https);


Update the test url (Which url is used to validate the proxy)

import { defaults } from "get-proxy-settings";

defaults.testUrl = "";


This project welcomes contributions and suggestions. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit

When you submit a pull request, a CLA-bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., label, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact with any additional questions or comments.


  • Timothee Guerin
  • Adar Zandberg from the CxSCA AppSec team at Checkmarx. (Finding Command injection vulnerability)

Package Sidebar


npm i get-proxy-settings

Weekly Downloads






Unpacked Size

37.5 kB

Total Files


Last publish


  • windowsazure
  • timotheeguerin