NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #807 most downloaded on npm
Create your next immutable state by mutating the current one
Latest stable
11.2.10
Last release 12 days ago
10 Nov 2026
Release timing varies
gaps range from 8 days to 3 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
10 years old
212 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
Nothing published for this version
general typing improvements for TS 3.7 and up
Your coding agent can read these notes before it upgrades. Set up the MCP server →
# 5.1.0 (2019-12-20) ### Features * convert Immer to TypeScript
Nothing published for this version
Nothing published for this version
Merge branch 'oriSomething-fix-472'
Fixed #477, Immer crashes without an Object.assign polyfill
BREAKING CHANGE: Maps and Sets are treated differently now; they will no longer directly mutated when updated inside a draft
❤ immer? 👉 https://opencollective.com/immer
This release introduces first class support for Maps and Sets!
BREAKING CHANGE: Maps and Sets are treated differently now; they will no longer directly mutated when updated inside a draft
Some things to keep in mind:
add, set, delete and clearautoFreeze is enabled, the maps and sets returned from a producer will be artificially frozen by making their mutative APIs unusableOpen questions
Draft's, is limited, see #448 for detailsCredits to @runnez, @aigoncharov and @aleclarson for making this happen!
## 4.0.2 (2019-10-22) ### Bug Fixes * add immerable Flow typedef
Don't use proxies if Proxy.revocable is not defined. Fixes #435
In development mode, any new value stored in a tree will be deeply frozen.
Nothing published for this version
Always use remove command in generateArrayPatches() (d483334), closes #208
introduced produceWithPatches. Implements #400
don't unnecessary modify draft if replaying patches results in a new state anyway
build: add unpkg and jsdelivr fields to package.json
ensure Symbol.for exists before calling it (#366) (c8ecbad), closes #365
Got ahead of myself with Map support (see here: https://github.com/immerjs/immer/pull/353)
ts: Immutable / read-only arrays in TS 3.4+
immerjs (17d69c3)build: publish source files (fb92884), closes #335
build: use .module.js instead of .mjs for esm bundle
share internal symbols between immer installations (02fed2c), closes #322
# 2.1.0 (2019-02-28) ### Features * improved array patches
es5: throw if a modified child draft is returned
applyPatches should mutate drafts (d41be77), closes #301
# 1.12.0 (2019-01-22) ### Features * export isDraftable
use getOwnPropertySymbols only when it exists
es5: account for drafts in prepareCopy
ts: reorder generic parameters of IProduce
ts: ensure produce returns an immutable type
ts: base type of curried producer
ts: parameter types of curried producers (89f6443), closes #288
# 1.10.0 (2019-01-04) ### Features * passing drafts to produce
ts: produce function (fa5bf5d), closes #270
revert .d.ts and .js.flow module names
TypeScript users: Please pin your immer version to 1.8 if you use typescript <3.1.1. Thanks!
TypeScript users: Please pin your immer version to 1.8 if you use typescript <3.1.1. Thanks!
Immer class (ecd04dc), closes #254Immer class (7f50364)Immer class (f36d329)## 1.8.2 (2018-12-12) ### Bug Fixes * ci: build before release
For v1.8.0 and under, please visit the old changelog.md.
For v1.8.0 and under, please visit the old changelog.md.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.