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)


    npm i get-proxy-settings

    DownloadsWeekly Downloads






    Unpacked Size

    37.5 kB

    Total Files


    Last publish


    • windowsazure
    • timotheeguerin