前端数据库indexedDB

前言：前端用的，浏览器本地数据库，网上有关他的封装有很多 不想看细节的不用往下看了 

特性：
COOKIE 的大小不超过4KB，且每次请求都会发送回服务器；
LocalStorage 在 2.5MB 到 10MB 之间（各家浏览器不同），而且不提供搜索功能，不能建立自定义的索引。

IndexedDB 浏览器提供的本地数据库
允许储存大量数据，提供查找接口，还能建立索引
不属于关系型数据库（不支持 SQL 查询语句），更接近 NoSQL 数据库

IndexedDB 具有以下特点。
（1）键值对储存。 IndexedDB 内部采用对象仓库（object store）存放数据。所有类型的数据都可以直接存入，包括 Javascript 对象。对象仓库中，数据以"键值对"的形式保存，每一个数据记录都有对应的主键，主键是独一无二的，不能有重复，否则会抛出一个错误。
（2）异步。 IndexedDB 操作时不会锁死浏览器，用户依然可以进行其他操作，这与 LocalStorage 形成对比，后者的操作是同步的。异步设计是为了防止大量数据的读写，拖慢网页的表现。
（3）支持事务。 IndexedDB 支持事务（transaction），这意味着一系列操作步骤之中，只要有一步失败，整个事务就都取消，数据库回滚到事务发生之前的状态，不存在只改写一部分数据的情况。
（4）同源限制 IndexedDB 受到同源限制，每一个数据库对应创建它的域名。网页只能访问自身域名下的数据库，而不能访问跨域的数据库。
（5）储存空间大 IndexedDB 的储存空间比 LocalStorage 大得多，一般来说不少于 250MB，甚至没有上限。
（6）支持二进制储存。 IndexedDB 不仅可以储存字符串，还可以储存二进制数据（ArrayBuffer 对象和 Blob 对象）。

API
数据库：IDBDatabase 对象
对象仓库：IDBObjectStore 对象
索引： IDBIndex 对象
事务： IDBTransaction 对象
操作请求：IDBRequest 对象
指针： IDBCursor 对象
主键集合：IDBKeyRange 对象

数据库是一系列相关数据的容器。每个域名（严格的说，是协议 + 域名 + 端口）都可以新建任意多个数据库。
IndexedDB 数据库有版本的概念。同一个时刻，只能有一个版本的数据库存在。如果要修改数据库结构（新增或删除表、索引或者主键），只能通过升级数据库版本完成。

每个数据库包含若干个对象仓库（object store）。它类似于关系型数据库的表格
对象仓库保存的是数据记录。每条记录类似于关系型数据库的行，但是只有主键和数据体两部分。主键用来建立默认的索引，必须是不同的，否则会报错。主键可以是数据记录里面的一个属性，也可以指定为一个递增的整数编号。

{ id: 1, text: 'foo' }
id属性可以当作主键。
数据体可以是任意数据类型，不限于对象

索引
为了加速数据的检索，可以在对象仓库里面，为不同的属性建立索引。

事务
数据记录的读写和删改，都要通过事务完成。事务对象提供error、abort和complete三个事件，用来监听操作结果。

1.创建数据或打开数据库
#如果指定的数据库不存在，就会新建数据库
var request = window.indexedDB.open(databaseName, version);

这个方法接受两个参数，第一个参数是字符串，表示数据库的名字。如果指定的数据库不存在，就会新建数据库。第二个参数是整数，表示数据库的版本。如果省略，打开已有数据库时，默认为当前版本；新建数据库时，默认为1。
indexedDB.open()方法返回一个 IDBRequest 对象。这个对象通过三种事件error、success、upgradeneeded，处理打开数据库的操作结果。
每个域名（严格的说，是协议 + 域名 + 端口）都可以新建任意多个数据库。
IndexedDB 数据库有版本的概念。同一个时刻，只能有一个版本的数据库存在。如果要修改数据库结构（新增或删除表、索引或者主键），只能通过升级数据库版本完成。

let request = window.indexedDB.open('test', 1);

let db;
request.Onsuccess= function (event) {
db = request.result;
console.log('数据库打开成功',event);
console.log(db)
};

error 事件
打开数据库失败的事件

request.Onerror= function (event) {
console.log('数据库打开报错');
};

success 事件
打开数据成功的事件
var db;
request.Onsuccess= function (event) {
db = request.result;
console.log('数据库打开成功');
};

upgradeneeded 事件(数据库升级) 注意：版本升级后必须要有对应的数据表发生变化比如创建新表，其次版本号只能是增加，旧版本号数据库将无法使用

指定的版本号，大于数据库的实际版本号，就会发生数据库升级事件
这时通过事件对象的target.result属性，拿到数据库实例。
var db;
request.Onupgradeneeded= function (event) {
db = event.target.result;
}

#之前已经存在1的版本 | 因为这时版本从无到有，所以会触发这个事件
let request = window.indexedDB.open('test', 2);
let db;
request.Onsuccess= function (event) {
db = request.result;
console.log('数据库打开成功',event);
console.log(db)
};

request.Onupgradeneeded= function(event) {
console.log('数据库升级了',event); #数据库新建成功以后，新增一张叫做person的表格，主键是id。
db = event.target.result;
var objectStore = db.createObjectStore('person', { keyPath: 'id' });
console.log(objectStore)
}

更好的写法是先判断一下，这张表格是否存在，如果不存在再新建。
request.Onupgradeneeded= function (event) {
db = event.target.result;
var objectStore;
if (!db.objectStoreNames.contains('person')) {
objectStore = db.createObjectStore('person', { keyPath: 'id' });
}
}

db.objectStoreNames表集合
建表 新增一张叫做person的表格，主键是id。

var objectStore = db.createObjectStore('person', { keyPath: 'id' });

更好的写法是先判断一下，这张表格是否存在，如果不存在再新建。
request.Onupgradeneeded= function (event) {
db = event.target.result;
var objectStore;
if (!db.objectStoreNames.contains('person')) {
objectStore = db.createObjectStore('person', { keyPath: 'id' });
}
}

主键（key）是默认建立索引的属性。比如，数据记录是{ id: 1, name: '张三' }，那么id属性可以作为主键。
主键也可以指定为下一层对象的属性，比如{ foo: { bar: 'baz' } }的foo.bar也可以指定为主键。

IndexedDB 自动生成主键 指定主键为一个递增的整数
var objectStore = db.createObjectStore(
'person',
{ autoIncrement: true }
);

新建索引
request.Onupgradeneeded= function(event) {
db = event.target.result;
var objectStore = db.createObjectStore('person', { keyPath: 'id' });
objectStore.createIndex('name', 'name', { unique: false });
objectStore.createIndex('email', 'email', { unique: true });
}
IDBObject.createIndex()的三个参数分别为索引名称、索引所在的属性、配置对象（说明该属性是否包含重复的值）。

数据增删改查

增
新增数据指的是向对象仓库写入数据记录。这需要通过事务完成。

function add() {
var request = db.transaction(['person'], 'readwrite')
.objectStore('person')//获取IDBObjectStore 表对象
.add({ id: 1, name: '张三', age: 24, email: 'zhangsan@example.com' });

request.Onsuccess= function (event) {
console.log('数据写入成功');
};

request.Onerror= function (event) {
console.log('数据写入失败');
}
}

add();

上面代码中，写入数据需要新建一个事务。新建时必须指定表格名称和操作模式（"只读"或"读写"）。
新建事务以后，通过IDBTransaction.objectStore(name)方法，拿到 IDBObjectStore 对象，再通过表格对象的add()方法，向表格写入一条记录。

写入操作是一个异步操作，通过监听连接对象的success事件和error事件，了解是否写入成功。

查询
function read() {
var transaction = db.transaction(['person']);
var objectStore = transaction.objectStore('person');
var request = objectStore.get(1);

request.Onerror= function(event) {
console.log('事务失败');
};

request.Onsuccess= function( event) {
if (request.result) {
console.log('Name: ' + request.result.name);
console.log('Age: ' + request.result.age);
console.log('Email: ' + request.result.email);
} else {
console.log('未获得数据记录');
}
};
}

read();
objectStore.get()方法用于读取数据，参数是主键的值。

遍历数据
遍历数据表格的所有记录，要使用指针对象 IDBCursor
function readAll() {
var objectStore = db.transaction('person').objectStore('person');

objectStore.openCursor().Onsuccess= function (event) {
var cursor = event.target.result;

if (cursor) {
console.log('Id: ' + cursor.key);
console.log('Name: ' + cursor.value.name);
console.log('Age: ' + cursor.value.age);
console.log('Email: ' + cursor.value.email);
cursor.continue();
} else {
console.log('没有更多数据了！');
}
};
}

readAll();
上面代码中，新建指针对象的openCursor()方法是一个异步操作，所以要监听success事件。

更新
更新数据要使用IDBObject.put()方法。
function update() {
var request = db.transaction(['person'], 'readwrite')
.objectStore('person')
.put({ id: 1, name: '李四', age: 35, email: 'lisi@example.com' });

request.Onsuccess= function (event) {
console.log('数据更新成功');
};

request.Onerror= function (event) {
console.log('数据更新失败');
}
}

update();
put()方法自动更新了主键为1的记录

删除
IDBObjectStore.delete()方法用于删除记录。
function remove() {
var request = db.transaction(['person'], 'readwrite')
.objectStore('person')
.delete(1);

request.Onsuccess= function (event) {
console.log('数据删除成功');
};
}

remove();

索引
索引的意义在于，可以让你搜索任意字段，也就是说从任意字段拿到数据记录。如果不建立索引，默认只能搜索主键（即从主键取值）。
假定新建表格的时候，对name字段建立了索引。
objectStore.createIndex('name', 'name', { unique: false });
就可以从name找到对应的数据记录了。

var transaction = db.transaction(['person'], 'readonly');
var store = transaction.objectStore('person');
var index = store.index('name');
var request = index.get('李四');

request.Onsuccess= function (e) {
var result = e.target.result;
if (result) {
// ...
} else {
// ...
}
}

最后一个用索引查的例子，有关键部分漏了，我这里补充下

getByIndex: async function (table, keyValue, indexCursor) {
try {
let db = await this.openDB();
let store = db
.transaction(table.name, 'readonly')
.objectStore(table.name);
let keyRng = IDBKeyRange.only(keyValue);
let request = store.index(indexCursor).openCursor(keyRng);
let data = [];
return new Promise(resolve => {
request.Onerror= function (event) {
reject(false);
};
request.Onsuccess= function (event) {
var cursor = event.target.result;
if (cursor) {
console.log(cursor.value);
data.push(cursor.value);
cursor.continue();
}
};
resolve(data);
});
} catch (error) {
return Promise.reject(false);
}
}

参考：

浏览器数据库 IndexedDB 入门教程 - 阮一峰的网络日志

IndexedDB API - Javascript 教程 - 网道

凡所有相，皆是虚妄