HTTP(s) request with redirect, compress and streaming

To be used if you only need bare bones HTTP request and if you'd rather have your response processed downstream.

getlet will send the request, handle the redirects and pipe the response. If you need anything more than this check superagent or request.

getlet always asks for gzip or deflate encoding and decompresses the response, but it won't do any other processing. It won't buffer the responses in any way.

  const getlet = require('getlet');

  // get URL and stream it
  getlet('http://google.com').pipe(stream);

  // configure URL from host and part
  getlet()
    .host('raw2.github.com')
    .path('/pirxpilot/liftie/master/.jshintrc')
    .secure(true)
    .on('error', errorHandler)
    .pipe(stream);

  // post some data
  getlet('https//example.com/form')
    .method('POST')
    .send(formData)
    .pipe(stream);

  // get URL and stream it, initialize later
  const request = getlet('http://google.com', false);
  setTimeout(function () {
    request.pipe(stream);
    request.init();
  }, 1000);
  // initialize later

url is an optional parameter - alternatively you can configure target using host and path autoInit if false init() has to be called explicitly to trigger network request

if on is truthy use HTTPS instead of HTTP

set User-Agent header

set header name to value, also accepts an object treated as name -> value

sets basic authentication Authorization header

sends data with the request

uses HTTP method (POST, PUT etc) - GET is used if method is not called

when called with false will prevent getlet from automatically following redirects