概述
Storage
接口用于脚本在浏览器中保存数据,两个对象部署了这个接口:window.sessionStroge
和window.localStorage
sessionStorage
保存的数据用于浏览器的一次会话。当会话结束(通常是窗口关闭),数据被清空;localStorage
保存的数据长期存在,下一次访问改网址 的时候,网页可以直接读取以前保存的数据,除了保存期限 的长短不同,这两个对象的其他方面都一致
保存的数据都以“键值对”的形式存在,每一项都有一个键名和对应的值,所有的数据都是以文本格式保存。这个接口很像 Cookie 的强化版,能够使用大得多的存储空间。目前,每个域名的存储上限视浏览器而定,Chrome 是 2.5MB,Firefox 和 Opera 是 5MB,IE 是 10MB。另外,与 Cookie 一样,它们也受同域限制。某个网页存入的数据,只有同域下的网页才能读取,如果跨域操作会报错。
属性和方法
Storage
接口只有一个属性storage.length
:返回保存数据项个数
1 | window.localStorage.setItem('foo':'a') |
该接口提供了5个方法
Storage.setItem()
Storgae.setItem()方法用于存入数据,它接受两个参数,第一个是键名,第二个是保存的数据,如果键名已存在,该方法会更新已有的键值,该方法没有返回值1
2window.sesstionStorage.setItem('key','value')
window.localStorage.setItem('key', 'value');注意 storage.setItem() 两个参数都是字符串 如果不是字符串会自动转换成字符串再存入
1
2window.sesstionStorage.setItem(3,{foo:1})
window.sesstionStorgae.getItem('3) //[object,object]上面代码中,setItem方法的两个参数都不是字符串,但是存入的值都是字符串。
如果储存空间已满,该方法会抛错。写入不一定要用这个方法,直接赋值也是可以的。
1
2
3window.localStorage.foo = '123'
window.localStorage['foo'] = '123'
window.localStorge.setItem('foo','123')Storage.getItem()
Storage.getItem()
方法用于读取数据。它只有一个参数,就是键名。如果键名不存在,该方法返回null。1
2window.sessionStorage.getItem('key')
window.localStorage.getItem('key')Storage.removeItem()
Storage.removeItem() 用于清除某个键名对应的键值,接受键名作为参数,如果键名不存在该方法不做任何事情1
2sessionStorage.removeItem('key)
localStorage.removeItem('key')Storage.key()
Storage.key()接受一个整数作为参数(从零开始),返回该位置对应的键值。1
2window.sessionStorage.setItem('key', 'value');
window.sessionStorage.key(0) // "key"Storage.clear()
storgae.clear()方法用于清除所有保存的数据,该方法的返回值是undefined结合使用storage.length 属性和storage.key()方法 可以遍历所有的键
1
2
3
4
5
6
7
8
9
10for (var i= 0;i<window.localStorage.length;i++){
console.log(localStorage.key(i))
}
```
# storage事件
`Storage`接口储存的数据发生变化时,会触发`storage`事件,可以指定这个事件的监听函数。
```javascript
window.addEventListener('storage',onStorangeChange)监听函数接受一个event 实例对象作为参数,这个实例继承了StorageEventt接口,有几个特有 的属性
storageEvent.key
:字符串 表示发生变动的键名 如果Storage事件 是由 clear()方法引起,该属性返回nullstorageEvent.newValue
: 表示新的键值,如果storage事件是由clear( )方法或删除改建值引发。返回nullStorageEvent.oldValue
:字符串,表示旧的键值。如果该键值对是新增的,该属性返回null。StorageEvent.storageArea
:对象,返回键值对所在的整个对象。也说是说,可以从这个属性上面拿到当前域名储存的所有键值对。StorageEvent.url
:字符串,表示原始触发storage
事件的那个网页的网址。
下面是StorageEvent.key属性的例子。
1 | function onStorageChange(e){ |
注意,该事件有一个很特别的地方,就是它不在导致数据变化的当前页面触发,而是在同一个域名的其他窗口触发。也就是说,如果浏览器只打开一个窗口,可能观察不到这个事件。比如同时打开多个窗口,当其中的一个窗口导致储存的数据发生改变时,只有在其他窗口才能观察到监听函数的执行。可以通过这种机制,实现多个窗口之间的通信。