IndexDB 小白使用体验

最新推荐文章于 2024-07-03 14:28:39 发布

sylvia_0815

最新推荐文章于 2024-07-03 14:28:39 发布

阅读量1.5k

点赞数 3

分类专栏：笔记文章标签： javascript

本文章版权只限本人所有

本文链接：https://blog.csdn.net/sylvia_0815/article/details/116190930

版权

笔记专栏收录该内容

58 篇文章 1 订阅

订阅专栏

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 库之后，关闭浏览器，再次打开后