localStorage 和 sessionStorage 学习笔记

月亮也心酸
1,878 阅读5分钟

HTML API

读这篇文章的前景提要

你需要先知道这些是什么,不然你可能要自己百度了

document.getElementById

element.innerHTML

document.write

Storage

EventTarget.addEventListener()

localstorage 在浏览器的 API 有两个：localStorage 和sessionStorage，存在于 window 对象中：localStorage 对应 window.localStorage，sessionStorage 对应 window.sessionStorage。

localStorage 和 sessionStorage 的区别主要是在于其生存期。

基本使用方法

这里的作用域指的是：如何隔离开不同页面之间的localStorage（总不能在百度的页面上能读到腾讯的localStorage吧，哈哈哈）。

localStorage只要在相同的协议、相同的主机名、相同的端口下，就能读取/修改到同一份localStorage数据。

sessionStorage比localStorage更严苛一点，除了协议、主机名、端口外，还要求在同一窗口（也就是浏览器的标签页）下。

比如下图，域名一样，窗口不一样，所以localstorage相同，但是sessionStorage不一样

生存期

localStorage理论上来说是永久有效的，即不主动清空的话就不会消失，即使保存的数据超出了浏览器所规定的大小，也不会把旧数据清空而只会报错。但需要注意的是，在移动设备上的浏览器或各Native App用到的WebView里，localStorage都是不可靠的，可能会因为各种原因（比如说退出App、网络切换、内存不足等原因）被清空。 sessionStorage的生存期顾名思义，类似于session，只要关闭浏览器（也包括浏览器的标签页），就会被清空。由于sessionStorage的生存期太短，因此应用场景很有限，但从另一方面来看，不容易出现异常情况，比较可靠。

数据结构

localstorage为标准的键值对（Key-Value,简称KV）数据类型，简单但也易扩展，只要以某种编码方式把想要存储进localstorage的对象给转化成字符串，就能轻松支持。举点例子：把对象转换成json字符串，就能让存储对象了；把图片转换成DataUrl（base64），就可以存储图片了。另外对于键值对数据类型来说，"键是唯一的"这个特性也是相当重要的，重复以同一个键来赋值的话，会覆盖上次的值。

存储数据的方法就是直接给window.localStorage添加一个属性

例如：window.localStorage.a 或者 window.localStorage["a"]。它的读取、写、删除操作方法很简单，是以键值对的方式存在的，如下：

localStorage.a = 3;//设置a为"3"
localStorage["a"] = "sfsf";//设置a为"sfsf"，覆盖上面的值
localStorage.setItem("b","isaac");//设置b为"isaac"
var a1 = localStorage["a"];//获取a的值
var a2 = localStorage.a;//获取a的值
var b = localStorage.getItem("b");//获取b的值
localStorage.removeItem("c");//清除c的值

这里最推荐使用的自然是getItem()和setItem()

清除键值对使用removeItem()。如果希望一次性清除所有的键值对，可以使用clear()。另外，HTML5还提供了一个key()方法，可以在不知道有哪些键值的时候使用，如下：

<html>
<head>
    <meta charset="UTF-8">
    <title><code>document.write()</code> example</title>
    <script>
var storage = window.localStorage;
function showStorage(){
 for(var i=0;i<storage.length;i++){
  //key(i)获得相应的键，再用getItem()方法获得对应的值
  document.write(storage.key(i)+ " : " + storage.getItem(storage.key(i)) + "<br>");
 }
}
    </script>
</head>
<body onload="showStorage();">
    <p>Some original document content.</p>
</body>
</html>

键名和值：

对键值对的改变进行监听

HTML5的本地存储，还提供了一个storage事件

<html>

<head>
    <meta charset="UTF-8">
    <title><code>document.write()</code> example</title>

    <script>
//对于 Internet Explorer 来说，在IE9之前，你必须使用 attachEvent 而不是使用标准方法 addEventListener
//为了支持IE，所以提供了使用attachEvent，使用 attachEvent 方法有个缺点，this 的值会变成 window 对象的引用而不是触发事件的元素。
if(window.addEventListener){
  //触发storage(存储)改变事件，在window对象里执行handle_storage（）
 window.addEventListener("storage",handle_storage,false);
 alert('监听器可注册到window对象上')
}else if(window.attachEvent){
 window.attachEvent("onstorage",handle_storage);
 alert('你这个应该是IE9之前的浏览器，不过没关系用attachEvent就行啦！')
}
function handle_storage(e){
 if(!e){
   e=window.event;
   }
 //showStorage();
}
    </script>
</html>

过期时间

很遗憾，localstorage原生是不支持设置过期时间的，想要设置的话，就只能自己来封装一层逻辑来实现：

function set(key,value){
  var curtime = new Date().getTime();//获取当前时间
  localStorage.setItem(key,JSON.stringify({val:value,time:curtime}));//转换成json字符串序列
}
function get(key,exp)//exp是设置的过期时间
{
  var val = localStorage.getItem(key);//获取存储的元素
  var dataobj = JSON.parse(val);//解析出json对象
  if(new Date().getTime() - dataobj.time > exp)//如果当前时间-减去存储的元素在创建时候设置的时间 > 过期时间
  {
    console.log("expires");//提示过期
  }
  else{
    console.log("val="+dataobj.val);
  }
}

容量限制

目前业界基本上统一为5M，已经比cookies的4K要大很多了，省着点用吧骚年。

域名限制

由于浏览器的安全策略，localstorage是无法跨域的，也无法让子域名继承父域名的localstorage数据，这点跟cookies的差别还是蛮大的。

异常处理

localstorage在目前的浏览器环境来说，还不是完全稳定的，可能会出现各种各样的bug，一定要考虑好异常处理。我个人认为localstorage只是资源本地化的一种优化手段，不能因为使用localstorage就降低了程序的可用性，那种只是在console里输出点错误信息的异常处理我是绝对反对的。localstorage的异常处理一般用try/catch来捕获/处理异常。

如何测试用户当前浏览器是否支持localstorage

目前普遍的做法是检测window.localStorage是否存在，但某些浏览器存在bug，虽然"支持"localstorage，但在实际过程中甚至可能出现无法setItem()这样的低级bug。因此我建议，可以通过在try/catch结构里set/get一个测试数据有无出现异常来判断该浏览器是否支持localstorage，当然测试完后记得删掉测试数据哦。

浏览器兼容性

Feature Chrome Firefox Internet Explorer Opera Safari Android Opera Mobile Safari Mobile

localStorage	4	3.5	8	10.50	4	2.1	11	iOS 3.2
sessionStorage	5	2	8	10.50	4	2.1	11	iOS 3.2

如何调试

在chrome开发者工具里的Resources - Local Storage面板以及Resources - Session Storage面板里，可以看到当前域名下的localstorage数据。

在ios设备上无法重复setItem()

另外，在iPhone/iPad上有时设置setItem()时会出现诡异的QUOTA_EXCEEDED_ERR错误，这时一般在setItem之前，先removeItem()就ok了。

应用

1.简单的定时器

  • 给localstorage添加属性
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>Document</title>
</head>
<body>
  <div>
    每刷新一次＋1
    <p id="count"></p>
  </div>
  <script>
    var storage = window.localStorage;
      if (!storage.getItem("pageLoadCount")) storage.setItem("pageLoadCount",0);
      storage.pageLoadCount = parseInt(storage.getItem("pageLoadCount")) + 1;//必须格式转换
      document.getElementById("count").innerHTML = storage.pageLoadCount;
      //showStorage();
  </script>
</body>
</html>

每次刷新，就算是在不同页面，或者重新打开一个页面刷新，都会＋1，满足前面说的生存周期：不主动清空的话就不会消失

2.一个无聊的操作

或许让你更深入理解巩固一下？这里添加两个键值对a和b，并增加一个按钮。给a设置固定的值，当点击按钮时，修改b的值：

<body>
<p>You have viewed this page <span id="count">0</span>  time(s).</p>
<p><input type="button" value="changeStorage" onClick="changeS()"/></p>
<script>
var storage = window.localStorage;
if (!storage.getItem("pageLoadCount")) storage.setItem("pageLoadCount",0);
storage.pageLoadCount = parseInt(storage.getItem("pageLoadCount")) + 1;//必须格式转换
document.getElementByIdx_x("count").innerHTML = storage.pageLoadCount;
showStorage();
if(window.addEventListener){
 window.addEventListener("storage",handle_storage,false);
}else if(window.attachEvent){
 window.attachEvent("onstorage",handle_storage);
}
function handle_storage(e){
 if(!e){e=window.event;}
 showObject(e);
}
function showObject(obj){
 //递归显示object
 if(!obj){return;}
 for(var i in obj){
  if(typeof(obj[i])!="object" || obj[i]==null){
   document.write(i + " : " + obj[i] + "<br/>");
  }else{
   document.write(i + " : object" + "<br/>");
  }
 }
}
storage.setItem("a",5);
function changeS(){
 //修改一个键值，测试storage事件
 if(!storage.getItem("b")){storage.setItem("b",0);}
 storage.setItem('b',parseInt(storage.getItem('b'))+1);
}
function showStorage(){
 //循环显示localStorage里的键值对
 for(var i=0;i<storage.length;i++){
  //key(i)获得相应的键，再用getItem()方法获得对应的值
  document.write(storage.key(i)+ " : " + storage.getItem(storage.key(i)) + "<br>");
 }
}
</script>
</body>

b真的有在变化呐！

注意：

  • localStorage 和 sessionStorage 属性允许在浏览器中存储 key/value 对的数据。
  • localStorage 用于长久保存整个网站的数据，保存的数据没有过期时间，直到手动去删除。
  • localStorage 属性是只读的
  • 提示: 如果你只想将数据保存在当前会话中，可以使用 sessionStorage 属性， 该数据对象临时保存同一窗口(或标签页)的数据，在关闭窗口或标签页之后将会删除这些数据。

参考

www.runoob.com/w3cnote/loc…

www.cnblogs.com/xiaowei0705…

avatar
文章
阅读
粉丝
相关推荐
Cookie、sessionStorage和localStorage的区别详解
1.0k阅读
 · 
1点赞
cookie、localStorage、sessionStorage、IndexedDB 的区别？
198阅读
 · 
2点赞
什么？要给localStorage加上过期时间
8.5k阅读
 · 
92点赞
Vuex、localStorage和sessionStorage
432阅读
 · 
3点赞
详解 localStorage、sessionStorage和cookie区别
227阅读
 · 
3点赞
对不起 localStorage，现在我爱上 localForage了！
76k阅读
 · 
1.0k点赞
关于Cookie、localStroage和sessionStorage的小结
1.2k阅读
 · 
3点赞
浏览器数据存储技术浅析：Cookie、LocalStorage、SessionStorage和IndexedDB
2.4k阅读
 · 
45点赞
🎉Vue3优雅的监听localStorage变化🎉
18k阅读
 · 
207点赞
浏览器缓存 cookie、localStorage、sessionStorage 三者有什么区别？
928阅读
 · 
7点赞

友情链接：