介绍 localStorage(本地存储)的使用方式。包括对存储对象的添加、修改、删除、事件触发等操作。
目录
1. 介绍
1.1 说明
1.2 特点
1.3 浏览器最小版本支持
1.4 适合场景
2. 成员
2.1 属性
2.2 方法
2.3 事件
3. 示例
3.1 存储数据
3.2 读取数据
3.3 存储Json对象
1. 介绍
1.1 说明
localStorage 即本地存储,可用于长久保存整个网站的数据,保存的数据没有过期时间,直到手动去除。
在JavaScript语言中可通过 window.localStorage 或 localStorage 调用此对象。
1.2 特点
1) 同源策略限制。若想在不同页面之间对同一个localStorage进行操作,这些页面必须在同一协议、同一主机名和同一端口下。(IE8和9存储数据仅基于同一主机名,忽略协议(HTTP和HTTPS)和端口号的要求)
2) 只在本地存储。localStorage的数据不会跟随HTTP请求一起发送到服务器,只会在本地生效。
3) 永久保存。保存的数据没有过期时间,直到手动去除。
4) 存储方式。localStorage的存储方式采用key、value的方式。value的值必须为字符串类型(传入非字符串,也会在存储时转换为字符串。true值会转换为"true")。
5) 存储上限限制:不同的浏览器存储的上限也不一样,但大多数浏览器把上限限制在5MB以下。
可访问 http://dev-test.nemikor.com/web-storage/support-test/ 测试浏览器的存储上限。
6) 同浏览器共享。localStorage的数据可以在同一个浏览器的不同标签页的同源页面之间共享。
1.3 浏览器最小版本支持
支持localStorage浏览器的最小版本:IE8、Chrome 5。
1.4 适用场景
localStorage 比较适用2个地方:
1) 数据比较大的临时保存方案。如在线编辑文章时的自动保存。
2) 多页面访问共同数据。sessionStorage只适用于同一个标签页,localStorage相比而言可以在多个标签页*享数据。
2. 成员
2.1 属性
readonly int localStorage.length :返回一个整数,表示存储在 localStorage 对象中的数据项(键值对)数量。
2.2 方法
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 对象所有的项。
2.3 事件
storage :当对 localStorage 进行更改时,触发此事件。
在IE 11和Chrome中对此事件有不同的触发机制:
1) 当前页面是否触发:当前页面进行localStorage 操作时,IE 11是当前页面也触发此事件,Chrome 是当前页面不触发此事件。
2) 对localStorage进行重复操作:如存入重复的数据,IE 11是触发此事件,Chrome 是不触发此事件。
3. 示例
3.1 存储数据
3.1.1 采用setItem()方法存储
localStorage.setItem('testKey','这是一个测试的value值'); // 存入一个值
3.1.2 通过属性方式存储
localStorage['testKey'] = '这是一个测试的value值';
3.2 获取数据
3.2.1 通过getItem()方法取值
localStorage.getItem('testKey'); // => 返回testKey对应的值
3.2.2 通过属性方式取值
localStorage['testKey']; // => 这是一个测试的value值
3.3 存储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