Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

indexedDB.open — otwieranie bazy i aktualizacja schematu

indexedDB.open asynchronicznie otwiera lub tworzy lokalną bazę danych. Zwraca żądanie obsługiwane zdarzeniami; zmiany schematu wykonuje się podczas upgradeneeded.

Wersja: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Składnia

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

indexedDB.open(name, version) zwraca IDBOpenDBRequest, nie Promise. W success właściwość request.result zawiera połączenie IDBDatabase. Bez version używana jest bieżąca wersja bazy albo 1 dla nowej bazy.

Wersja to dodatnia liczba całkowita. Wyższa uruchamia upgradeneeded: w tej transakcji aktualizacji twórz magazyny obiektów i indeksy. success następuje dopiero po zatwierdzeniu aktualizacji. Niższa wersja powoduje asynchroniczny VersionError; 0 rzuca synchroniczny TypeError.

Inne otwarte połączenia mogą wywołać blocked; to oczekiwanie, nie błąd końcowy. Zamykaj je przez db.close() w odpowiedzi na versionchange. Obsługuj zarówno error, jak i wyjątki synchroniczne.

To Web API, nie część ECMAScript. Dostępność sprawdzaj w docelowej przeglądarce; Node 24 jej nie dowodzi. Polityka przechowywania może odmówić dostępu. Jeśli otwarcie się powiedzie, przykład zamyka połączenie i wysyła żądanie usunięcia bazy przez indexedDB.deleteDatabase(name). W pokazanym przebiegu z błędem SecurityError baza nie powstaje.

Przykłady

(() => {
  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);
  }
})();

Wynik

Open failed: SecurityError

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła