omni-fetch v0.2.3

omni-fetch

wrapper for isomorphic fetch with proxy support

omni-fetch combines the excellent isomorphic-fetch and caw modules to enable easy http and https proxy support for your node application.

Installation

npm install --save omni-fetch isomorphic-fetch

Usage

import fetch from 'omni-fetch';
fetch('https://www.sinnerschrader.com');

⇨ See the fetch documenation for details

Proxy Support

Specify proxy configuration via HTTP_PROXY and HTTPS_PROXY environment variables, or their all-lowercase twins. Assuming a local proxy server available at http://localhost:8080:

export HTTP_PROXY=http://localhost:8080
export HTTPS_PROXY=http://localhost:8080
npm start

⇨ The specified proxy configuration will be picked up for all communication via omni-fetch on the server-side. Client-side fetch will use the client's proxy configuration.

Overriding global configuration

omni-fetch default proxy configuration can be overridden by passing an agent option to fetch:

import https from 'https';
import fetch from 'omni-fetch';

process.env.HTTPS_PROXY = 'http://localhost:8080';

// Uses http://localhost:8080
fetch('https://sinnerschrader.com');

// Uses no proxy
fetch('https://sinnerschrader.com', {
  agent: https.globalAgent
});

Copyright 2016 by Mario Nebl and contributors. Released under the MIT license.