NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
npm, #4512 most downloaded on npm
Simple, scalable state management.
Latest stable
7.1.6
Last release 10 days ago
10 Nov 2026
Ships unpredictably
gaps range from 9 days to 7 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
11 years old
274 releases · first in 2016
Drag across the ruler to compare, or tap a release to open it.
`d78a1592` #2902 Thanks @z3rog! - chore: observable use internal constants
d78a1592 #2902 Thanks @z3rog! - chore: observable use internal constants
db21d85f #2998 Thanks @urugator! - trace(): log when computed becomes suspended
requiresReaction warns instead of throwing
b9fa119c #3056 Thanks @upsuper! - Create WHEN_TIMEOUT error earlier to capture useful stack
99491ec2 #2972 Thanks @kk-gjyang! - Polyfill Object.is for old/unsupported browsers
0d28db8a #2927 Thanks @upsuper! - Give proper typing to opts.equals of reaction
c6dc925c #2985 Thanks @fecqs! - Remove duplicate global property check
Your coding agent can read these notes before it upgrades. Set up the MCP server →
`4011b378` #2949 Thanks @urugator! - fix #2948: flow ignores autoBind option
`d678ebd7` #2944 Thanks @urugator! - Fix #2941 - flow.bound replaces method on proto with bound function
Release job failed. See https://github.com/mobxjs/mobx/pull/2842 for release notes
Release job failed. See https://github.com/mobxjs/mobx/pull/2842 for release notes
bc8db3df #2779 Thanks @urugator! - In mobx5 all own properties were by default observable regardless of their value. Since mobx6 we treat functional properties as actions or to be precise autoActions. autoAction provides action's benefits to your functions, without the need to explicitely annotate them as actions.
We think this is useful, but as a consequence, such properties are no longer observable and therefore non-writable and also non-enumerable. This turned out to be suprising and inconvinient to some users:
https://github.com/mobxjs/mobx/discussions/2760
https://github.com/mobxjs/mobx/discussions/2586
https://github.com/mobxjs/mobx/issues/2835
https://github.com/mobxjs/mobx/issues/2629
https://github.com/mobxjs/mobx/issues/2551
https://github.com/mobxjs/mobx/issues/2637
So we decided to change it: All own props including functions are observable (enumerable, writable) as in v5, but additionally all functions that become part of deeply observable structure are by default converted to autoAction/flow.
Note that deep option affects this conversion in the same way as it affects conversion of other values (object/array/map/set).
autoActions/flowsdeep: false ignores all property values (including functions that would be previously converted to autoAction/flow)actions6b324edc #2873 Thanks @urugator! - Fix #2871: toJS throws with configure({ useProxies: "ifavailable" })`ca4914f9` #2836 Thanks @urugator! - Fix #2832 - annotation cache ignores overrides
`5640aa77` #2799 Thanks @urugator! - - fix: user provided debug names are not preserved on production
5640aa77 #2799 Thanks @urugator! - - fix: user provided debug names are not preserved on production
observable(primitive, options) ignores optionsgetDebugName(action) throws [MobX] Cannot obtain atom from undefinedunsafe: true`9b195b17` #2780 Thanks @iChenLei! - The overall memory usage of MobX has been reduced in production builds by skipping the generation of debug identi
`3979bee3` #2773 Thanks @urugator! - Decorators optimization
7820e5ea #2769 Thanks @iChenLei! - add warn for extending builtins
a7c15171 #2775 Thanks @pkit! - use globalThis in global detection
5d41b646 #2774 Thanks @urugator! - Fix: makeAutoObservable now working properly with symbolic keys
Fix: isComputedProp and getAtom second arg type is incompatible with Symbols
`0677c0e7` #2766 Thanks @urugator! - Fix: Inherited annotated fields are not assignable
`d2a2a52e` #2763 Thanks @vkrol! - Add safeDescriptors to configure options type
`ca09f2f5` #2761 Thanks @urugator! - configure({ safeDescriptors: false }) now forces all props of observable objects to be writable and configurable
`39eca50d` #2757 Thanks @urugator! - Fix error stringification on minified build Fix isObservableProp not supporting Symbols Fix makeAutoObservable no
Removed deprecated action.bound("name")
This release fixes a plethora of bugs related to sub-classing and reflecting / iterating on observable objects. The behavior of MobX is in many edge cases much more explicitly defined now.
A new annotation was introduced: @override / override to support re-defining actions and computed values(!) on sub classses.
For idiomatic MobX usage this release should have little impact, but if you are using a lot of sub-classing, reflection APIs or direct object manipulations like defineProperty,
this release might introduce previously unseen errors for cases that silently failed before, or even worked successfully even though the correct behavior wasn't specified earlier.
If you are migrating from MobX 4/5 we strongly recommend to go to 6.1 in one go, and skip 6.0.*, as some buggy behavior compared to the previous majors has been corrected.
As always, our libraries come as-is and are maintained by volunteers. Upgrades are at own risk and voluntary. Bug reports require a minimal reproductions and a correctly filled out issue template.
Support the ongoing maintenance at: https://opencollective.com/mobx
28f8a11d #2641 Thanks @urugator!
action, computed, flow defined on prototype can be overriden by subclass via override annotation/decorator. Previously broken.this) is not supported and should throw. Previously partially possible or broken.Object.defineProperty. Previously unsupported/broken.extendObservable/makeObservable/defineProperty notifies observers/listeners/interceptors about added props. Previously inconsistent.keys/values/entries works like Object.keys/values/entries. Previously included only observables.has works like in. Previously reported true only for existing own observable props.set no longer transforms existing non-observable prop to observable prop, but simply sets the value.remove/delete works with non-observable and computed props. Previously unsupported/broken.options to observable/extendObservable/makeObservable throws if the object is already observable . Previously passed options were mostly ignored.autoBind option is now sticky - same as deep and name option.observable/extendObservable now also picks non-enumerable keys (same as make[Auto]Observable).action.bound("name")Reflect API. Previously throwing instead of returning booleans.`6b304232` #2644 Thanks @rokoroku! - Fix broken error reference in errors.ts
6b304232 #2644 Thanks @rokoroku! - Fix broken error reference in errors.ts
83b84fd3 #2740 Thanks @iChenLei! - Infer optional / promise action args type correctly
65c7b73b #2717 Thanks @ahoisl! - The TypeScript type CreateObservableOptions is now exported.
989390d4 #2594 Thanks @urugator! - Fixed #2579 - observable does not ignore class instances
dea1cf18 #2726 Thanks @mweststrate! - fix: onBecomeObserved was not triggered correctly for computed dependencies of computeds. Fixes #2686, #2667
592e6e99 #2743 Thanks @vkrol! - Remove sideEffects section in mobx-react-lite package.json
🚨🚨🚨 If you are upgrading from V4/V5, please follow the migration guide.
`79a09f49` #2615 Thanks @urugator! - Fix #2614 - makeObservable does not respect options.name
`d0e6778d` - Create ESM bundles with NODE_ENV correctly replaced so it can be used in browser
d0e6778d - Create ESM bundles with NODE_ENV correctly replaced so it can be used in browser (#2564)`b5d64d19` #2548 Thanks @urugator! - Fixed 2542, makeAutoObservable not respecting deep option @urugator
Fixed issue in TS typings of makeObservable in combination with a member named toString()
makeObservable in combination with a member named toString()`makeObservable(target, annotations)` is now the recommended way to make objects with a fixed shape observable, such as classes.
makeObservable(target, annotations) is now the recommended way to make objects with a fixed shape observable, such as classes.makeAutoObservable(target) will automatically determine the annotations used by makeObservable. Methods will be marked as 'autoAction', so that they can be used both from a computed value or as standalone method.observable.array now supports { proxy: false } as option.reaction's effect function now receives the previous value seen by the reaction as second argument.flow can now be used as annotation as well. You might need flowResult in case you use TypeScript to extract the correct result type. details.decorate API has been removed, and needs to be replaced by makeObservable in the constructor of the targeted class. It accepts the same arguments. The mobx-undecorate can transform this automatically.extendObservable / observable, fields that contained functions used to be turned into observables. This is no longer the case, they will be converted into autoActions.observed mode.toJS no longer takes any options. It no longer converts Maps and Sets to plain data structures. Generic, flexible serialization of data structures is out of scope for the MobX project, and writing custom serialization methods is a much more scalable approach to serialization (tip: leverage computeds to define how class instances should be serialized).intercept and observe are no longer exposed on observable arrays, maps and boxed observables. Import them as utility from mobx instead: import { observe, intercept } from "mobx", and pass the collection as first argument: observer(collection, callback). Note that we still recommend to avoid these APIs.observableMap.toPOJO(), observableMap.toJS() have been dropped. Use new Map(observableMap) instead if you want to convert an observable map to a plain Map shallowly.observableMap.toJSON() now returns an entries array rather than a new Map, to better support serialization.observableSet.toJS() has been dropped. Use new Set(observableSet) instead if you want to convert an observable Set to a plain Set shallowly.observableSet.toJSON() now returns an array rather than a new Set, to better support serialization.isArrayLike is no longer exposed as utility. Use Array.isArray(x) || isObservableArray(x) instead.@observable or makeObservable) that is already declared in a super class.runInAction no longer supports passing a name as first argument. Name the original function or use action(name, fn)() if you care about the debug name.computed(getterFn, setterFn) no longer accepts a setter function as a second argument. Use the set option instead: computed(getterFn, { set: setterFn }).findIndex / find method, the offset argument (the third one) is no longer supported, to be consistent with ES arrays.computedConfigurable of configure is no longer supported as it is now the default.observableArray.toJS() has been removed, use observableArray.slice() instead, which does the same.IGNORE_MOBX_MINIFY_WARNING environment flag._allowStateChangesInComputation(fn) is no longer needed, use runInAction(fn) instead.computed, the when predicate (first arg), and reaction predicate (first arg) it is now forbidden to directly change state. State changes should be done in their effect functions, or otherwise at least wrapped in runInAction (only the state change, not the observables you want to track!). Note that this is still an anti-pattern.observableArray.get() and observableArray.set() methods are no longer supported.IObservableObject interface is no longer exported from MobX.reaction effect function, the disposer object, is now passed in as third argument. The second argument is now the previous value seen by the reaction.onBecomeObserved / onBecomeUnobserved will now only trigger for observables that are actually used by a reaction (see #2309 for background).this for array callbacks such as in array.forEacharray.concaton(un)BecomeObservedon(un)BecomeObserved was triggered for observables changed in actions without having an observerNothing 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
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
The minimum required TypeScript version is now 3.6
The minimum required TypeScript version is now 3.6
FlowCancellationError instance whose error message is the same as in previous versions ("FLOW_CANCELLED") so this is not breaking. #2172 by @vonovakCancellablePromise Flow type is exported. #2164 by @vonovakFixed installation issue trying to run postinstall hook for a website #2165.
postinstall hook for a website #2165.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
Fixed a recent regression where array update events would send undefined as change.object through #1985 by xaviergonz
change.object through #1985 by xaviergonzNothing 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
Fixed #1667: creating a large array could result in undefined items (MobX 4.\* was not affected)
One column per quarter.