CKTIS / JavaScript
indexedDB.open — otevření databáze a aktualizace jejího schématu
indexedDB.open asynchronně otevře nebo vytvoří místní databázi. Vrací požadavek řízený událostmi; změny schématu patří do obslužné funkce upgradeneeded.
Verze: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
indexedDB.open(name)
indexedDB.open(name, version)indexedDB.open(name, version) vrací IDBOpenDBRequest, nikoli Promise. Při události success obsahuje request.result připojení IDBDatabase. Pokud version vynecháte, použije se aktuální verze databáze, případně 1 u nové databáze.
Verze je kladné celé číslo. Vyšší verze vyvolá upgradeneeded: v rámci této aktualizační transakce vytvořte úložiště objektů a indexy. Událost success nastane až po potvrzení aktualizace. Nižší verze způsobí asynchronní VersionError; hodnota 0 vyvolá synchronní TypeError.
Jiná otevřená připojení mohou způsobit událost blocked; znamená to čekání, nikoli konečné selhání. V reakci na versionchange je zavřete pomocí db.close(). Ošetřete jak error, tak synchronní výjimky.
Jde o Web API, nikoli o součást ECMAScriptu. Dostupnost ověřte v cílovém prohlížeči; Node 24 ji nedokládá. Zásady úložiště mohou přístup odmítnout. Pokud se databázi podaří otevřít, příklad zavře připojení a pomocí indexedDB.deleteDatabase(name) požádá o odstranění databáze. V zobrazeném případě s chybou SecurityError se žádná databáze nevytvoří.
Příklady
(() => {
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);
}
})();Výsledek
Open failed: SecurityError
Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.