Accueil › Vue.js › Stores croisés et persistance
Stores croisés et persistance
Pinia et l'état partagéintermediaire
Un store peut en utiliser un autre. On appelle sa fonction use...()
à l'intérieur d'une action ou d'un getter, jamais au niveau du module.
export const useCommande = defineStore('commande', () => {
function valider() {
const panier = usePanier() // ici, le store est actif
const session = useSession()
if (!session.connecte) return
envoyer(panier.lignes)
panier.vider()
}
return { valider }
})
L'appel au niveau du module s'exécuterait à l'import, avant
app.use(createPinia()). À l'intérieur d'une action, il a lieu quand tout
est en place. Un cycle — A appelle B qui appelle A — fonctionne tant que les
appels sont faits à l'exécution ; il casse si un store lit l'autre pendant sa
propre initialisation.
La persistance se branche sur $subscribe, qui reçoit chaque changement
d'état :
const panier = usePanier()
panier.$subscribe((mutation, etat) => {
localStorage.setItem('panier', JSON.stringify({ lignes: etat.lignes }))
})
On ne persiste jamais tout : les jetons et données sensibles restent hors du stockage, et les données serveur rechargeables n'ont rien à y faire. On persiste une sélection explicite.
À la réhydratation, on fusionne la valeur lue dans l'état par défaut avec
$patch, plutôt que de la remplacer. Un état persisté par une version
précédente ne contient pas les clés ajoutées depuis.
Les termes à connaître
- Store croisé
Un store qui en appelle un autre, en invoquant sa fonction
use...()à l'intérieur d'une action ou d'un getter plutôt qu'au niveau du module.- Cycle de dépendances
Deux stores qui s'appellent mutuellement. Toléré tant que l'appel a lieu à l'exécution, cassant si l'un lit l'autre pendant sa propre initialisation.
- $patch
Une méthode du store qui applique plusieurs changements en une fois. Avec un objet, elle fusionne en surface ; avec une fonction, elle laisse muter librement.
- $subscribe
Un abonnement aux changements de l'état d'un store. Il reçoit la mutation et l'état, et sert notamment à écrire dans un stockage.
- $reset
La remise de l'état à sa valeur initiale. Fournie sur un store d'options, absente d'un store de composition tant qu'on ne l'écrit pas.
- Réhydratation
La lecture d'un état persisté au démarrage, et sa fusion dans l'état par défaut. C'est là que les anciennes données rencontrent le nouveau schéma.
Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.