本文主要是介绍IndexDB 小白使用体验,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
1.IndexDB的概述
现有的浏览器数据储存方案,都不适合储存大量数据:Cookie 的大小不超过 4KB,且每次请求都会发送回服务器;LocalStorage 在 2.5MB 到 10MB 之间(各家浏览器不同),而且不提供搜索功能,不能建立自定义的索引。所以,需要一种新的解决方案,这就是 IndexedDB 诞生的背景。
通俗地说,IndexedDB 就是浏览器提供的本地数据库,它可以被网页脚本创建和操作。IndexedDB 允许储存大量数据,提供查找接口,还能建立索引。这些都是 LocalStorage 所不具备的。就数据库类型而言,IndexedDB 不属于关系型数据库(不支持 SQL 查询语句),更接近 NoSQL 数据库。
特点如下:
(1)键值对储存。 IndexedDB 内部采用对象仓库(object store)存放数据。所有类型的数据都可以直接存入,包括 JavaScript 对象。对象仓库中,数据以"键值对"的形式保存,每一个数据记录都有对应的主键,主键是独一无二的,不能有重复,否则会抛出一个错误。
(2)异步。 IndexedDB 操作时不会锁死浏览器,用户依然可以进行其他操作,这与 LocalStorage 形成对比,后者的操作是同步的。异步设计是为了防止大量数据的读写,拖慢网页的表现。
(3)支持事务。 IndexedDB 支持事务(transaction),这意味着一系列操作步骤之中,只要有一步失败,整个事务就都取消,数据库回滚到事务发生之前的状态,不存在只改写一部分数据的情况。
(4)同源限制 IndexedDB 受到同源限制,每一个数据库对应创建它的域名。网页只能访问自身域名下的数据库,而不能访问跨域的数据库。
(5)储存空间大 IndexedDB 的储存空间比 LocalStorage 大得多,一般来说不少于 250MB,甚至没有上限。
(6)支持二进制储存。 IndexedDB 不仅可以储存字符串,还可以储存二进制数据(ArrayBuffer 对象和 Blob 对象)。
2.关键概念与用法
IndexedDB 是一个事务型数据库系统,类似于基于 SQL 的 RDBMS。 然而,不像 RDBMS 使用固定列表,IndexedDB 是一个基于 JavaScript 的面向对象数据库。IndexedDB 允许您存储和检索用键索引的对象;可以存储结构化克隆算法支持的任何对象。您只需要指定数据库模式,打开与数据库的连接,然后检索和更新一系列事务。
通常包括一个或多个对象库。每个数据库必须具有以下内容:
- 名称。这可以标识特定来源内的数据库,并在整个生命周期内保持不变。名称可以是任何字符串值(包括空字符串)。
当前版本。首次创建数据库时,如果未另外指定,则其版本为整数1。每个数据库在任何给定时间只能有一个版本。
注意: 正如大多数的 web 储存解决方案一样,IndexedDB 也遵守同源策略。因此当你在某个域名下操作储存数据的时候,你不能操作其他域名下的数据。
2.1 同步和异步(Synchronous、asynchronous)
使用 IndexedDB 执行的操作是异步执行的,以免阻塞应用程序。IndexedDB 最初包括同步和异步 API。同步 API 仅用于 Web Workers,且已从规范中移除,因为尚不清晰是否需要。但如果 Web 开发人员有足够的需求,可以重新引入同步 API。
2.2 储存限制和回收标准
有许多 Web 技术在客户端(即本地磁盘)存储各种数据。IndexedDB 是最常见的一个。浏览器计算分配给 Web 数据存储的空间以及达到该限制时要删除的内容的过程并不简单,并且在浏览器之间有所不同。浏览器存储限制和回收标准尝试解释这是如何工作的,至少在火狐的情况下是如此。
3.局限性
IndexedDB旨在涵盖大多数需要客户端存储的情况。但是,它不是为以下几种情况设计的:
- 国际化排序。并非所有语言都以相同的方式对字符串进行排序,因此不支持国际化排序。虽然数据库无法按特定的国际化顺序存储数据,但是您可以对自己从数据库中读取的数据进行排序。但是请注意,自Firefox 43起,已启用启用实验标记的区域设置感知排序(当前仅适用于Firefox)。
- 正在同步。该API并非旨在与服务器端数据库进行同步。您必须编写使客户端indexedDB数据库与服务器端数据库同步的代码。
- 全文搜索。该API在SQL中没有等效的
LIKE
运算符。
此外,请注意,在以下情况下,浏览器会清除数据库:
- 用户要求清除。许多浏览器具有允许用户擦除为给定网站存储的所有数据的设置,包括cookie,书签,存储的密码和IndexedDB数据。
- 浏览器处于私人浏览模式。某些浏览器具有“专用浏览”(Firefox)或“隐身”(Chrome)模式。在会话结束时,浏览器会清除数据库。
- 已达到磁盘或配额限制。
- 数据已损坏。
- 对功能进行了不兼容的更改。
确切的情况和浏览器功能会随时间而变化,但是浏览器供应商的总的原则是尽一切可能保留数据。
4. 使用
操作流程:
- 打开数据库
- 新建数据库
- 新增数据
- 读取数据
- 遍历数据
- 更新数据
- 删除数据
- 使用索引
4.1 打开数据库
indexedDB.open()
var request = window.indexedDB.open(databaseName, version);
这个方法的参数有两个,databaseName代表的是数据库的名字。第二个参数是个整数,代表着数据库的版本,如果省略,打开已有数据库时,默认为当前版本;新建数据库时,默认为1
。
indexedDB.open()
方法返回一个 IDBRequest 对象。这个对象通过三种事件error
、success
、upgradeneeded
,处理打开数据库的操作结果。
4.1.1 error
事件
该事件表示打开数据库失败
var request = window.indexedDB.open(databaseName, version);
request.onerror = function (e) {console.log('打开xx对象库报错', e)
}
4.1.2 success
事件
该事件表示打开数据库成功
var request = window.indexedDB.open(databaseName, version);
request.onsuccess = function (e) {console.log('打开xx对象库成功',e.result);
};
通过返回的result属性可以拿到数据库的对象
4.1.3 upgradeneeded
事件
如果指定的版本号,大于数据库的实际版本号,就会发生数据库升级事件upgradeneeded
var request = window.indexedDB.open(databaseName, version);
request.onupgradeneeded = function(e) {console.log('数据库升级')console.log('objectStore(版本不更新,就只会出现一次) ', objectStore )
}
4.2 新建数据库
新建数据库与打开数据库是同一个操作。如果指定的数据库不存在,就会新建。不同之处在于,后续的操作主要在upgradeneeded
事件的监听函数里面完成,因为这时版本从无到有,所以会触发这个事件。
通常,新建数据库以后,第一件事是新建对象仓库(即新建表)。
var request = window.indexedDB.open('text', 1);
var db;
request.onupgradeneeded = function(e) {console.log('数据库升级')db = e.target.result;var objectStore;if (!db.objectStoreNames.contains('person')) {objectStore = db.createObjectStore('person', { keyPath: 'id' });}console.log('objectStore(版本不更新,就只会出现一次) ', objectStore )
}
上面这段代码主要是先对text数据库中有没有person这个对象仓库,如果没有,则新建,并且将id当为主键。当然,如果保存的数据中没有合适作为主键的属性,那么可以让IndexedDB 自动生成主键。
// objectStore = db.createObjectStore('person', { keyPath: 'id' });
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()
的三个参数分别为索引名称、索引所在的属性、配置对象(说明该属性是否包含重复的值)。
4.3 新增数据
var request = window.indexedDB.open('text', 1);
var db;
request.onsuccess = function (e) {db = request.result;console.log('打开text对象库成功',e);add();
};
function add() {var _request = db.transaction(['person'], 'readwrite').objectStore('person').add({ id: 1, name: '张三', age: 24, email: 'zhangsan@example.com' });_request.onsuccess = function (e) {console.log('数据写入成功',e);};_request.onerror = function (e) {console.log('数据写入失败',e);}
}
上面代码中,写入数据需要新建一个事务。新建时必须指定表格名称和操作模式(“只读”或“读写”)。新建事务以后,通过IDBTransaction.objectStore(name)
方法,拿到 IDBObjectStore 对象,再通过表格对象的add()
方法,向表格写入一条记录。
写入操作是一个异步操作,通过监听连接对象的success
事件和error
事件,了解是否写入成功。
4.4 读取数据
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('未获得数据记录');}};
}
上面代码中,objectStore.get()
是一个异步操作,所以要监听success
事件,参数是主键的值。
4.5 遍历数据
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('没有更多数据了!');}};
}
上面代码中,新建指针对象的openCursor()
方法是一个异步操作,所以要监听success
事件。
4.5 更新数据
function update (){var _request = db.transaction(['person'], 'readwrite').objectStore('person').put({ id: 1, name: '王二麻子', age: 24, email: 'wangermazi@example.com' });_request.onsuccess = function (e) {console.log('数据写入成功',e);};_request.onerror = function (e) {console.log('数据写入失败',e);}
}
上面代码中,put()
方法自动更新了主键为1
的记录
4.6 删除数据
function remove() {var request = db.transaction(['person'], 'readwrite').objectStore('person').delete(1);request.onsuccess = function (event) {console.log('数据删除成功');};
}
4.7 删除数据表
deleteObjectStore
延伸api:
4.8 删除数据库
调用deleteDatabase()
方法以后,当前数据库的其他已经打开的连接都会接收到versionchange
事件。
注意,删除不存在的数据库并不会报错。
删除前:
var delDatabase = window.indexedDB.deleteDatabase('text');delDatabase.onerror = function (event) {console.log('text库删除失败');
};delDatabase.onsuccess = function (event) {console.log('text库删除成功');
};
删除了 text 库之后,关闭浏览器,再次打开后
这篇关于IndexDB 小白使用体验的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!