Registry / storage / redux-storage-merger-simple

redux-storage-merger-simple

library1.0.5jsnpmunverified

Default merger function for redux-storage, used to combine loaded state with the initial reducer state. This package is part of the react-stack fork of the original, now-deprecated redux-storage ecosystem. Version 1.0.5 is the latest and has been stable since 2016. It is a simple shallow merge utility, unlike deeper mergers like redux-storage-merger-immutablejs. Requires redux-storage (>= 1.0).

storage

npm install redux-storage-merger-simple

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · REDUX-STORAGE-MERG

redux-storage-merger-simple

storagejavascriptv1.0.5

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import merger from 'redux-storage-merger-simple';

✗ import { merger } from 'redux-storage-merger-simple';

The package exports a single function as default export.

merger (as name)

✓ import simpleMerger from 'redux-storage-merger-simple';

✗ const simpleMerger = require('redux-storage-merger-simple');

CommonJS require works but default import is preferred in ES6 modules.

TypeScript types

✓ import merger from 'redux-storage-merger-simple';

✗ import { default as merger } from 'redux-storage-merger-simple';

TypeScript users can import the default directly; the package has no type definitions, so use @types/redux-storage or declare module.

Shows how to use the simple merger with redux-storage's reducer function to combine persisted state with the initial reducer.

import { createStore, applyMiddleware } from 'redux'; import * as storage from 'redux-storage'; import merger from 'redux-storage-merger-simple'; import reducer from './reducer'; const wrappedReducer = storage.reducer(reducer, merger); const store = createStore(wrappedReducer);

Debug

Known issues

deprecatedThe original redux-storage ecosystem (including this package) is deprecated in favor of redux-persist or other solutions.

fix

Migrate to redux-persist or another modern state persistence library.

affects: >=1.0

gotchaThis merger performs a shallow merge only: nested objects are replaced, not merged.

fix

Use a deep merge solution like redux-storage-merger-immutablejs or lodash.merge if you need deep merging.

affects: >=1.0

breakingThe package was forked after the original author deprecated it. The npm package is now maintained by react-stack under the same name.

fix

If you were using the original package by michaelcontento, the API is unchanged; just update to the latest version.

affects: >=1.0.3

Errors

Common errors & fixes

TypeError: merger is not a function

Using import { merger } instead of import merger (default export).

fix

Use import merger from 'redux-storage-merger-simple';

Module not found: Can't resolve 'redux-storage-merger-simple'

Package not installed or removed from dependencies.

fix

Run npm install redux-storage-merger-simple --save

redux-storage: No merger provided, falling back to simple merge

Not passing any merger argument to storage.reducer; it still works but this warning appears.

fix

Pass merger as second argument: storage.reducer(reducer, merger);

Upgrade

Version history

1.0.5latest on npm

Audit

Dependencies

redux-storagerequiredThis merger is designed to be used with redux-storage's reducer function.

Agent activity

29 hits · last 30 days

node

Amazon

Resources

githubhttps://github.com/react-stack/redux-storage-merger-simple ↗

packageredux-storage-merger-simple ↗

homepagehttps://github.com/react-stack/redux-storage-merger-simple ↗