Cours React Native · Module 9: Stockage des données

AsyncStorage - Stockage simple

1 min de lecture ·
Dans cette leçon3

Bienvenue dans les Archives de Triton ! Apprends à stocker des données en local.

Installation

npx expo install @react-native-async-storage/async-storage

Opérations de base

import AsyncStorage from '@react-native-async-storage/async-storage';

// Sauvegarder
await AsyncStorage.setItem('username', 'Poseidon');

// Sauvegarder un objet (JSON)
const user = { id: 1, name: 'Poseidon', level: 99 };
await AsyncStorage.setItem('user', JSON.stringify(user));

// Lire
const username = await AsyncStorage.getItem('username');
const userData = await AsyncStorage.getItem('user');
const user = userData ? JSON.parse(userData) : null;

// Supprimer
await AsyncStorage.removeItem('username');

// Plusieurs clés
await AsyncStorage.multiSet([['key1', 'value1'], ['key2', 'value2']]);
const values = await AsyncStorage.multiGet(['key1', 'key2']);

// Toutes les clés
const allKeys = await AsyncStorage.getAllKeys();

// Tout effacer
await AsyncStorage.clear();

Hook useStorage

function useStorage<T>(key: string, initialValue: T) {
  const [value, setValue] = useState<T>(initialValue);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    AsyncStorage.getItem(key).then((stored) => {
      if (stored) setValue(JSON.parse(stored));
      setLoading(false);
    });
  }, [key]);

  const setStoredValue = async (newValue: T) => {
    setValue(newValue);
    await AsyncStorage.setItem(key, JSON.stringify(newValue));
  };

  return [value, setStoredValue, loading] as const;
}

// Utilisation
const [settings, setSettings, loading] = useStorage('settings', { theme: 'dark' });
Code de cette leçon : App.tsx
import React, { useState, useEffect } from 'react';
import { View, Text, Pressable, StyleSheet } from 'react-native';
import AsyncStorage from '@react-native-async-storage/async-storage';

// Hook pour le stockage persistant des données dans AsyncStorage
function useStorage<T>(key: string, initialValue: T) {
  const [value, setValue] = useState<T>(initialValue);
  const [loading, setLoading] = useState(true);

  useEffect(() => {
    // TODO : lire la valeur enregistrée via AsyncStorage.getItem(key)
    // TODO : si elle existe, l'appliquer via setValue(JSON.parse(stored))
    // TODO : enfin, appeler setLoading(false)

  }, [key]);

  const setStoredValue = async (newValue: T) => {
    setValue(newValue);
    // TODO : enregistrer la nouvelle valeur via AsyncStorage.setItem(key, JSON.stringify(newValue))

  };

  return [value, setStoredValue, loading] as const;
}

export default function App() {
  const [settings, setSettings] = useStorage('settings', { theme: 'dark' });

  return (
    <View style={styles.container}>
      <Text style={styles.text}>Thème : {settings.theme}</Text>
      <Pressable
        style={styles.button}
        onPress={() => setSettings({ theme: settings.theme === 'dark' ? 'light' : 'dark' })}
      >
        <Text style={styles.buttonText}>Changer de thème</Text>
      </Pressable>
    </View>
  );
}

const styles = StyleSheet.create({
  container: {
    flex: 1,
    justifyContent: 'center',
    alignItems: 'center',
    backgroundColor: '#1a5276',
  },
  text: {
    fontSize: 20,
    color: '#fff',
    marginBottom: 16,
  },
  button: {
    paddingVertical: 12,
    paddingHorizontal: 24,
    borderRadius: 8,
    backgroundColor: '#2980b9',
  },
  buttonText: {
    color: '#fff',
    fontSize: 16,
    fontWeight: '600',
  },
});

Entrées de la documentation utilisées dans cette leçon

Tu as repéré une erreur dans cette leçon ?

Teste tes connaissances

Réponds aux questions de cette leçon. Choisis une réponse pour voir tout de suite si elle est correcte.

  1. 1. Comment installer AsyncStorage ?

  2. 2. Comment sauvegarder une valeur dans AsyncStorage ?

Voici 2 des 7 questions de cette leçon. Réponds aux autres dans le jeu.

Tâches pratiques dans le jeu

  • Tri horizontal

    Ordonne la lecture d'une valeur :

  • Clique dans l'ordre

    Clique sur les éléments de multiSet :

  • Éditeur de code

    Complète le code du custom hook useStorage.

  1. QuestionInstaller AsyncStorage
  2. QuestionsetItem
  3. Remets dans l'ordregetItem
  4. QuestionJSON.stringify
  5. QuestionJSON.parse
  6. QuestionremoveItem
  7. Clique dans l'ordremultiSet
  8. QuestiongetAllKeys
  9. Questionclear
  10. Exercice de codeHook useStorage

Articles utiles