1、 你知道什么是localStorage(不知道,猛击这里进行补课)
2、 你需要一个兼容IE系列的本地存储方案(不考虑低版本IE的请飘过或直接看二次包装)
兼容方案效果:
所有主流浏览器支持以下方法和属性:
window.localStorage 的 getItem/setItem/removeItem/clear/key 方法以及 length属性
window.LS 的 get/set/remove/clear/each 方法
一、引言
Web Storage这个东西真正好(路人甲:一头大来一头小…):量大、永久存储、不用使用任何插件,不随http发送 … 用来保存一些用户非敏感的状态和信息是再合适不过的了。其浏览器兼容性如下:
可以看到,由于除IE外的其他浏览器很早的版本都支持了,关键是我们可以不用考虑这些浏览器的更低版本(路人甲:为啥?答:由于升级策略以及使用人群不同而决定的,详细请咨询百度先生),所以基本上可以认为都已经支持了localStorage,而IE是个特例,虽然IE8就开始支持localStorage应该夸奖,但是其更低版本IE却都不支持,令人气馁的是,这些低版本浏览器在中国的占有率还TMD挺高… (路人甲:Seems like some sort of human rights violation)
所以,我们需要一个兼容方案来处理IE,使得它们也能支持类似本地存储的能力,userData被发现了(路人甲:IE其实很牛逼,很早的版本就通过特有的filter、vml支持CSS3、Canvas等html5的特性了,但是就是因为TMD太超前,又不愿意遵循后生定制的标准,才导致如今混乱的局面)。
二、语法
localStorage语法很简单,而且我们不需要考虑具体的实现机制:
1 window.localStorage.getItem( key ); 2 window.localStorage.setItem( key, value ); 3 window.localStorage.removeItem( key ); 4 window.localStorage.clear(); 5 window.localStorage.length; 6 window.localStorage.key( i );
上述五个方法和一个属性是最常用、也够用的localStorage的接口,也是所有实现得最为统一的接口。更多其他使用方法,请自行百度查找,这里不一一列举。
userData语法略复杂,它需要依赖一个html元素来做代理,该元素需要设定addBehavior('#default#userData'),假设该元素为o,那么如此调用:
1 o.load(dataFile); 2 o.getAttribute(name); 3 o.setAttribute(name, value); 4 o.removeAttribute(name); 5 o.save(dataFile);
更多其他接口请参考官网MSDN资料。
兼容方案的目的是:通过对userData的封装,提供一个模拟localStorage对象,实现相同或者高度相似的接口。
三、现状
userData需要指定一个缓存文件(大小限制128k),然后读取指定节点的内容,但是无法遍历缓存文件或节点。网上的兼容方案有两种:
1、 以文件名作为key,自定义一个节点,来保存value
2、 确定一个文件,以节点名作为key,来保存value
以文件名作为key的,虽然文件个数不受限制,但是同一域名下有总容量的限制(1024k),同时每个文件最小占用4k(多数系统下),实际文件数不会超过256个,虽然基本够用,但是总归不太好,浪费了不必要的空间(路人甲:哪怕存储一个字符,也要创建一个缓存文件,占用4k的空间,对吧?答:正解。)
以节点名作为key的,其灵活性就比较好,一般情况下,单个的key/value都是小量数据,128k的文件上限足够存储数据之用了,所以本文最终采用了以节点名作为key的存储点。
有了以上接口,setItem / getItem / removeItem 就很容易实现了,但是仍有两个问题比较棘手:
1、 原生localStorage可以随时使用,但是网上流传的兼容版本必须等页面加载了document.body后才能使用
2、 原生localStorage支持clear方法,以及通过length属性和key方法来实现遍历,网上流传的兼容版本都没有此功能
四、解决方案
首先,要解决访问时机的问题。
网上流传的代码〔节选〕:
1 UserData.o = document.createElement('INPUT'); 2 UserData.o.type = "hidden"; 3 UserData.o.style.display = "none"; 4 UserData.o.addBehavior ("#default#userData"); 5 document.body.appendChild(UserData.o);
问题出在最后一句,如果document.body不存在,那么这个input也就插入失败,自然就不能继续使用userData,当然,如果你的js放在body标签内,那就可以使用了,但是我喜欢把js放在head内(路人甲:我也喜欢~~)――虽然与google的优化法相左,但是我控制不了自己的洁癖:我觉得放在body内就是污染了body标签,所以我就尝试把input插入到一个已经存在的标签内(哪怕是head),结果居然成功了(路人乙:那你的这个input不也是污染了head标签吗?答:那就不管了,哈哈):
1 var box = document.body || document.getElementsByTagName("head")[0] || document.documentElement, 2 o = document.createElement('input'); 3 o.type = "hidden"; 4 o.addBehavior ("#default#userData"); 5 box.appendChild(o); 6 UserData.o = o;
这样,只要是在组件js下面的任何地方任何时机都可以调用模拟的localStorage组件了,这爽了很多,至少在页面初始化的时候就可以读取一些数据来做一些事情,而不是必须等到页面加载完成才能访问。
解决了第一个访问时机的问题后,那如何实现可遍历的功能呢?
要遍历,我们就必须要知道以往存储的所有的key,既然userData没有接口提供,那只有我们自己来保存这些key了,存在哪儿?自然还是userData本身。之前提到,用户的key/value存储在一个缓存文件中,那么可以将key存在另外一个缓存文件中,当调用clear方法或者key方法的时候,读取这个keyCache列表就能知道已经存了哪些数据。
什么时候更新这个keyCache?当然是 setItem/removeItem 的时候,同理,length属性也是在这两个方法被调用的时候更新的。
怎么更新这个keyCache?当然是跟 setItem 一样的逻辑,只是load的文件不同而已。另外,由于只能存储字符串类型的数据,我们就需要把key拼成一个字符串和进行保存,这里又有两个方法:
1、 保存成json串格式的数组。但是key中不能包括引号(可转义)和逗号;
2、 保存成特定分隔符连成的字符串。但是key中不能包含分隔符字符(串);
既然第一个处理那么复杂(转义引号、json转化序列化),那不如就用逗号来拼接key来得方便。这因为如此,key就了一个限制:不能包含半角逗号(此限制对一般开发人员来说几乎都是透明的,没听说过谁在变量名中包含逗号)。
方法写好了:
1 cacheKey : function( key, action ){ 2 if( !this.init() )return; 3 var o = this.o; 4 //加载keyCache 5 o.load(this.keyCache); 6 var str = o.getAttribute("keys") || "", 7 list = str ? str.split(",") : [], 8 n = list.length, i=0, isExist = false; 9 //将key转化为小写进行查找和存储 10 key = key.toLowerCase(); 11 for(; i<n; i++){ 12 if( list[i] === key ){ 13 isExist = true; 14 if( action === 2 ){ //如果是删除 15 list.splice(i,1); 16 n--; i--; 17 } 18 } 19 } 20 if( action === 1 && !isExist ) //如果是写 21 list.push(key); 22 //存储 23 o.setAttribute("keys", list.join(",")); 24 o.save(this.keyCache); 25 }
至此,userData已经完成了最难的两个功能(至少是网上流传版本没有的),剩下的就是简单的setItem / getItem / removeItem功能了,一个函数就可以搞定了。
这里把源码一并贴出来,并适当进行了一点修改和优化(代码略长,默认给折叠起来了):
五、已知问题
1、userData在存储节点的时候,不区分大小写,而localStorage区分;这个问题暂时想不到什么好的办法解决。
2、模拟localStorage只能清理或遍历通过本组件设定的userData数据,其他方式保存的userData数据无法清理和遍历。
3、模拟localStorage的使用和原生localStorage上仍有有效范围的差异。
六、二次包装
我是一个勤奋的懒人,我会为了以后能够偷懒省事儿,我会进一步优化和改善现有的代码,哪怕功能已经够用了,甚至是完备的。
localStorage太长,那就用LS!
setItem / getItem / removeItem 中的item都是废话(路人甲:是废词。),删掉!
length / key 写循环太麻烦,增加each方法!
部分原生的localStorage有bug,修改!
不同浏览器的getItem返回值有细小差异,统一输出!
经常用jQuery/Core(我们自己前端框架的主对象),扩展一个备份!
于是,就有了下面的这个二次包装:
1 (function(window,localStorage,undefined){ 2 var LS = { 3 set : function(key, value){ 4 //在iPhone/iPad上有时设置setItem()时会出现诡异的QUOTA_EXCEEDED_ERR错误 5 //这时一般在setItem之前,先removeItem()就ok了 6 if( this.get(key) !== null ) 7 this.remove(key); 8 localStorage.setItem(key, value); 9 }, 10 //查询不存在的key时,有的浏览器返回undefined,这里统一返回null 11 get : function(key){ 12 var v = localStorage.getItem(key); 13 return v === undefined ? null : v; 14 }, 15 remove : function(key){ localStorage.removeItem(key); }, 16 clear : function(){ localStorage.clear(); }, 17 each : function(fn){ 18 var n = localStorage.length, i = 0, fn = fn || function(){}, key; 19 for(; i<n; i++){ 20 key = localStorage.key(i); 21 if( fn.call(this, key, this.get(key)) === false ) 22 break; 23 //如果内容被删除,则总长度和索引都同步减少 24 if( localStorage.length < n ){ 25 n --; 26 i --; 27 } 28 } 29 } 30 }, 31 j = window.jQuery, c = window.Core; 32 //扩展到相应的对象上 33 window.LS = window.LS || LS; 34 //扩展到其他主要对象上 35 if(j) j.LS = j.LS || LS; 36 if(c) c.LS = c.LS || LS; 37 })(window,window.localStorage);