endograph/redux-persist

¿Qué es?

Funciones clave

• 01Envuelve el reducer raíz con persistReducer y crea un persistor con persistStore.
• 02Incluye compatibilidad con localStorage y sessionStorage, además de motores de almacenamiento intercambiables para otros backends.
• 03Permite elegir las claves que se guardan con allowlist y denylist, o mediante una función de filtro.
• 04Admite persistencias anidadas, transformaciones del estado y migraciones versionadas.
• 05Proporciona PersistGate y useRehydrated para que React espere hasta que se restaure el estado.

Casos de uso

• Conservar las preferencias de usuario o el estado relacionado con el inicio de sesión al recargar el navegador en una aplicación React.
• Persistir el estado de Redux en una aplicación React Native que usa AsyncStorage como backend.
• Guardar el estado de una aplicación sin conexión en una PWA o aplicación de escritorio que use IndexedDB o el sistema de archivos.
• Actualizar de forma segura el estado guardado cuando cambia la estructura de un slice de Redux entre versiones.

Inicio rápido

1. 1

   Instala el paquete desde npm

   npm install redux-persist
2. 2

   En el archivo de tu store, envuelve el reducer raíz con persistReducer y crea un persistor con persistStore

3. 3

   Envuelve el componente raíz con PersistGate de redux-persist/react (opcional, para React)

Antes de usarlo

• !v7 requiere Redux Toolkit 2 o Redux 5.
• !La versión v7 está en fase beta (instálala con la etiqueta next).

Temas

Preguntas frecuentes

¿Qué es redux-persist?

Una biblioteca tipo middleware de Redux que guarda el estado del store y lo restaura al iniciar la aplicación. redux-persist guarda el estado de un store de Redux en el almacenamiento a medida que cambia y lo rehidrata en el store al iniciar la aplicación, para que los usuarios conserven sus datos al cargar una página o abrir la aplicación. Envuelve el reducer raíz con persistReducer y crea un persistor con persistStore; el resto de la aplicación sigue igual y Redux Toolkit funciona sin configuración adicional.

¿redux-persist es gratuito? ¿Qué licencia tiene?

redux-persist es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.

¿redux-persist sigue mantenido?

Mantenimiento activo. El último commit de redux-persist fue el 7 oct 2026.

¿Para qué puedo usar redux-persist?

Conservar las preferencias de usuario o el estado relacionado con el inicio de sesión al recargar el navegador en una aplicación React. Persistir el estado de Redux en una aplicación React Native que usa AsyncStorage como backend. Guardar el estado de una aplicación sin conexión en una PWA o aplicación de escritorio que use IndexedDB o el sistema de archivos. Actualizar de forma segura el estado guardado cuando cambia la estructura de un slice de Redux entre versiones.

¿Cómo se instala redux-persist?

Instala el paquete desde npm: npm install redux-persist En el archivo de tu store, envuelve el reducer raíz con persistReducer y crea un persistor con persistStore Envuelve el componente raíz con PersistGate de redux-persist/react (opcional, para React)

¿Dónde consigo redux-persist?

El código fuente y las instrucciones de instalación están en GitHub: https://github.com/endograph/redux-persist