Skip to content

Latest commit

 

History

History
121 lines (106 loc) · 3.04 KB

api.md

File metadata and controls

121 lines (106 loc) · 3.04 KB
Raw

Redux Persist API

Standard API

persistReducer(config, reducer)

persistReducer(
  config: PersistConfig,
  reducer: Reducer,
): Reducer

Where Reducer is any reducer (state, action) => state and PersistConfig is defined below

persistStore(store, config, callback)

persistStore(
  store: Store,
  config?: { enhancer?: Function },
  callback?: () => {}
): Persistor

Where Persistor is defined below

createMigrate(migrations, config)

createMigrate(
  migrations: MigrationManifest,
  config?: { debug: boolean }
)

type Persistor

{
  purge: () => Promise<void>,
  flush: () => Promise<void>,
}

The Persistor is a redux store unto itself, plus

  1. the purge method for clearing out stored state.
  2. the flush method for flushing all pending state serialization and immediately write to disk

type PersistConfig

{
  key: string, // the key for the persist
  storage: Object, // the storage adapter, following the AsyncStorage api
  version?: number, // the state version as an integer (defaults to -1)
  blacklist?: Array<string>, // do not persist these keys
  whitelist?: Array<string>, // only persist they keys
  migrate?: (Object, number) => Promise<Object>,
  transforms?: Array<Transform>,
  throttle?: number,
  keyPrefix?: string, // will be prefixed to the storage key
  debug?: boolean, // true -> verbose logs
  stateReconciler?: false | StateReconciler, // false -> do not automatically reconcile state
}

type MigrationManifest

{
  [number]: (State) => State
}

Where the keys are state version numbers and the values are migration functions to modify state.

Expanded API

The following methods are used internally by the standard api. They can be accessed directly if more control is needed.

getStoredState(config)

getStoredState(
  config: PersistConfig
): Promise<State>

Returns a promise (if Promise global is defined) of restored state.

createPersistoid(config)

createPersistoid(
  config
): Persistoid

Where Persistoid is defined below.

type Persistoid

{ 
  update: (State) => void
}

type PersistorConfig

{
  enhancer: Function
}

Where enhancer will be sent verbatim to the redux createStore call used to create the persistor store. This can be useful for example to enable redux devtools on the persistor store.

type StateReconciler

(
  inboundState: State,
  originalState: State,
  reducedState: State,
) => State

A function which reconciles:

  • inboundState: the state being rehydrated from storage
  • originalState: the state before the REHYDRATE action
  • reducedState: the store state after the REHYDRATE action but before the reconcilliation into final "rehydrated" state.