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

CKTIS / JavaScript

indexedDB.open — отваряне на база данни и надграждане на схемата ѝ

indexedDB.open отваря или създава локална база данни асинхронно. Връща заявка, управлявана чрез събития; промените по схемата се правят в обработчика upgradeneeded.

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

Синтаксис

indexedDB.open(name)
indexedDB.open(name, version)

indexedDB.open(name, version) връща IDBOpenDBRequest, а не Promise. При success request.result съдържа връзка IDBDatabase. Ако пропуснете version, се използва текущата версия на базата данни или 1 за нова база.

Версията е положително цяло число. По-висока версия задейства upgradeneeded: създайте хранилища за обекти и индекси в рамките на тази транзакция за надграждане. success настъпва едва след потвърждаване на надграждането. По-ниска версия причинява асинхронен VersionError; 0 предизвиква синхронен TypeError.

Други отворени връзки могат да предизвикат blocked; това означава изчакване, а не окончателен неуспех. Затворете ги с db.close() в отговор на versionchange. Обработвайте както error, така и синхронните изключения.

Това е Web API, а не част от ECMAScript. Проверете наличността в целевия браузър; Node 24 не я доказва. Политиката за съхранение може да откаже достъп. При успешно отваряне примерът затваря връзката и заявява изтриване на базата данни чрез indexedDB.deleteDatabase(name). В показания случай с грешка SecurityError не се създава база данни.

Примери

(() => {
  const name = `cktis-open-${crypto.getRandomValues(new Uint32Array(4)).join('-')}`;
  const failed = error => console.log(`Open failed: ${error.name}`);

  try {
    const request = indexedDB.open(name, 1);
    let upgradedFrom;
    request.onupgradeneeded = event => {
      upgradedFrom = event.oldVersion;
      request.result.createObjectStore('notes');
    };
    request.onblocked = () => console.log('Open blocked by an open connection');
    request.onerror = () => failed(request.error);
    request.onsuccess = () => {
      const db = request.result;
      const version = db.version;
      const hasNotes = db.objectStoreNames.contains('notes');
      db.close();
      indexedDB.deleteDatabase(name);
      console.log(`Opened version ${version} from ${upgradedFrom}; notes store: ${hasNotes}`);
    };
  } catch (error) {
    failed(error);
  }
})();

Резултат

Open failed: SecurityError

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

Източници