База данных HTML5 Web IndexedDB

IndexedDB — это браузерная NoSQL-база данных, используемая для постоянного хранения больших объёмов структурированных данных на стороне клиента.

IndexedDB позволяет хранить сложные объекты данных (такие как объекты, массивы, файлы и т. д.) через пары ключ-значение и поддерживает транзакции, индексы, управление версиями и сложные операции запросов.

IndexedDB работает асинхронно и не блокирует основной поток, что делает её подходящей для офлайн-приложений, кэширования и других сценариев.

IndexedDB отлично подходит для приложений, которым необходимо хранить большие объёмы структурированных данных, особенно для веб-приложений, которые хотят поддерживать офлайн-режим или выполнять сложные запросы.

Возможности IndexedDB

  • Хранение в виде пар ключ-значение: Данные хранятся в объектных хранилищах в форме пар ключ-значение.
  • Поддержка транзакций: Все операции с данными должны выполняться в рамках транзакции для обеспечения согласованности и целостности данных.
  • Асинхронный API: Все операции асинхронны и не блокируют поток UI, используя обратные вызовы событий или промисы для обработки результатов.
  • Управление версиями: База данных использует номера версий для управления схемой базы данных (например, для создания или изменения объектных хранилищ).
  • Индексы: Поддерживает создание индексов по полям данных для ускорения запросов.
  • Поддержка офлайн-режима: Данные могут постоянно храниться и быть доступными даже при отключённой сети, что делает её очень подходящей для создания офлайн-веб-приложений.

Синтаксис IndexedDB

Синтаксис IndexedDB описывается следующим образом:

// Открыть или создать базу данных
var request = indexedDB.open('databaseName', version);

// Обработать обновление базы данных
request.onupgradeneeded = function(event) {
  var db = event.target.result;

  // Создать хранилище объектов (таблицу) и задать первичный ключ
  var objectStore = db.createObjectStore('storeName', { keyPath: 'id' });

  // Создать индекс
  objectStore.createIndex('fieldName', 'fieldName', { unique: false });
};

// Обратный вызов при успешном открытии базы данных
request.onsuccess = function(event) {
  var db = event.target.result;

  // Выполнение операций транзакции
  var transaction = db.transaction('storeName', 'readwrite');
  var objectStore = transaction.objectStore('storeName');

  // Вставка данных
  objectStore.add({ id: 1, name: 'John Doe', age: 30 });

  // Запрос данных
  var query = objectStore.get(1);
  query.onsuccess = function(event) {
    console.log(event.target.result);
  };
};

// Обработка ошибок
request.onerror = function(event) {
  console.error('Ошибка базы данных:', event.target.error);
};

Методы IndexedDB

1、indexedDB.open():Используется для открытия существующей базы данных или создания новой базы данных.

var request = indexedDB.open('databaseName', version);

2、db.createObjectStore():Создайте хранилище объектов (аналогично таблице) в событии onupgradeneeded.

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

3、objectStore.add():Добавьте данные в хранилище объектов в рамках транзакции.

objectStore.add({ id: 1, name: 'John Doe' });

3、objectStore.get():Получите данные из хранилища объектов на основе значения ключа.

var request = objectStore.get(1);

4、objectStore.put():Обновите существующую запись или вставьте, если запись не существует.

objectStore.put({ id: 1, name: 'John Updated' });

5、objectStore.delete():Удалите запись на основе значения ключа.

objectStore.delete(1);

6、db.transaction():Создайте транзакцию, указав имя хранилища объектов и режим транзакции (readonly или readwrite).

var transaction = db.transaction(['storeName'], 'readwrite');

7、objectStore.createIndex():Создайте индекс для полей в хранилище объектов для более быстрых запросов.

objectStore.createIndex('nameIndex', 'name', { unique: false });

Примеры приложений IndexedDB

Ниже приведен полный пример IndexedDB для создания базы данных, вставки данных, запроса данных и обновления данных.

Пример

// Открыть или создать базу данных
var request = indexedDB.open('myDatabase', 1);

// Срабатывает при изменении версии базы данных или при первом создании
request.onupgradeneeded = function(event) {
  var db = event.target.result;

  // Создать хранилище объектов (таблицу) и установить первичный ключ в 'id'
  var objectStore = db.createObjectStore('customers', { keyPath: 'id' });

  // Создать индекс для поля 'name'
  objectStore.createIndex('name', 'name', { unique: false });
};

// База данных успешно открыта
request.onsuccess = function(event) {
  var db = event.target.result;

  // Вставка данных
  var transaction = db.transaction(['customers'], 'readwrite');
  var objectStore = transaction.objectStore('customers');
  objectStore.add({ id: 1, name: 'Джон Доу', email: 'john@example.com' });
  objectStore.add({ id: 2, name: 'Джейн Доу', email: 'jane@example.com' });

  transaction.oncomplete = function() {
    console.log('Транзакция завершена: данные добавлены.');
  };

  transaction.onerror = function(event) {
    console.error('Транзакция не удалась:', event);
  };

  // Запрос данных
  var queryTransaction = db.transaction(['customers']);
  var queryObjectStore = queryTransaction.objectStore('customers');
  var query = queryObjectStore.get(1);

  query.onsuccess = function(event) {
    console.log('Клиент:', event.target.result);
  };

  // Обновить данные
  var updateTransaction = db.transaction(['customers'], 'readwrite');
  var updateObjectStore = updateTransaction.objectStore('customers');
  var updatedCustomer = { id: 1, name: 'Джон Смит', email: 'johnsmith@example.com' };

  updateObjectStore.put(updatedCustomer);

  updateTransaction.oncomplete = function() {
    console.log('Транзакция завершена: данные обновлены.');
  };
};

// Обработка ошибок
request.onerror = function(event) {
  console.error('Ошибка базы данных:', event.target.error);
};

Сценарии использования IndexedDB

  • Офлайн-хранилище: IndexedDB позволяет хранить данные для доступа при отсутствии подключения к сети, что критически важно для офлайн-веб-приложений.

  • Кэширование: его можно использовать для хранения больших объёмов кэшированных данных (например, файлов, изображений, видео) для повышения скорости загрузки приложения.

  • Обработка сложных данных: подходит для сценариев, требующих хранения и обработки больших объёмов структурированных данных, особенно тех, которым нужны функции индексирования и запросов.

  • Локальная база данных: IndexedDB может служить локальной базой данных для фронтенд-приложений, храня пользовательские данные, информацию о конфигурации, состояние приложения и т. д.


Преимущества IndexedDB

  • Большой объём хранилища: поддерживает хранение большего объёма данных (часто сотни MB или больше), что значительно превышает ограничение localStorage в 5MB.

  • Расширенные операции с данными: поддерживает сложные операции, такие как транзакции, индексы, запросы и пакетная обработка.

  • Поддержка офлайн-режима: данные хранятся на устройстве пользователя, доступны офлайн и могут синхронизироваться с сервером.


Недостатки IndexedDB

  • Сложный API: По сравнению с более простыми клиентскими хранилищами, такими как localStorage, API IndexedDB относительно сложен и требует больше кода.

  • Асинхронная обработка: операции выполняются асинхронно; новички могут быть не привыкли работать с колбэками или промисами.

  • IndexedDB отлично подходит для приложений, которым необходимо хранить большие объёмы структурированных данных, особенно для веб-приложений, которые хотят поддерживать офлайн-режим или выполнять сложные запросы.

Другие расширения