CKTIS / JavaScript
indexedDB.open — aprire un database e aggiornarne lo schema
indexedDB.open apre o crea in modo asincrono un database locale. Restituisce una richiesta basata su eventi; le modifiche allo schema vanno eseguite nel gestore upgradeneeded.
Versione: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Sintassi
indexedDB.open(name)
indexedDB.open(name, version)indexedDB.open(name, version) restituisce un IDBOpenDBRequest, non una Promise. In success, request.result contiene una connessione IDBDatabase. Se version viene omesso, si usa la versione attuale del database oppure 1 se il database è nuovo.
La versione è un numero intero positivo. Una versione superiore attiva upgradeneeded: crea gli object store e gli indici all’interno di questa transazione di aggiornamento. success si verifica solo dopo il completamento dell’aggiornamento. Una versione inferiore causa un VersionError asincrono; 0 genera un TypeError sincrono.
Altre connessioni aperte possono causare blocked; significa che l’operazione è in attesa, non che sia fallita definitivamente. Chiudile con db.close() in risposta a versionchange. Gestisci sia error sia le eccezioni sincrone.
Questa è una Web API, non fa parte di ECMAScript. Verificala nel browser di destinazione; Node 24 non ne dimostra la disponibilità. La policy di archiviazione può negare l’accesso. Se l’apertura riesce, l’esempio chiude la connessione e richiede l’eliminazione del database con indexedDB.deleteDatabase(name). Nel caso mostrato, in cui si verifica un SecurityError, non viene creato alcun database.
Esempi
(() => {
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);
}
})();Risultato
Open failed: SecurityError
Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.