rt2zz/redux-persist hiện có 12.9k sao trên GitHub, viết chủ yếu bằng TypeScript. persist and rehydrate a redux store
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
VÌ SAO CHƯA CÓ REVIEW
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Persist and rehydrate a redux store. Your state is saved to storage as it
changes and restored into the store when your app starts.
Hey all! redux-persist is maintained again, and v7 is in beta
(npm install redux-persist@next): Redux Toolkit 2 support with no extra
setup, a fix for stored data getting wiped
(#809), and lots
more. Please try it and tell us how it goes in
the v7 beta discussion.
These docs are for v7, which needs Redux 5 or Redux Toolkit 2. Upgrading
from 6? Read the migration guide; your stored
data carries over as is. For 6.x, see the
v6 docs.
Drop-in. Wrap your root reducer with persistReducer and call
persistStore. Nothing else in your app changes, and Redux Toolkit needs no
extra setup.
Any storage. localStorage and sessionStorage ship in the box;
AsyncStorage, IndexedDB, the filesystem and more plug in —
storage engines.
You choose what's saved. Allow or block keys, nest persisted reducers
for finer control, and transform state on the way in and out.
Versioned. Migrations upgrade stored state when its shape changes —
how migrations work.
Quickstart
npm install redux-persist
Wrap your root reducer and create a persistor alongside the store:
// app/store.ts
import { configureStore, combineReducers } from '@reduxjs/toolkit'
import { persistStore, persistReducer } from 'redux-persist'
import storage from 'redux-persist/storage' // localStorage on the web
import userReducer from './features/user/userSlice'
import configReducer from './features/config/configSlice'
const rootReducer = combineReducers({
user: userReducer,
config: configReducer
})
const persistConfig = {
key: 'root',
version: 1,
storage,
}
const persistedReducer = persistReducer(persistConfig, rootReducer)
export const store = configureStore({
reducer: persistedReducer,
})
export const persistor = persistStore(store)
If you use React, wrap your root component in
PersistGate. It holds off rendering until the stored
state has been loaded back into redux. loading can be null or any React
element, e.g. loading={<Loading />}.
import { PersistGate } from 'redux-persist/react'
import { store, persistor } from './app/store'
// ... normal setup, import components etc.
const App = () => {
return (
<Provider store={store}>
<PersistGate loading={null} persistor={persistor}>
<RootComponent />
</PersistGate>
</Provider>
);
};
If you'd rather not gate rendering, useRehydrated(persistor) from
redux-persist/react returns whether stored state has loaded.
Every app has to decide how many levels of stored state to merge into its
initial state. The default is one level; read
state reconcilers before you ship.
redux-persist/storage works during server rendering (Next.js and others): on
the server it stores nothing, and stored state is loaded in the browser. With
the Next.js App Router, render PersistGate from a Client Component; see
PersistGate.
Choosing what's saved
denylist and allowlist pick top-level keys:
persistReducer({ key: 'root', storage, denylist: ['navigation'] }, rootReducer) // navigation will not be persisted
persistReducer({ key: 'root', storage, allowlist: ['navigation'] }, rootReducer) // only navigation will be persisted
They're checked against your state's keys, so a typo is a type error. If you
declare the config separately, annotate it with PersistConfig<RootState> or
use as const on the array. The older names blacklist and whitelist still
work.
For keys you can't list ahead of time, pass a function that's called with each
top-level key:
persistReducer({ key: 'root', storage, denylist: key => key.startsWith('temp') }, rootReducer) // keys starting with temp will not be persisted
To go deeper than one level, use nested persists.
Resetting state on logout
Reset state inside the reducer you pass to persistReducer, so the reset
state is saved too:
The reset state is saved like any other change. To write it right away (for
example before the app might close), await persistor.flush() after
dispatching the action.
Don't reset above persistReducer (by wrapping the persisted reducer, or with
a store enhancer that replaces the whole state): that removes the _persist
key, so the state stops being saved, and the previous user's state is loaded
again on the next launch. redux-persist logs an error in development when this
happens.
Learn more
API — persistReducer, persistStore, the persistor, and config types
PersistGate — delaying render until rehydration finishes
State reconcilers — how stored state merges with initial state
Nested persists — per-branch storage, code splitting, deep filtering
Migrations — upgrading stored state between versions
Transforms — customizing what's serialized, and community transforms
Storage engines — built-in and community storage backends
Recipes — loading state later, state per user, syncing tabs, knowing when state was saved, encryption
Hot module replacement
Migrating from v6 to v7
Storage format — what's stored, and the compatibility promise
Migrating from v4 to v5
Contributing
Bug reports and pull requests are welcome; see CONTRIBUTING.md,
especially before changing anything that touches stored data. Questions and
feature ideas go in Discussions.
Feedback on the v7 beta goes in the v7 beta discussion.
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/rt2zz/redux-persist là nguồn chính thức.
rt2zz/redux-persist có bao nhiêu sao?
rt2zz/redux-persist có 12.9k sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/rt2zz/redux-persist. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
rt2zz/redux-persist có phải mã nguồn mở không?
Có — rt2zz/redux-persist phát hành theo license MIT, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/rt2zz/redux-persist.
rt2zz/redux-persist còn đang phát triển không?
Commit gần nhất trên rt2zz/redux-persist là 17 ngày trước (theo timestamp GitHub). Repo có 838 fork — một chỉ báo về mức độ quan tâm của cộng đồng.
rt2zz/redux-persist là gì?
rt2zz/redux-persist (rt2zz/redux-persist) là dự án TypeScript trên GitHub. Theo mô tả gốc: persist and rehydrate a redux store
Đọc đầy đủ README ở tab phía trên.
redux-persist có đáng để bạn bỏ thời gian?
ChatGPT, Claude và Perplexity đều đọc được trang này. Hỏi thử xem họ nghĩ gì về redux-persist.