npm · #1225 most downloaded on npm

got

16.0.0171M downloads/mosindresorhus/got ↗New releases in your daily digest, changelog included.

Human-friendly and powerful HTTP request library for Node.js

Last release 1 months ago
30 Aug 2026
Release timing varies
gaps range from 8 days to 3 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
13 years old
201 releases · first in 2014

Release timeline

201 releases since 2014

2014201620182020

Releases

2.7.18 Apr 2015
Parse response with non-2xx status code, when json option is true.
Parse response with non-2xx status code, when json option is true.

https://github.com/sindresorhus/got/compare/v2.7.0...v2.7.1

Open source →

2.7.06 Apr 2015

New json option for auto-parsing JSON response. abdd0f09606fa4c79b277d2b637a9aa47b9c9643

New json option for auto-parsing JSON response. abdd0f09606fa4c79b277d2b637a9aa47b9c9643

Before:

got('jsonendpoint.com', function (err, data) {
    if (err) { return cb(err); }

    var json;

    try {
        json = JSON.parse(data);
    } catch (e) {
        return cb(new Error('Reponse from jsonendpoint.com is broken: ' + e.message));
    }

    // working with json
});

After:

got('jsonendpoint.com', {json: true}, function (err, json) {
    if (err) { return cb(err); }

    // working with json
});

https://github.com/sindresorhus/got/compare/v2.6.0...v2.7.0

Open source →

One column per quarter.

2.6.03 Apr 2015

Thanks to nested-error-stacks by @mdlavin got now emits much more detailed errors! For example Error: getaddrinfo ENOTFOUND now looks like:

Thanks to nested-error-stacks by @mdlavin got now emits much more detailed errors! For example Error: getaddrinfo ENOTFOUND now looks like:

GotError: Request to .com failed
    at ClientRequest.<anonymous> (index.js:123:7)
    at ClientRequest.g (events.js:180:16)
    at ClientRequest.emit (events.js:95:17)
    at Socket.socketErrorListener (http.js:1552:9)
    at Socket.emit (events.js:95:17)
    at net.js:834:16
    at process._tickCallback (node.js:442:13)
Caused By: Error: getaddrinfo ENOTFOUND
    at errnoException (dns.js:37:11)
    at Object.onanswer [as oncomplete] (dns.js:124:16)

Same goes for ungzip errors and response stream reading errors. All of them will be wrapped in GotError with url in message.

Highlights

read-all-stream was updated to ^2.0.0 - release fixes hanging requests on error in underlying streams (like ungzip) 3e55aa613708472537ba4d3cf5fb1923ec5ec5f0

Changes

https://github.com/sindresorhus/got/compare/v2.5.0...v2.6.0

Open source →

2.5.024 Mar 2015

Emit response event with response object in Stream mode, when server response is ready. https://github.com/sindresorhus/got/commit/929cb59857848c1c14e

Emit response event with response object in Stream mode, when server response is ready. https://github.com/sindresorhus/got/commit/929cb59857848c1c14e470baca9a1ae204d0be8b

https://github.com/sindresorhus/got/compare/v2.4.0...v2.5.0

Open source →

2.4.06 Feb 2015

Improve status code error messages. https://github.com/sindresorhus/got/commit/ef8bdeb22655e06ebe320b580bb0eae4d03f336d

https://github.com/sindresorhus/got/compare/v2.3.2...v2.4.0

Open source →

2.3.224 Jan 2015

Prevent duplicate headers of different casing. Node will throw if it encounters that.

https://github.com/sindresorhus/got/compare/v2.3.1...v2.3.2

Open source →

2.3.119 Jan 2015

https://github.com/sindresorhus/got/compare/v2.3.0...v2.3.1

Open source →

2.3.05 Jan 2015

!tumblr_mzkfuyhmyr1s373hwo1_400

Update

$ npm update --save got

Highlights

Add readable stream support in options.body. https://github.com/sindresorhus/got/commit/7693a7d645740e7a1d2f17f04310eb7d183bcaae
Support protocol-less URLs as input. https://github.com/sindresorhus/got/commit/0b6d7da87a5bedd8ef1cc8343687f64d66d768cb
Use agents with maxSockets set to Infinity. #22 https://github.com/sindresorhus/got/commit/5d5d0cc6e26192f45ec8c7816cce93355293aa2d
Discard response payload on redirect response. https://github.com/sindresorhus/got/commit/1f9281f27d437e3bf06eb3ad0929f708e8d53507