Packages

got

16.2.0 · 30 Oct 2026MIT53.2M / weekRepositoryHomepagenpmAtom feed

Your version

10.0.0

major1 Dec 2019Where it was published

10.7.0 is the newest release of 10.x.

In short

16 breaking16 new14 fixed7 internal

  • Breaking

    Require Node.js 10 633651f

  • Breaking

    Remove support for protocol-less URLs in the url argument 92bc808

  • Breaking

    Rename the query option to searchParams and make it stricter b223663 5376216 518f0f5906e1fcd38691555b17fb91db643f3d47

  • Breaking

    Replace the baseUrl option with prefixUrl (#829) 0d534ed

  • Breaking

    Change the json option to accept an object instead of a boolean and to only be responsible for the request, not the response (#704) a6a7d5a

  • Breaking

    Use the responseType option instead of encoding to get a Buffer (#940) 6cc3d9f

  • Breaking

    Don't infer POST automatically when specifying body (#756) e367bdb

  • Breaking

    The retries.retry option was split into retries.limit and retries.calculateDelay b15ce1d

Security

1 advisory affects 10.0.0; 11.8.5 fixes them

Release note

We're excited to announce Got 10! 🎉 This release has been in the works for almost a year and has been a major undertaking. Got was fully rewritten in TypeScript, which helped us catch many bugs and will give us more confidence in the codebase going forward. Got is now faster and much more stable. We also fixed a huge amount of bugs. Big thanks to everyone that helped make this release possible. 🙌


If you find Got useful, you might want to sponsor the Got maintainers.

Note: Some HTTP agents like https-proxy-agent and agentkeepalive are not compatible with Node.js 10 and hence not compatible with Got as Got takes advantage of some Node.js 10-only APIs.

Breaking

  • Breaking

    Require Node.js 10 633651f

    • Why: This is so that we can use stream.pipeline for more reliable stream handling. Node.js 8 will be out of LTS at the end of this month anyway.

  • Breaking

    Remove support for protocol-less URLs in the url argument 92bc808

    • Why: To reduce ambiguity. It was not clear from just reading the code what it would default to.

    • Migrate:

- got('sindresorhus.com');
+ got('https://sindresorhus.com');
  • Breaking

    Rename the query option to searchParams and make it stricter b223663 5376216 518f0f5

    • Why: To get closer to the window.fetch naming in the browser.

    • Migrate:

- got(…, {query: …});
+ got(…, {searchParams: …});
  • Breaking

    Replace the baseUrl option with prefixUrl (#829) 0d534ed

    • Note: We also made it stricter to reduce ambiguity. The Got url argument now cannot be prefixed with a slash when this option is used.

    • Why: We renamed it to make it clear that it doesn't do any URL resolution.

    • Migrate:

- got('/foo', {baseUrl: 'https://x.com'});
+ got('foo', {prefixUrl: 'https://x.com'});
  • Breaking

    Change the json option to accept an object instead of a boolean and to only be responsible for the request, not the response (#704) a6a7d5a

    • Note: You now set the request body in this option instead of the body option when you want to send JSON. This option also no longer sets the response type to JSON. You either call the .json() method or specify the responseType option for that.

    • Why: Many people were confused how {json: true} worked and they also complained that they could not set the request/response type individually.

    • Migrate:

- got(url, {body: {x: true}, json: true});
+ got.post(url, {json: {x: true}}).json();
  • Breaking

    Use the responseType option instead of encoding to get a Buffer (#940) 6cc3d9f

    • Why: Previously, you would pass {encoding: null} to get a Buffer, but this was confusing. You now use {responseType: 'buffer'} instead.

    • Tip: You can also use got(…).buffer();.

    • Migrate:

- got(…, {encoding: null});
+ got(…, {responseType: 'buffer'});
  • Breaking

    Don't infer POST automatically when specifying body (#756) e367bdb

    • Why: We're trying to reduce the amount of magic behavior.

    • Migrate:

- got(…, {body: 'foo'});
+ got.post(…, {body: 'foo'});
  • Breaking

    The retries.retry option was split into retries.limit and retries.calculateDelay b15ce1d

    • Migrate:

 got(…, {
 	retry: {
-		retries: 2
+		limit: 2
 	}
 });
 got(…, {
 	retry: {
-		retries: iteration => iteration < 2
+		calculateDelay: ({attemptCount}) => attemptCount < 2
 	}
 });
 got(…, {
 	headers: {
-		'user-agent': null
+		'user-agent': undefined
 	}
 });
  • Breaking

    Rename the Promise API property .fromCache to .isFromCache (#768) b5e443b

  • Breaking

    Rename the stream option to isStream 518f0f5

    • Why: To make it clearer that it's a boolean and that it doesn't expect a stream to be passed in.

    • Migrate:

- got(…, {stream: true});
+ got(…, {isStream: true});
  • Breaking

    Don't include the Got version in the default user-agent header (#911) 95bed1e

    • got/9.6.0 (https://github.com/sindresorhus/got) → got (https://github.com/sindresorhus/got)

    • Why: Importing package.json to get the version caused a lot of problems. And you should ideally set your own user-agent header anyway.

  • Breaking

    Remove got.create() 518f0f5

    • You can achieve the same thing with got.extend() now.

  • Breaking

    Remove got.mergeInstances() 518f0f5

    • Use gotInstance.extend(...gotInstances) instead.

  • Breaking

    Move top-level error properties into an .options and .response property (#773) 6eaa81b

    • Migrate:

- error.gotOptions
+ error.options

- error.headers
+ error.response.headers

- error.statusCode
+ error.response.statusCode

- error.statusMessage
+ error.response.statusMessage

- error.body
+ error.response.body

- error.redirectUrls
+ error.response.redirectUrls

- error.host
+ error.options.host

- error.hostname
+ error.options.hostname

- error.method
+ error.options.method

- error.protocol
+ error.options.protocol

- error.url
+ error.options.url

- error.path
+ error.options.path
  • Breaking

    Custom instance creation was simplified (#707) 8eaef94

    • Note: got.mergeInstances(...instances) is deprecated. Use instanceA.extend(instanceB) instead.

    • Migrate:

# Merging instances
- got.mergeInstances(instanceA, instanceB, instanceC, …);
+ instanceA.extend(instanceB, instanceC, …);

# Merging options
- instanceA.extend(optionsB).extend(optionsC).extend(…);
+ instanceA.extend(optionsB, optionsC, …);

# Merging instances and options
- got.mergeInstances(instanceA.extend(optionsB), instanceC);
+ instanceA.extend(optionsB, instanceC, …);

# Extending handlers
- got.mergeInstances(instanceA, got.create({handler: handlerB}));
+ instanceA.extend({handlers: [handlerB]});

Enhancements

Fixes

  • Fix parsing response when using afterResponse hook (#775) e2054cd

  • Fix port not being reset on redirect (#729) ada5861

  • Fix the retry functionality (#787) 0501e00

  • Fix default retry option value when specifying a number (#809) 9c04a7c

  • Correctly handle promise- and stream-specific errors in the beforeError hook 134c9b7

  • Don't throw on early lookups 4faf5c7

  • Fix Node.js 13 compatibility (#915) b0dfc95

  • Fix memory leak when using cache feature (#792) 518f0f5

  • Don't throw on 204 No Content when parsing response (#925) 518f0f5

  • When redirect fails, don't retry from scratch (#930) 518f0f5

  • Retrying inside afterResponse hook should trigger beforeRetry hook (#918) 518f0f5

  • Fix a bug that sometimes caused the Node.js process to hang 518f0f5

  • Fix a bug where cookies weren't reset on redirect between two different sites 518f0f5

  • Make the progress events not be based on internal Node.js properties cd11a50

All commits

v9.6.0...v10.0.0

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.