Window.sessionStorage

Cet article nécessite une relecture technique. Voici comment vous pouvez aider.

Cet article nécessite une relecture rédactionnelle. Voici comment vous pouvez aider.

Cette traduction est incomplète. Aidez à traduire cet article depuis l'anglais.

La propriété sessionStorage vous permet d'accéder à l'objet session Storage. sessionStorage est similaire à Window.localStorage, la seule différence est que les données stockées dans le localStorage n'ont pas  d'expiration défini, les données stockées dans sessionStorage seront éffacées quand la session de la page est finie. Une session est active tant que la page du navigateur est ouverte et survie au rechargement et à la restauration. Ouvrir une page dans un nouvel onglet ou une fenêtre entrainera l'initialisation d'une nouvelle session, qui diffère du comportement du cookie.

Syntaxe

// Save data to sessionStorage
sessionStorage.setItem('key', 'value');

// Get saved data from sessionStorage
var data = sessionStorage.getItem('key');

Valeur

Un objet Storage.

Exemple

Cet exemple de code accède à l'objet session Storage du domaine courant et ajoute la donnée à l'aide de Storage.setItem().

sessionStorage.setItem('myCat', 'Tom');

L'exemple suivant sauvegarde automatiquement le contenu d'un champ texte, et si le navigateur est accidentellement rafraichi, le contenu du champ texte est restoré et ainsi ce qui a été écrit n'est pas perdu.

// Get the text field that we're going to track
var field = document.getElementById("field");
 
// See if we have an autosave value
// (this will only happen if the page is accidentally refreshed)
if (sessionStorage.getItem("autosave")) {
  // Restore the contents of the text field
  field.value = sessionStorage.getItem("autosave");
}
 
// Listen for changes in the text field
field.addEventListener("change", function() {
  // And save the results into the session storage object
  sessionStorage.setItem("autosave", field.value);
});

 

Note: Please refer to the Using the Web Storage API article for a full example.

Specifications

Specification Status Comment
Web Storage (Second edition)
La définition de 'sessionStorage' dans cette spécification.
Recommendation  

Browser compatibility

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari (WebKit)
localStorage 4 3.5 8 10.50 4
sessionStorage 5 2 8 10.50 4
Feature Android Firefox Mobile (Gecko) IE Phone Opera Mobile Safari Mobile
Basic support 2.1 ? 8 11 iOS 3.2

All browsers have varying capacity levels for both localStorage and sessionStorage. Here is a detailed rundown of all the storage capacities for various browsers.

Note: since iOS 5.1, Safari Mobile stores localStorage data in the cache folder, which is subject to occasional clean up, at the behest of the OS, typically if space is short.

See also

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : Weeple
 Dernière mise à jour par : Weeple,