[ Web Proxy ]
URL:
Viewing: https://developer.mozilla.org/fr/docs/Web/API/Window/sessionStorage [Back]  [Original]

Window.sessionStorage - Les API Web | MDN

Cette page a t traduite partir de l'anglais par la communaut. Vous pouvez contribuer en rejoignant la communaut francophone sur MDN Web Docs.

View in English Always switch to English

Window.sessionStorage

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 juillet 2015.

La proprit sessionStorage permet d'utiliser un objet Storage valable pour la session de navigation en cours et pour les pages du mme domaine que la page actuelle. L'objet global sessionStorage est similaire Window.localStorage, la diffrence que les donnes enregistres dans sessionStorage ont une dure vie limite et expirent la fin de la session de navigation actuelle. Une session de navigation dure aussi longtemps que le navigateur est ouvert et s'tend sur plusieurs chargements, rechargements et restaurations de pages. En revanche, une session de navigation n'est valable que pour le contexte de navigation actuel, c'est--dire que le fait d'ouvrir une page dans un nouvel onglet ou dans une nouvelle fentre provoquera l'initialisation d'une nouvelle session de navigation, ce qui diffre du comportement des sessions utilisant des cookies.

Il est noter que les donnes stockes dans sessionStorage ou localStorage sont spcifiques au protocole de la page.

Dans cet article

Syntaxe

js
// Enregistrer des donnes dans sessionStorage
sessionStorage.setItem("cl", "valeur");

// Rcuprer des donnes depuis sessionStorage
var data = sessionStorage.getItem("cl");

// Supprimer des donnes de sessionStorage
sessionStorage.removeItem("cl");

// Supprimer toutes les donnes de sessionStorage
sessionStorage.clear();

Valeur

Un objet Storage.

Exemple

L'exemple de code suivant accde l'objet de stockage de session associ au domaine actuel et y ajoute une donne l'aide de Storage.setItem().

js
sessionStorage.setItem("myCat", "Tom");

L'exemple suivant sauvegarde automatiquement le contenu d'un champ textuel. Si la page est accidentellement rafrachie, le contenu du champ est restaur de sorte qu'aucune saisie n'est perdue.

js
// Rcupration du champ  enregistrer
var champ = document.getElementById("champ");

// Vrification de l'existence d'une donne enregistre auparavant
// (ce ne sera le cas que si la page a t rafrachie)
if (sessionStorage.getItem("autosave")) {
  // Restauration du contenu du champ
  champ.value = sessionStorage.getItem("autosave");
}

// coute des changements de valeur du champ
champ.addEventListener("change", function () {
  // Enregistrement de la saisie utilisateur dans le stockage de session
  sessionStorage.setItem("autosave", champ.value);
});

Note : Veuillez vous rfrer l'article Utilisation de l'API Web Storage pour des exemples plus complets.

Spcifications

Spcification
HTML
# dom-sessionstorage-dev

Compatibilit des navigateurs

Voir aussi


Web Proxy Viewer  |  New URL  |  Original Page