База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / JavaScript

IDBDatabase — връзка с база данни IndexedDB

IDBDatabase представлява отворена връзка с база данни IndexedDB. Тя позволява създаване на хранилища при надграждане на схемата, стартиране на транзакции и затваряне на връзката.

Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Синтаксис

const request = indexedDB.open(name, version);
// In upgradeneeded:
const store = request.result.createObjectStore(storeName, options);
// After open succeeds:
const db = request.result;
db.objectStoreNames;
const tx = db.transaction(storeNames, "readonly");
db.onversionchange = () => db.close();

Получаваш IDBDatabase като request.result, след като indexedDB.open() завърши успешно. Това е Web API, а не част от ECMAScript; Node 24 не потвърждава поддръжка в браузърите. Провери дали indexedDB е наличен в целевата среда; цитираните спецификации не са таблици за съвместимост на браузъри.

IDBDatabase.createObjectStore() работи само в активна транзакция за надграждане, обикновено в upgradeneeded. IDBDatabase.objectStoreNames връща подреден списък от имена тип DOMStringList, а не масив. При нужда използвай .contains() преди създаването на хранилище.

IDBDatabase.transaction() задава обхвата на хранилищата и режима: по подразбиране readonly или readwrite. С нея не може ръчно да се създаде транзакция versionchange. Добавяй операциите, докато транзакцията е активна; не разчитай, че ще остане активна след произволни извиквания на await. Успешната заявка не означава, че транзакцията е потвърдена: изчакай нейното complete.

В отговор на заявка за отваряне на базата данни с по-висок номер на версията или за изтриването ѝ IndexedDB изпраща събитието IDBDatabase.versionchange до съществуващите връзки с базата, с изключение на тези, за които е зададен флагът close pending. Тези връзки не получават събитието дори ако останат отворени до приключването на текущите си транзакции. За подаването на заявката не е необходима отворена връзка, а заявката за изтриване не отваря връзка. Обработи събитието чрез onversionchange. То е различно от upgradeneeded. IDBDatabase.close() предотвратява нови транзакции и затваря връзката след приключване на съществуващите, без да изтрива данни. Оставените отворени връзки могат да блокират надгражданията.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Using an IDBDatabase connection</title>
</head>
<body>
<script>
  (() => {
    const name = `cktis-connection-${Date.now()}-${Math.random()}`;
    const unavailable = () => console.log('IndexedDB unavailable in this context.');
    let open;
    try {
      // Opening a connection requires a context that permits IndexedDB.
      open = indexedDB.open(name, 1);
    } catch {
      unavailable();
      return;
    }
    open.onerror = unavailable;
    open.onupgradeneeded = () => {
      open.result.createObjectStore('notes', { keyPath: 'id' });
    };
    open.onsuccess = () => {
      const db = open.result;
      const tx = db.transaction('notes', 'readwrite');
      const store = tx.objectStore('notes');
      store.put({ id: 1, text: 'Hello' });
      const read = store.get(1);
      function cleanup() {
        db.close();
        indexedDB.deleteDatabase(name);
      }
      tx.oncomplete = () => {
        console.log(read.result.text);
        cleanup();
      };
      tx.onabort = () => {
        cleanup();
        console.log('Database transaction aborted.');
      };
    };
  })();
</script>
</body>
</html>

Резултат

Hello

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници