get-proxy-settings
    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.

    Install

    npm install --save get-proxy-settings
    

    Usage

    Import

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

    Use

    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);
    }

    Config

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

    import { defaults } from "get-proxy-settings";
    
    defaults.testUrl = "https://example.com";

    Contributing

    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 https://cla.microsoft.com.

    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 opencode@microsoft.com with any additional questions or comments.

    Credits

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

    Install

    npm i get-proxy-settings

    DownloadsWeekly Downloads

    585

    Version

    0.1.13

    License

    MIT

    Unpacked Size

    37.5 kB

    Total Files

    30

    Last publish

    Collaborators

    • windowsazure
    • timotheeguerin