get
A slightly higher-level HTTP client for node.
Last updated 6 years ago by yhahn .
BSD · Repository · Bugs · Original npm · Tarball · package.json
$ cnpm install get 
SYNC missed versions from official npm registry.

get Build Status

get is a slightly higher-level HTTP client for nodejs.

Installation

npm install get

get has no dependencies.

For testing, you'll need make and mocha.

For docs you'll need docco.

Features

  • Redirect following.
  • Convenience functions for downloading and getting data as string.
  • Binary-extension and basic binary detection.
  • Configurable headers

API

Downloads are objects in get.

var dl = new get({ uri: 'http://google.com/' });

However, the function is a�self-calling constructor, and�thus the new keyword is�not necessary:

var dl = get({ uri: 'http://google.com/' });

The get constructor can also take a plain string if you don't want to give options.

var dl = get('http://google.com/');

It can also take other options.

var dl = get({
    uri: 'http://google.com/',
    max_redirs: 20,
});

Then it exposes three main methods

dl.asString(function(err, str) {
    console.log(str);
});

and

dl.toDisk('myfile.txt', function(err, filename) {
    console.log(err);
});

and finally

dl.asBuffer(function(err, data) {
    console.log(data);
});

There's also a lower-level API.

dl.perform(function(err, response) {
    // response is just a response object, just like
    // HTTP request, except handling redirects
});

If you give node-get an object of settings instead of a string, it accepts

  • uri - the address of the resource
  • headers - to replace its default headers with custom ones
  • max_redirs - the number of redirects to follow before returning an error
  • no_proxy - don't use a HTTP proxy, even if one is in ENV
  • encoding - When calling .guessEncoding(), get will use this instead of the default value

Example

var get = require('get');

get('http://google.com/').asString(function(err, data) {
    if (err) throw err;
    console.log(data);
});

TODO:

  • Guessing encoding wth headers
  • User-customizable encodings

Authors

  • Tom MacWright (tmcw)
  • Konstantin Kaefer (kkaefer)

Current Tags

  • 1.4.0                                ...           latest (6 years ago)

22 Versions

  • 1.4.0                                ...           6 years ago
  • 1.3.0                                ...           7 years ago
  • 1.2.1                                ...           8 years ago
  • 1.2.0                                ...           8 years ago
  • 1.1.10                                ...           8 years ago
  • 1.1.9                                ...           8 years ago
  • 1.1.8                                ...           8 years ago
  • 1.1.7                                ...           8 years ago
  • 1.1.6                                ...           9 years ago
  • 1.1.5                                ...           9 years ago
  • 1.1.4                                ...           9 years ago
  • 1.1.3                                ...           9 years ago
  • 1.1.2                                ...           9 years ago
  • 1.1.1                                ...           9 years ago
  • 1.1.0                                ...           9 years ago
  • 1.0.0                                ...           9 years ago
  • 0.4.2                                ...           9 years ago
  • 0.4.1                                ...           9 years ago
  • 0.4.0                                ...           9 years ago
  • 0.3.0                                ...           9 years ago
  • 0.2.1                                ...           9 years ago
  • 0.1.1                                ...           9 years ago

Copyright 2014 - 2016 © taobao.org |