Window 对象 localStorage 属性

实例

使用 name="lastname" 和 value="Smith" 创建一个 localStorage 名称/值对,然后检索 "lastname" 的值并将其插入 id="result" 的元素中:

  1. <!DOCTYPE html>
  2. <html>
  3. <body>
  4. <div id="result"></div>
  5. <script>
  6. // Check browser support
  7. if (typeof(Storage) !== "undefined") {
  8. // Store
  9. localStorage.setItem("lastname", "Smith");
  10. // Retrieve
  11. document.getElementById("result").innerHTML = localStorage.getItem("lastname");
  12. } else {
  13. document.getElementById("result").innerHTML = "对不起,您的浏览器不支持 Web Storage...";
  14. }
  15. </script>
  16. </body>
  17. </html>

定义与用法

localStoragesessionStorage 属性允许在 web 浏览器中保存键/值对。

localStorage 对象存储的数据没有过期日期。关闭浏览器时,数据不会被删除,并将在第二天、第二周或第二年可用。

localStorage 属性是只读的。

提示:另请查看 sessionStorage 属性,该属性存储一个会话的数据(关闭浏览器选项卡时数据丢失)。


浏览器支持

表中的数字指定完全支持该特性的第一个浏览器版本。

属性
localStorage4.08.03.54.011.5

语法

  1. window.localStorage

用于将数据保存到 localStorage 本地存储的语法:

  1. localStorage.setItem("key", "value");

从 localStorage 读取数据的语法:

  1. var lastname = localStorage.getItem("key");

从 localStorage 本地存储中删除数据的语法:

  1. localStorage.removeItem("key");

技术细节

返回值:一个 Storage 对象

更多实例

实例

下面的示例统计用户单击按钮的次数:

  1. <!DOCTYPE html>
  2. <html>
  3. <head>
  4. <script>
  5. function clickCounter() {
  6. if(typeof(Storage) !== "undefined") {
  7. if (localStorage.clickcount) {
  8. localStorage.clickcount = Number(localStorage.clickcount)+1;
  9. } else {
  10. localStorage.clickcount = 1;
  11. }
  12. document.getElementById("result").innerHTML = "您已经点击了 " + localStorage.clickcount + " 次。";
  13. } else {
  14. document.getElementById("result").innerHTML = "对不起,您的浏览器不支持 web storage...";
  15. }
  16. }
  17. </script>
  18. </head>
  19. <body>
  20. <p><button onclick="clickCounter()" type="button">Click me!</button></p>
  21. <div id="result"></div>
  22. <p>单击按钮查看计数器的增加。</p>
  23. <p>关闭浏览器选项卡(或窗口),然后重试,计数器将继续计数(不会重置)。</p>
  24. </body>
  25. </html>

分类导航