客户端存储（Cookie、Storage、IndexedDB）
最后更新于：2022-04-01 23:54:11
## 离线应用与客户端存储
Web应用允许使用浏览器提供的API实现将数据存储到用户的电脑上。
**1、cookie**
cookie是指Web浏览器存储的少量数据，每个Cookie的大小一般不能超过4KB。
Cookie保存以下几方面的信息。
- Cookie的名字
- Cookie的值
- 到期时间
- 所属域名（默认是当前域名）
- 生效的路径（默认是当前网址）
我们可以通过特殊的格式的字符串形式来读写Document对象的cookie属性。
```
document.cookie //读取当前页面的所有cookie
```
我们可以通过检查navigator.cookieEnabled属性来检测当前cookie是否启用。若值为true，表示cookie是启用的。
**1.1 cookie属性：有效期和作用域**
cookie默认的有效期很短暂，它只能持续在Web浏览器的会话期间，一旦用户关闭浏览器，cookie保存的数据就会丢失。
注意：cookie的有效期和sessionStorage的有效期是有区别的：cookie的作用域并不是局限在浏览器的单个窗口中，它的有效期和整个浏览器进程而不是单个浏览器窗口的有效期一致。
cookie的作用域是通过文档源和文档路径来确定的。
**1.2 保存cookie**
document.cookie属性是可写的，可以通过它为当前网站添加Cookie。
```
document.cookie = 'user=TG';
```
Cookie的值必须写成key=value的形式。注意，等号两边不能有空格。另外，写入Cookie的时候，必须对分号、逗号和空格进行转义（它们都不允许作为Cookie的值），这可以用encodeURIComponent方法进行编码，读取时再采用decodeURIComponent方法解码。
但是，document.cookie一次只能写入一个Cookie，而且写入并不是覆盖，而是添加。
```
document.cookie = 'test1=hello';
document.cookie = 'test2=world';
document.cookie
// test1=hello; test2=world
```
如果要延长cookie的有效期，就需要设置mav-age属性来指定cookie的有效期（单位是秒）
```
document.cookie = 'user=TG;max-age=60*60*24'; //将有效期设置为一天
```
**1.3 读取cookie**
使用JavaScript表达式来读取cookie属性时，其返回的值是一个字符串，该字符串都是由一系列名/值对组成，不同名/值对之间通过“分号和空格”分开，其内容包含了所有作用在当前文档的cookie。
一般情况下，我们会采用split()方法将cookie值中的名/值对都分离出来。当然，如果之前进行了一系列的编码，就需要先解码再分离。
```
function getCookie(cname)
{
var name = cname + "=";
var ca = document.cookie.split(';');
for(var i=0; i`元素，它们包含的文档是同源的，两者之间的sessionStorage是可共享的。
**2.2 存储API**
我们可以将`localStorage`和`sessionStorage`当做普通的JavaScript对象：通过设置属性来存储字符串值，查询该属性来读取该值。
```
localStorage.user = 'TG';
```
当然，这两个对象也提供了对应的存储（`setItem()`）和读取（`getItem()`）的方法。
```
localStorage.setItem('user','TG'); //存储一个以“user”的名字存储的数值。
localStorage.getItem('user'); //读取
```
同样，`sessionStorage`也有这两个方法。
```
sessionStorage.setItem('user','TG');
sessiontStorage.getItem('user');
```
还可以使用`removeItem()`和`clear()`方法来删除。
```
localStorage.removeItem('user'); //删除名为“user”的数据。
localStorage.clear(); //删除所有存储的数据
sessionStorage.removeItem('user');
sessionStorage.clear();
```
遍历存储数据。
```
for(var i=0; i < localStorage.length; i++){
var name = localStorage.key(i); //获取第i对的名字
console.log(localStorage.getItem(name); //获取该对的值
}
```
其中的`key`方法，根据位置（从0开始）获得键值。
```
localStorage.key(1);
```
**2.3 storage事件**
当储存的数据发生变化时，会触发storage事件。我们可以指定这个事件的回调函数。
```
window.addEventListener("storage",onStorageChange);
```
回调函数接受一个event对象作为参数。这个event对象的key属性，保存发生变化的键名。
```
function onStorageChange(e) {
console.log(e.key);
}
```
除了key属性，event对象的属性还有三个：
- oldValue：更新前的值。如果该键为新增加，则这个属性为null。
- newValue：更新后的值。如果该键被删除，则这个属性为null。
- url：原始触发storage事件的那个网页的网址。
值得特别注意的是，该事件不在导致数据变化的当前页面触发。如果浏览器同时打开一个域名下面的多个页面，当其中的一个页面改变sessionStorage或localStorage的数据时，其他所有页面的storage事件会被触发，而原始页面并不触发storage事件。可以通过这种机制，实现多个窗口之间的通信。所有浏览器之中，只有IE浏览器除外，它会在所有页面触发storage事件。
**3、客户端数据库（IndexedDB）**
IndexedDB（对象数据库）可以说是浏览器端数据库，可以被网页脚本程序创建和操作。它允许储存大量数据，提供查找接口，还能建立索引。
在IndexedDB API中，一个数据库就是一个命名对象仓库（object store）的集合，对象存储区存储的是对象。
IndexedDB特点：
- 键值对存储：在对象仓库中，数据以“键值对”的形式保存，每一个数据都有对应的键名，键名是独一无二的，不能有重复，否则会抛出一个错误。
- 同域限制：IndexedDB数据库的作用域是限制在包含它们的文档源中，每一个数据库对应创建该数据库的域名，两个同源的Web页面互相之间可以访问对方的数据，但非同源的页面就不行。
- 支持事务：IndexedDB支持事务，这就是说对数据库的查询和更新都是包含在一个事务（transaction）中，以此来确保这些操作要么是一起成功，要么是一起失败，并且永远不会让数据库出现更新到一半的情况。
- 异步：IndexedDB的操作不会阻塞浏览器的UI主线程。
- 储存空间大：IE的储存上限是250MB，Chrome和Opera是剩余空间的某个百分比，Firefox则没有上限。
**3.1 检测浏览器是否支持IndexedDB API**
```
if('indexedDB' in window){
//支持
}else{
//不支持
}
```
**3.2 访问数据库**
要异步访问数据库，就要调用 window 对象 indexedDB 属性的 open() 方法
```
var request = indexedDB.open(name[,version])
```
indexedDB.open方法可传输人两个参数：name是数据库名称，必填；version是数据库版本，是一个大于0的正整数（0将报错）。
open方法返回一个 IDBRequest 对象 (IDBOpenDBRequest)，
注意：如果数据库存在，将打开数据库，否则，则会新建该数据库。如果省略第二个参数，则会自动创建版本为1的该数据库。
当打开数据时，有可能触发4种事件：
success：打开成功。
error：打开失败。
upgradeneeded：第一次打开该数据库，或者数据库版本发生变化。
blocked：上一次的数据库连接还未关闭。
第一次打开数据库时，会先触发upgradeneeded事件，然后触发success事件。
```
request.onupgradeneeded = function(e){}
request.onsuccess = function(e){
db = e.target.result;
}
```
回调函数接受一个事件对象event作为参数，它的target.result属性就指向打开的IndexedDB数据库。
**3.3 IndexedDB实例对象的方法**
**3.3.1 createObjectStore()方法**
createObjectStore()方法用于创建存放数据的“对象仓库”（object store）。
```
db.createObjectStore(name[,options]);
```
参数说明：
参数name是对象仓库的名字；options是可选参数，用来设置对象仓库的属性，可配置两个属性：keyPath和autoIncrement，分别表示每条记录的键名和是否使用自动递增的整数作为键名，默认为false。
```
db.createObjectStore('db1', {keyPath: 'user'});
db.createObjectStore('db2', {autoIncrement: true});
```
由于对象仓库的名字具有唯一性（当创建已存在的数据库时，会报错），所以在创建对象仓库时，我们有必要检测对象仓库是否已存在：
db.objectStoreNames.contains(name)
objectStoreNames属性返回一个DOMStringList对象，里面包含了当前数据库所有“对象仓库”的名称。可以使用DOMStringList对象的contains方法，检查数据库是否包含某个“对象仓库”。
**3.3.2 transaction方法**
创建了数据库，当然要使用它，不过数据库的更新、读取和删除是建立在事务的基础上的，所以我们首先要创建一个事务：
```
var t = db.transaction(array,type)
```
transcation()方法接受两个参数：参数array是一个数组，包含了所要使用的对象仓库，通常是一个；参数type是一个表示操作类型的字符串，目前只有两种类型：readonly（只读）和readwrite（读写）。
```
t = db.transaction(['db1','readwrite');
```
transaction()方法返回一个事务对象，该对象的objectStore()方法用于获取指定的对象仓库：
```
var store = t.objectStore('db1');
```
事务对象有三个监听事件：
abort：事务中断。
complete：事务完成。
error：事务出错。
假如事务完成时：
```
t.oncomplete =function(e){}
```
**3.3.3 数据操作**
下面的方法都是在事件对象上。
**（1）add()方法**
add()方法用来添加数据
```
var add = store.add(data,key)
```
参数说明：参数data是所要添加的数据；参数key是这条数据对应的键名（key）。
add()方法是异步的，有success和error事件：
```
add.onsuccess = funciton(e){}
add.onerror = function(e){}
```
**（2）get()方法**
get()方法用来读取数据，它的参数是键名
```
store.get(key)
```
get方法也是异步的，也有success和error事件。
**（3）put()方法**
put()方法用来更新数据，与add()方法类似：
```
var update = store.put(data,key)
```
**（4）delete()方法**
delete()方法用来删除数据，它的参数是键名：
```
var delete = store.delete(key)
```
delete方法也是异步的，也有success和error事件。
**（5）openCursor()方法**
openCursor()方法用来遍历数据：
```
var cursor = store.openCursor()
```
openCursor方法也是异步的，也有success和error事件。
```
cursor.onsuccess = function(e){
var res = e.target.result;
console.log('key',res.key);
console.log('data',res.value);
res.continue()
}
```
e.target.result属性指向当前数据对象。当前数据对象的key和value分别返回键名和键值（即实际存入的数据）。continue方法将光标移到下一个数据对象，如果当前数据对象已经是最后一个数据了，则光标指向null。
openCursor方法还可以接受第二个参数，表示遍历方向，默认值为next，其他可能的值为prev、nextunique和prevunique。后两个值表示如果遇到重复值，会自动跳过。
**3.3.4 createIndex()方法**
createIndex()方法用来创建索引：
```
createIndex(index,name,options)
```
createIndex方法接受三个参数，第一个是索引名称，第二个是建立索引的属性名，第三个是参数对象，用来设置索引特性。unique表示索引所在的属性是否有唯一值.
**3.3.5 index方法**
index()方法用于从对象仓库返回指定的索引。
```
var index = store.index(index);
var data = index.get(name)
```
注意：get方法有可能取回多个数据对象，因为name属性没有唯一值。
**4、同源策略**
浏览器的同源政策规定，两个网址只要域名相同和端口相同，就可以共享Cookie。
注意：这里不要求协议相同。也就是说，`http://example.com设置的Cookie，可以被https://example.com读取`。
';