Borrado del almacenamiento y estrategias de migración
Utilice multiRemove y clear para borrar de forma selectiva o completa la caché e implemente una estrategia de migración versionada para gestionar cambios en el esquema de almacenamiento entre actualizaciones de la aplicación.
Borrado del almacenamiento y estrategias de migración es una lección gratuita de React Native Academy en CoddyKit. Esta es la lección 4 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de React Native Academy, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de React Native Academy incluye 4 lecciones en total.
Partes de esta lección aún no han sido traducidas y se muestran en inglés.
Why Storage Maintenance Matters
As your app evolves across versions, the data structure you store in AsyncStorage may change. Old data from previous app versions might not match what the new code expects, leading to crashes or incorrect behavior. A solid storage maintenance strategy — including selective clearing and versioned migrations — is essential for apps that have real users with existing data.
Removing Specific Keys with multiRemove
AsyncStorage.multiRemove accepts an array of key strings and deletes all of them in a single operation. This is more efficient than calling removeItem repeatedly in a loop. Use it when a user action should clear a specific subset of data — for example removing all cached API responses without touching user preferences.
async function clearCache() {
const cacheKeys = [
'posts_cache',
'comments_cache',
'user_feed_cache',
];
try {
await AsyncStorage.multiRemove(cacheKeys);
console.log('Cache cleared');
} catch (err) {
console.error('Failed to clear cache:', err);
}
}Clearing All App Data with clear
AsyncStorage.clear() removes all keys stored by the app. Use this only for destructive operations like a factory reset or during development when you need a clean slate. In production, always confirm with the user before calling clear() because it cannot be undone and deletes everything — preferences, cached data, and auth tokens alike.
async function factoryReset() {
await AsyncStorage.clear();
// Reset in-memory state too
useAuthStore.getState().logout();
useSettingsStore.getState().reset();
navigation.reset({ index: 0, routes: [{ name: 'Onboarding' }] });
}Finding Keys to Remove Dynamically
When you store data with dynamic keys (like post_123, post_456), use getAllKeys to find them and filter by a prefix before passing the matching keys to multiRemove. This pattern is useful for clearing all cached pages from a paginated feed without hardcoding each key.
async function clearPostsCache() {
const allKeys = await AsyncStorage.getAllKeys();
const postKeys = allKeys.filter((key) => key.startsWith('post_'));
if (postKeys.length > 0) {
await AsyncStorage.multiRemove(postKeys);
console.log('Cleared', postKeys.length, 'cached posts');
}
}What Is a Storage Migration?
A storage migration upgrades stored data from one schema version to a newer one. When you release a new app version that changes how data is stored — for example renaming a key or adding a required field — migrating existing users' data prevents crashes and data loss. Migrations run once on startup and mark the completion with a version flag.
Versioning Your Storage Schema
Store a schema version number in AsyncStorage alongside your data. On startup, read this version number and compare it to the current expected version. If they differ, run the appropriate migration steps, then update the stored version number. Future launches skip the migration because the versions match.
const CURRENT_VERSION = 3;
const VERSION_KEY = 'storage_version';
async function getStorageVersion(): Promise<number> {
const v = await AsyncStorage.getItem(VERSION_KEY);
return v ? parseInt(v, 10) : 0; // 0 means fresh install or pre-versioning
}
async function setStorageVersion(version: number) {
await AsyncStorage.setItem(VERSION_KEY, String(version));
}Writing a Migration Function
Write a migration function that handles each version upgrade step. Use a switch statement or a series of if checks that fall through from the stored version up to the current version. Each case applies the changes needed to advance one version, so a user upgrading from v1 to v3 runs both the v1-to-v2 and v2-to-v3 migrations in sequence.
async function runMigrations(fromVersion: number) {
if (fromVersion < 1) {
// v0 → v1: rename 'user_name' key to 'username'
const old = await AsyncStorage.getItem('user_name');
if (old) {
await AsyncStorage.setItem('username', old);
await AsyncStorage.removeItem('user_name');
}
}
if (fromVersion < 2) {
// v1 → v2: add default 'fontSize' to settings
const json = await AsyncStorage.getItem('settings');
if (json) {
const settings = JSON.parse(json);
if (!settings.fontSize) settings.fontSize = 'medium';
await AsyncStorage.setItem('settings', JSON.stringify(settings));
}
}
await setStorageVersion(CURRENT_VERSION);
}Running Migrations on App Start
Call the migration logic in your root component's useEffect before anything else reads from storage. This ensures all data is in the expected shape before any screen tries to use it. Keep migrations idempotent — running them twice on the same data should produce the same result to handle edge cases like interrupted writes.
useEffect(() => {
async function init() {
const version = await getStorageVersion();
if (version < CURRENT_VERSION) {
await runMigrations(version);
}
// Now safe to load data — migration is complete
await loadAppData();
setAppReady(true);
}
init();
}, []);Expiring Cached Data
Cache data should not live forever. Store a timestamp alongside cached API responses and check whether it has expired when the app starts or when the user navigates to a screen. If expired, delete the cache and fetch fresh data. A helper function that wraps the cache check makes this reusable across all cached endpoints.
const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
async function isCacheExpired(key: string): Promise<boolean> {
const tsStr = await AsyncStorage.getItem(key + '_timestamp');
if (!tsStr) return true;
return Date.now() - parseInt(tsStr, 10) > CACHE_TTL_MS;
}
async function setCache(key: string, data: any) {
await AsyncStorage.setItem(key, JSON.stringify(data));
await AsyncStorage.setItem(key + '_timestamp', String(Date.now()));
}Selective Logout: Clearing Only User Data
When a user logs out, clear their personal data (auth token, profile, private cache) but preserve device preferences like theme and language. Use multiRemove with a specific list of keys rather than clear(). This provides a better UX because the user's display preferences are still there when they log back in.
const USER_DATA_KEYS = ['authToken', 'userProfile', 'feed_cache', 'userId'];
async function logout() {
await AsyncStorage.multiRemove(USER_DATA_KEYS);
// Preferences (theme, language) remain intact
navigation.reset({ index: 0, routes: [{ name: 'Login' }] });
}Documenting Your Storage Schema
Maintain a storage schema documentation file in your project that lists every AsyncStorage key, its type, its default value, and which version it was introduced. This is invaluable when writing migrations, debugging storage issues, and onboarding new developers. Treat it like a database schema — update it every time you add, rename, or remove a stored key.
/**
* AsyncStorage Schema v3
* -------------------------
* Key | Type | Since | Description
* authToken | string | v1 | JWT auth token
* username | string | v1 | (was user_name in v0)
* settings | JSON | v1 | { darkMode, notifications, fontSize }
* .fontSize added v2, .language added v3
* storage_version | number | v1 | Current schema version
*/Quick Check
Test your understanding of React Native Mobile Development concepts from this lesson.
Lesson Recap
In this lesson you learned: multiRemove efficiently clears a specific set of keys while leaving others intact, versioned migrations upgrade old stored data when the app schema changes across releases, and expiring cached data with timestamps prevents stale API responses from living in storage indefinitely. Next up we explore camera access with expo-camera.
Aprende JavaScript con un tutor de IA — gratis
Escribe y ejecuta código real en tu navegador, obtén ayuda instantánea de un tutor de IA disponible 24/7 y continúa donde lo dejaste en la web o en la aplicación.
- Cursos
- 30
- Lecciones
- 120
Preguntas frecuentes
¿La lección «Borrado del almacenamiento y estrategias de migración» es gratis?
Sí — el texto completo de «Borrado del almacenamiento y estrategias de migración» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de React Native Academy, actualiza a CoddyKit PRO. El curso de React Native Academy incluye 4 lecciones en total.
¿Qué aprenderé en «Borrado del almacenamiento y estrategias de migración»?
Utilice multiRemove y clear para borrar de forma selectiva o completa la caché e implemente una estrategia de migración versionada para gestionar cambios en el esquema de almacenamiento entre actuali… Practicas React Native Academy con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.
¿Necesito experiencia previa para empezar React Native Academy?
No se requiere experiencia previa. React Native Academy en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 4 de 4.
¿Cuánto tiempo toma la lección «Borrado del almacenamiento y estrategias de migración»?
La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.
¿Puedo escribir y ejecutar código en esta lección de React Native Academy?
Sí. Cada lección de React Native Academy incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.
Todas las lecciones de este curso
- Lectura y escritura con AsyncStorage
- Almacenamiento y análisis de objetos JSON
- Creación de una pantalla de ajustes persistentes
- Borrado del almacenamiento y estrategias de migración