The version 9.0.0 is not covered by your current version range.
If you don’t accept this pull request, your project will work just like it did before. However, you might be missing out on a bunch of new features, fixes and/or performance improvements from the dependency update.
It might be worth looking into these changes and trying to get this project onto the latest version of got.
If you have a solid test suite and good coverage, a passing build is a strong indicator that you can take advantage of these changes directly by merging the proposed change into your project. If the build fails or you don’t have such unconditional trust in your tests, this branch is a great starting point for you to work on the update.
Release Notesv9.0.0
This is a huge release! Many new awesome features and we have pretty much fixed all the open issues regarding Got bugs on the issue tracker.
Breaking changes
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 considerably simplify the codebase and reduce the dependency-tree. Got v8 is a stable release and you can continue using that if you need to support Node.js 6.
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 retries to retry and it now accepts either a number of retries or an object with ability to specify 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: () => { … } } }
Renamed the .canceled property to .isCanceled. 00fdeea
Dropped support for the body option being an Array when form: true. dfe5b1c
The built-in new URLSearchParams() API doesn't support this either and it's a weird use-case. If you need support for this, just don't set form: true and handle stringifying yourself.
Improvements
Less dependencies!
The timeout option 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. da4f236
Added got.extend() which lets you easily create instances of Got with some options overriden. bc41a49
Added got.create() which is a more advanced and powerful version of got.extend(). With this API, you can create your own niche-specific instance of Got, for example, a HTTP-client for GitHub. bc41a49
FAQ and help
There is a collection of [frequently asked questions](https://greenkeeper.io/faq.html). If those don’t help, you can always [ask the humans behind Greenkeeper](https://github.com/greenkeeperio/greenkeeper/issues/new).
Version 9.0.0 of got was just published.
The version 9.0.0 is not covered by your current version range.
If you don’t accept this pull request, your project will work just like it did before. However, you might be missing out on a bunch of new features, fixes and/or performance improvements from the dependency update.
It might be worth looking into these changes and trying to get this project onto the latest version of got.
If you have a solid test suite and good coverage, a passing build is a strong indicator that you can take advantage of these changes directly by merging the proposed change into your project. If the build fails or you don’t have such unconditional trust in your tests, this branch is a great starting point for you to work on the update.
Release Notes
v9.0.0This is a huge release! Many new awesome features and we have pretty much fixed all the open issues regarding Got bugs on the issue tracker.
Breaking changes
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 considerably simplify the codebase and reduce the dependency-tree. Got v8 is a stable release and you can continue using that if you need to support Node.js 6.
The option was renamed from
retriestoretryand it now accepts either a number of retries or an object with ability to specify 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: () => { … } } }.canceledproperty to.isCanceled. 00fdeeabodyoption being an Array whenform: true. dfe5b1cThe built-in
new 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.Improvements
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. da4f236got.extend()which lets you easily create instances of Got with some options overriden. bc41a49got.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, a HTTP-client for GitHub. bc41a49beforeRequesthook. 107756frequestandresponseevents to the Promise API. e86aad7content-lengthheader is now also automatically set if thebodyoption is set to afs.createReadStreaminstance. 6e7a455user-agentheader by passing in'user-agent': nullas a header. e473a26bodyoption can now be any kind of object, not just a plain object. 7a49ce7Bug fixes
queryoption. 07a91ccgot.stream(). 83bc44cOther
Team
Welcome @szmarczak and @brandon93s as maintainers🎉
Special shoutout to @jstewmon for helping us with many of the above improvements and fixes🙌
All changes
v8.3.2...v9.0.0
Commits
The new version differs by 74 commits ahead by 74, behind by 2.
3a145c09.0.0bf3c463Fix readme Highlights link toretryoptionba0cb0dUnify calculating content-length (#544)5c3adbaIncrease coverage (#543)10d22b7Increase coverage (#542)99dbd97Fix the behaviour of proxying headers4d92eb6Ignore JSON option when usinggot.stream()(#541)6ba9e68Fix the description of thenext()functionbf206caDon't recommend settinguser-agentto undefined80a02feUpdate readme links to Electron-related issuesaf5c3fdImprove merging options (#539)d369b08Makegot.mergeOptions()behavior more obvious and document its behavior (#538)6d654faDropESOCKETTIMEDOUTerrorda7f055Add timeout for secureConnect event for HTTPS requests (#536)9d87e9fDocumentTimeoutErrorThere are 74 commits in total.
See the full diff
FAQ and help
There is a collection of [frequently asked questions](https://greenkeeper.io/faq.html). If those don’t help, you can always [ask the humans behind Greenkeeper](https://github.com/greenkeeperio/greenkeeper/issues/new).Your Greenkeeper bot :palm_tree: