Packages

got

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

Upgrading got From 11.8.6 to 12.0.0

1 release in betweenevery note read

Reading releases, release notes and advisories…

Other targets from 11.8.6Latest16.2.0
  1. 11.8.6yours
  2. 12.0.0target

Before you upgrade

Tick each one off as you go
  • Breaking12.0.0
  • Breaking12.0.0
  • Breaking12.0.0
  • Breaking12.0.0
  • Breaking12.0.0
  • Breaking12.0.0
  • Breaking12.0.0
  • Breaking12.0.0
  • Breaking12.0.0
  • Breaking12.0.0

Security

1 advisory still affects 12.0.0

Upgrading to 12.1.0 clears it.

Release by release

  1. 12.0.0

    Migration needed10 Dec 202119 new · 25 fixes
    • Breaking

      Got exports an Option class that is specifically designed to parse and validate Got options. It is made of setters and getters that provide fast normalization and more consistent behavior.

    • Breaking

      The init hook now accepts a second argument: self, which points to an Options instance.

    • Breaking

      The init hooks are ran only when passing an options object explicitly.

    • Breaking

      options.merge() replaced got.mergeOptions and Request.normalizeArguments

6 other lines we could not sort, mostly version bumps
  • Please don't open issues about [ERR_REQUIRE_ESM] and Must use import to load ES Module errors. This is a problem with your setup, not Got.

    12.0.0
  • Please don't open issues about using Got with Jest. Jest does not fully support ESM.

    12.0.0
  • Pretty much any problem with loading this package is a problem with your bundler, test framework, etc, not Got.

    12.0.0
  • If you use TypeScript, you will want to stay on Got v11 until TypeScript 4.6 is out. Why.

    12.0.0
  • If you use a bundler, make sure it supports ESM and that you have correctly configured it for ESM.

    12.0.0
  • The Got issue tracker is not a support channel for your favorite build/bundler tool.

    12.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.