You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
Vsevolod Strukchinsky 6c7ddf80d7 Merge pull request #12 from sindresorhus/read-response-on-error 10 years ago
.editorconfig init 11 years ago
.gitattributes init 11 years ago
.gitignore Read response stream even if status is not 200 10 years ago
.jshintrc init 11 years ago
.travis.yml init 11 years ago
index.js Read response stream even if status is not 200 10 years ago
license add gzip/deflate support 11 years ago
package.json Read response stream even if status is not 200 10 years ago
readme.md Read response stream even if status is not 200 10 years ago
test.js Read response stream even if status is not 200 10 years ago

readme.md

got Build Status

Simplified HTTP/HTTPS requests

A nicer interface to the built-in http module.

It also supports following redirects and automagically handling gzip/deflate.

Use request if you need more.

Install

$ npm install --save got

Usage

var got = require('got');

// Callback mode.
got('http://todomvc.com', function (err, data, res) {
	console.log(data);
	//=> <!doctype html> ...
});

// Stream mode.
got('http://todomvc.com').pipe(fs.createWriteStream('index.html'));

API

It's a GET request by default, but can be changed in options.

got(url, [options], [callback])

url

Required
Type: string

The url to request.

options

Type: object

Any of the http.request options.

options.encoding

Type: string, null
Default: 'utf8'

Encoding to be used on setEncoding of the response data. If null, the body is returned as a Buffer.

callback(err, data, response)
err

Error object with code property.

data

The data you requested.

response

The response object.

See sent if you need to upload something.

License

MIT © Sindre Sorhus