Packages

got

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

Your version

15.0.0

major1 Apr 2026Where it was published

15.1.0 is the newest release of 15.x.

In short

9 breaking2 new2 changed

  • Breaking

    Require Node.js 22 b933476

  • Breaking

    Remove promise cancel API a06ac6c

  • Breaking

    Remove isStream option c241c6c

  • Breaking

    Use native FormData global 670b228

  • Breaking

    responseType: 'buffer' returns Uint8Array instead of Buffer 309e36d

  • Breaking

    Piped header copying is now opt-in 8e392f3

  • Breaking

    url removed from public options objects 87de8d6

  • Breaking

    300 and 304 responses are no longer auto-followed 5fccaab

Release note

Breaking changes

  • Breaking

    Require Node.js 22 b933476

  • Breaking

    Remove promise cancel API a06ac6c

  • Breaking

    Remove isStream option c241c6c

    • Use got.stream() directly.

  • Breaking

    Use native FormData global 670b228

  • Breaking

    responseType: 'buffer' returns Uint8Array instead of Buffer 309e36d

    • response.rawBody and promise.buffer() now return a Uint8Array. Buffer is a subclass of Uint8Array, so most code will continue to work, but strict type checks will need updating.

  • Breaking

    strictContentLength defaults to true 08e9dff

    • Got now throws a ContentLengthMismatchError by default if Content-Length doesn't match the actual body size. Set {strictContentLength: false} to restore the old behavior.

  • Breaking

    retry.enforceRetryRules defaults to true 9bc8dfb

    • Custom calculateDelay functions are now only called when a retry is actually allowed by limit, methods, statusCodes, and errorCodes. If your calculateDelay was previously used to override retry eligibility unconditionally, set {retry: {enforceRetryRules: false}}.

  • Breaking

    Piped header copying is now opt-in 8e392f3

    • Got no longer automatically copies headers from a piped stream. Set {copyPipedHeaders: true} to re-enable. Hop-by-hop headers are never copied even when enabled (RFC 9110 §7.6.1).

  • Breaking

    url removed from public options objects 87de8d6

    • The url property is no longer present on the options object passed to hooks. Use response.url or request.requestUrl instead.

  • Breaking

    300 and 304 responses are no longer auto-followed 5fccaab

    • Per RFC 9110, 304 is a conditional-GET hint, not a redirect, and 300 is only a SHOULD for user agents. Got now returns these responses as-is. Handle them manually if needed.

  • Breaking

    Removed the undocumented named export for Got.

    • Got has always been a default export. The named export was there only for buggy build tools during the ESM migration times.

Improvements

  • Stream decode large text/json bodies incrementally for lower peak memory usage c9a95b1

  • uploadProgress now emits granular per-chunk events for json and form request bodies 13c889d


Migration guide

Replace promise.cancel() with AbortController

Before:

const promise = got(url);
promise.cancel();

After:

const controller = new AbortController();
const promise = got(url, {signal: controller.signal});
controller.abort();

Replace isStream: true with got.stream()

Before:

got(url, {isStream: true});

After:

got.stream(url);

Replace form-data / form-data-encoder with native FormData

Before:

import {FormData} from 'formdata-node';
// or: import {FormData} from 'formdata-polyfill/esm.min.js';

const form = new FormData();
form.set('name', 'value');
await got.post(url, {body: form});

After:

const form = new FormData();
form.set('name', 'value');
await got.post(url, {body: form});

Update Buffer usage to Uint8Array

response.rawBody and promise.buffer() now return Uint8Array instead of Buffer.

Before:

const data = await got(url).buffer();
const copy = Buffer.from(data);

After:

const data = await got(url).buffer();
const copy = new Uint8Array(data);

If you need Buffer-specific APIs, wrap with Buffer.from(data.buffer, data.byteOffset, data.byteLength).

strictContentLength is now on by default

If you send requests where the Content-Length header might not match the actual body size, opt out:

got.extend({strictContentLength: false});

retry.enforceRetryRules is now on by default

If your calculateDelay function was overriding retry eligibility (e.g. retrying on methods or status codes outside the defaults), opt out:

got.extend({
	retry: {
		enforceRetryRules: false,
		calculateDelay: ({computedValue}) => {
			// computedValue is 0 when retry is not allowed
			if (computedValue === 0) {
				return 0;
			}

			return computedValue;
		},
	},
});

Piped header copying is now opt-in

If you pipe streams into Got and rely on automatic header forwarding (e.g. Content-Type), re-enable it:

got.extend({copyPipedHeaders: true});

300 and 304 responses are no longer followed

If your code depended on Got auto-following 300 Multi-Choice or handling 304 Not Modified as a redirect, you now need to handle them yourself in an afterResponse hook or check response.statusCode manually.


v14.6.6...v15.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.