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.