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.