unstale

npm / @react-native-async-storage/async-storage

@react-native-async-storage/async-storage

What changed in @react-native-async-storage/async-storage 3, from its official release notes, upgrade guides and advisories. Sources checked 2026-10-18.

9 breaking1 behavior and defaults2 tooling1 fixes and other

See which of these apply to your code, ranked, in your agent:

npx @unstale/cli init

@unstale/cli 0.1.1 on npm

@react-native-async-storage/async-storage 313 changes

Breaking changes 9

  • Providing null for a key now throws an error instead of crashing the app.

    3.0.3release notes

  • Android requires an extra installation step.

    3.0.0release notes

  • Brownfield access to storage no longer uses Apple's delegate.

    3.0.0release notes

  • Batch operation methods formerly named with the multi* prefix have been renamed and their API updated.

    3.0.0release notes

  • The callback-based API is no longer available.

    3.0.0release notes

  • The flag to opt out from iCloud backup has been dropped; iCloud backup is disabled by default.

    3.0.0release notes

  • This release is missing native artifacts; the notes advise against using it and say 3.0.1 contains a fix.

    3.0.0release notes

  • Create a storage instance before using Async Storage.

    3.0.0release notes

  • The useAsyncStorage hook has been removed; it will be introduced later.

    3.0.0release notes

Behavior and default changes 1

  • The default export is a singleton storage that uses v2/v1 storage to ease transition.

    3.0.0release notes

Tooling 2

  • The Shared Storage artifact is published to Maven Central, eliminating an extra step in Android installation.

    3.1.0release notes

  • A Jest mock is included for use when testing applications with AsyncStorage.

    3.0.2release notes

Fixes and other changes 1

  • Apple platforms now correctly handle “other” errors.

    3.0.3release notes