localStorage 即本地存储,可用于长久保存整个网站的数据,保存的数据没有过期时间,直到手动去除。
在JavaScript语言中可通过 window.localStorage 或 localStorage 调用此对象。
特点
1) 同源策略限制。若想在不同页面之间对同一个localStorage进行操作,这些页面必须在同一协议、同一主机名和同一端口下。(IE8和9存储数据仅基于同一主机名,忽略协议(HTTP和HTTPS)和端口号的要求)
2) 只在本地存储。localStorage的数据不会跟随HTTP请求一起发送到服务器,只会在本地生效。
3) 永久保存。保存的数据没有过期时间,直到手动去除。
4) 存储方式。localStorage的存储方式采用key、value的方式。value的值必须为字符串类型(传入非字符串,也会在存储时转换为字符串。true值会转换为"true")。
5) 存储上限限制:不同的浏览器存储的上限也不一样,但大多数浏览器把上限限制在5MB以下。
6) 同浏览器共享。localStorage的数据可以在同一个浏览器的不同标签页的同源页面之间共享。
浏览器最小版本支持
支持localStorage浏览器的最小版本:IE8、Chrome 5。
适用场景
localStorage 比较适用2个地方:
1) 数据比较大的临时保存方案。如在线编辑文章时的自动保存。
2) 多页面访问共同数据。sessionStorage只适用于同一个标签页,localStorage相比而言可以在多个标签页中共享数据。
属性
readonly int localStorage.length :返回一个整数,表示存储在 localStorage 对象中的数据项(键值对)数量。
方法
string localStorage.key(int index) :返回当前 localStorage 对象的第index序号的key名称。若没有返回null。
string localStorage.getItem(string key) :返回键名(key)对应的值(value)。若没有返回null。
void localStorage.setItem(string key, string value) :该方法接受一个键名(key)和值(value)作为参数,将键值对添加到存储中;如果键名存在,则更新其对应的值。
void localStorage.removeItem(string key) :将指定的键名(key)从 localStorage 对象中移除。
void localStorage.clear() :清除 localStorage 对象所有的项。
事件
storage :当对 localStorage 进行更改时,触发此事件。
在IE 11和Chrome中对此事件有不同的触发机制:
1) 当前页面是否触发:当前页面进行localStorage 操作时,IE 11是当前页面也触发此事件,Chrome 是当前页面不触发此事件。
2) 对localStorage进行重复操作:如存入重复的数据,IE 11是触发此事件,Chrome 是不触发此事件。
存储数据
采用setItem()方法存储
localStorage.setItem('testKey','这是一个测试的value值'); // 存入一个值
通过属性方式存储
localStorage['testKey'] = '这是一个测试的value值';
获取数据
通过getItem()方法取值
localStorage.getItem('testKey'); // => 返回testKey对应的值
通过属性方式取值
localStorage['testKey']; // => 这是一个测试的value值
存储Json对象
localStorage 也可存储Json对象:存储时,通过JSON.stringify()将对象转换为文本格式;读取时,通过JSON.parse()将文本转换回对象。
var userEntity = { name: 'tom', age: 22}; // 存储值:将对象转换为Json字符串localStorage.setItem('user', JSON.stringify(userEntity)); // 取值时:把获取到的Json字符串转换回对象var userJsonStr = localStorage .getItem('user');userEntity = JSON.parse(userJsonStr);console.log(userEntity.name); // => tom
新闻热点
疑难解答