got
16.2.0 · 30 Oct 2026MIT53.2M / weekRepositoryHomepagenpmAtom feed
9.6.0 is the newest release of 9.x.
In short
5 breaking8 new4 fixed2 changed
- Breaking
Requires Node.js 8. You might ask, why not follow the Node.js LTS cycle and target Node.js 6. In short, async/await and WHATWG URL, which enabled us to simplify the codebase and reduce the dependency-tree considerably. Got v8 is a stable release, and you can continue using that if you need to support Node.js 6.
- Breaking
The retry functionality was rewritten to improve its reliability and to support retrying on HTTP status codes. Previously, it only retried on some network failures. 98b5664 The option was renamed from
retriestoretryand it now accepts either a number of retries or an object with the ability to specify the number of retries, HTTP status codes and methods to retry on, and a function to decide how to retry. See the docs for more. Migration: - Breaking
Renamed the
.canceledproperty to.isCanceled. 00fdeea - Breaking
Dropped support for the
bodyoption being an Array whenform: true. dfe5b1c The built-innew URLSearchParams()API doesn't support this either and it's a weird use-case. If you need support for this, just don't setform: trueand handle stringifying yourself. - Breaking
Got throws an error if
.pipe()was called after the response has been emitted. This makes us sure you receive whole response in case flowing mode is on (#223).
Security
1 advisory affects 9.0.0; 11.8.5 fixes them
- ModerateGot allows a redirect to a UNIX socketGHSA-pfrx-2q88-qq97 · 19 Jun 2022Fixed in 11.8.5
Release note
Got version 9 is a massive release! Many new awesome features and we have pretty much fixed all the open issues regarding Got bugs on the issue tracker.
Got is a human-friendly and powerful HTTP request library for Node.js
Breaking changes
- Breaking
Requires Node.js 8.
You might ask, why not follow the Node.js LTS cycle and target Node.js 6. In short, async/await and WHATWG URL, which enabled us to simplify the codebase and reduce the dependency-tree considerably. Got v8 is a stable release, and you can continue using that if you need to support Node.js 6. - Breaking
The retry functionality was rewritten to improve its reliability and to support retrying on HTTP status codes. Previously, it only retried on some network failures. 98b5664
The option was renamed fromretriestoretryand it now accepts either a number of retries or an object with the ability to specify the number of retries, HTTP status codes and methods to retry on, and a function to decide how to retry. See the docs for more.
Migration:
-{ retries: 4 }→{ retry: 4 }
-{ retries: () => { … } }→{ retry: { retries: () => { … } } } - Breaking
Renamed the
.canceledproperty to.isCanceled. 00fdeea - Breaking
Dropped support for the
bodyoption being an Array whenform: true. dfe5b1c
The built-innew URLSearchParams()API doesn't support this either and it's a weird use-case. If you need support for this, just don't setform: trueand handle stringifying yourself. - Breaking
Got throws an error if
.pipe()was called after the response has been emitted.
This makes us sure you receive whole response in case flowing mode is on (#223).
Improvements
Fewer dependencies and smaller install size!
Got v9: install size
Got v8: install size
Request (latest): install size
The
timeoutoption was rewritten to be more reliable and flexible. You can now set a timeout for every phase of the request if you want, or just for the whole request. That's up to you. da4f236Added
got.extend()which lets you easily create instances of Got with some options overridden. bc41a49Added
got.create()which is a more advanced and powerful version ofgot.extend(). With this API, you can create your own niche-specific instance of Got, for example, an HTTP-client for GitHub. bc41a49Added a
beforeRequesthook. 107756fAdded
requestandresponseevents to the Promise API. e86aad7The
content-lengthheader is now also automatically set if thebodyoption is set to afs.createReadStreaminstance. 6e7a455You can now remove the default
user-agentheader by passing in'user-agent': nullas a header. e473a26The
bodyoption can now be any kind of object, not just a plain object. 7a49ce7
Bug fixes
Fixed a problem with the cache not working when using the
queryoption. 07a91ccLess unhandled errors (Hopefully none!). f621184
Headers are now correctly proxied when you pipe
got.stream(). 83bc44cLots of more bug fixes.
Other
100% code coverage! Doing this caught a couple of bugs, so definitely worth doing even if 100% doesn't mean bug-free.
The codebase was significantly refactored for better readability and maintainability. b54b680
Team
Welcome @szmarczak and @brandon93s as maintainers 🎉
Special shoutout to @jstewmon for helping us with many of the above improvements and fixes 🙌
All changes
A whole project to check? Paste its package.json in the dependency check: every deprecated, outdated or vulnerable dependency, with what to upgrade to. Free, no account.