html api

localstorage 在浏览器的 api 有两个:localstorage 和sessionstorage,存在于 window 对象中:localstorage 对应 window.localstorage,sessionstorage 对应 window.sessionstorage。

localstorage 和 sessionstorage 的区别主要是在于其生存期。


基本使用方法

  • 这里的作用域指的是:如何{how}隔离开{lí kāi}不同页面之间的localstorage(总不能在百度{ dù}的页面上能读到腾讯的localstorage吧,哈哈哈)。

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

  • sessionstoragelocalstorage更严苛一点,除了协议、主机名、端口外,还要求在同一窗口(也就是浏览器的标签页)下。


生存期

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


数据结构

localstorage为标准的键值对(key-value,简称kv)数据类型,简单但也易扩展,只要以某种编码方式把想要存储进localstorage的对象给转化成字符串,就能轻松支持{zhī chí}。举点例子:把对象转换成json字符串,就能让存储对象了;把图片转换成dataurl(base64),就可以{can}存储图片了。另外对于键值对数据类型来说,"键是唯一{sole}的"这个特性也是相当重要的,重复以同一个键来赋值的话,会覆盖上次的值。


过期时间

很遗憾,localstorage原生是不支持{zhī chí}设置过期时间的,想要设置的话,就只能自己{zì jǐ}来封装一层逻辑来实现:

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)//如果当前时间-减去存储的元素在创建时候{shí hou}设置的时间 > 过期时间{console.log("expires");//提示{tips}过期}else{console.log("val="+dataobj.val);}}
对呀,他怎么就忘了那几个天天欺负他的哥哥了呢?。
随即,她又摇摇头笑自己{zì jǐ}傻,若是他跳楼会死,又怎么担当的起未来的阎王的重任。
“啊――”水菁菁惊叫一声,忙搂住了他的脖子。
阳光穿透他的轻灵,细细碎碎,温温和和,带着幸福的感{sense}觉……在以后清晨睁眼的第一瞬间,洒满心头的每一个角落……。

容量限制

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

域名限制

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

异常处理

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

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

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


浏览器兼容性

featurechromefirefoxinternet exploreroperasafariandroidopera mobilesafari mobile
localstorage43.5810.5042.111ios 3.2
sessionstorage52810.5042.111ios 3.2

如何调试

在chrome开发{developing}者工具里的resources - local storage面板以及resources - session storage面板里,可以看到当前域名下的localstorage数据。


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

另外,在iphone/ipad上有时设置setitem()时会出现诡异的quota_exceeded_err错误,这时一般在setitem之前,先removeitem()就ok了。


相关插件推荐

参考文章

原文链接:https://segmentfault.com/a/1190000004121465