Window : évènement storage

Baseline

Large disponibilité

Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis avril 2017.

Voir la compatibilité complète
En savoir plus

L'évènement storage de l'interface Window se déclenche lorsqu'un autre document qui partage la même zone de stockage (soit localStorage ou sessionStorage) que la fenêtre actuelle met à jour cette zone de stockage. L'évènement n'est pas déclenché sur la fenêtre qui a effectué la modification.

Pour localStorage, l'évènement est déclenché dans tous les autres contextes de navigation qui sont dans la même origine que le document initiateur. Cela inclut les autres onglets avec la même origine.
Pour sessionStorage, l'évènement est déclenché dans tous les autres contextes de navigation qui sont dans la même origine et le même contexte de navigation de premier niveau que le document initiateur. Cela inclut uniquement les iframes intégrées, le cas échéant, dans le même onglet, et non les autres onglets.

L'évènement n'est pas annulable et ne se propage pas.

Syntaxe

Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété de gestionnaire d'évènements.

addEventListener("storage", (event) => { })

onstorage = (event) => { }

window.addEventListener("storage", () => {
  // Lorsque le stockage local change, vider la liste sur
  // la console.
  console.log(JSON.parse(window.localStorage.getItem("listeExemple")));
});

La même action peut être réalisée ) l'aide de la propriété du gestionnaire d'évènements onstorage :

window.onstorage = () => {
  // Lorsque le stockage local change, vider la liste dans
  // la console.
  console.log(JSON.parse(window.localStorage.getItem("listeExemple")));
};