immer

11.2.9 · 22 Oct 2026MIT89.4M / weekRepository Homepage npm Atom feed

Upgrading immer From 9.0.21 to 10.0.0

Same major only

1 release in betweenevery note read

Other targets from 9.0.21Latest11.2.9

Tick each one off as you go

Immer 10 only supports modern browsers, that have support for Proxy, Reflect, Symbol and Map and Set.
breaking10.0.0
There is no longer a UMD build exposed (thanks Mark Erikson for modernizing the build setup in #1032!
breaking10.0.0
Getters and setters are ignored by default on plain object, as this is a very uncommon case and provides a significant performance boost (ca 33%, but depends a lot on the scenario). Fixes #867, #1012. Thanks hrsh7th for implementing it in #941!
breaking10.0.0
Promise based reducers are no longer supported. Conceptually it is an anti pattern to hold on to drafts over time. If needed the old behavior can still be achieved by leveraging createDraft and finishDraft.
breaking10.0.0
ES5 mode (for legacy browsers) has been dropped. If your project relies on enableES5(), you SHOULD NOT upgrade Immer. enableES5 has been removed.
breaking10.0.0
produce is no longer exposed as the default export. This improves eco system compatibility, and makes sure that there is only one correct way of doing things
breaking10.0.0
enableAllPlugins has been removed, use enablePatches(); enableMapSet() instead
breaking10.0.0
Shortening the length of a JSON array now results in delete patches, rather than a mutation of the length property, in accordance with JSON spec. Thanks kshramt for implementing this in #964!
breaking10.0.0

6 other lines we could not sort, mostly version bumps

Immer is now an ESM package that can be directly imported into the browser. CJS should still work, UMD support has been removed.
10.0.0
If you have any enableES5() call, don't migrate
10.0.0
When using getters/ setters icmw plain objects, call useStrictShallowCopy(true) at startup
10.0.0
Replace all default imports: Replace import produce from "immer" with import {produce} from "immer"
10.0.0
Replace all calls to enableAllPlugins() with enablePatches(); enableMapSet(); to be more specific and smoothen future migrations.
10.0.0
If any producer returned a Promise, refactor it to leverage createDraft instead. Roughly:
10.0.0

npm install immer@10.0.0

Reading 10.0.0's manifest…

Check against your package.json

Which of your other dependencies stand in the way of 10.0.0. Read once, not stored.