CKTIS / JavaScript
indexedDB.open — een database openen en het schema bijwerken
indexedDB.open opent of maakt asynchroon een lokale database. De methode retourneert een gebeurtenisgestuurd verzoek; schemawijzigingen horen in de upgradeneeded-handler.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
indexedDB.open(name)
indexedDB.open(name, version)indexedDB.open(name, version) retourneert een IDBOpenDBRequest, geen Promise. Bij success bevat request.result een IDBDatabase-verbinding. Als version wordt weggelaten, wordt de huidige databaseversie gebruikt, of 1 voor een nieuwe database.
De versie is een positief geheel getal. Een hogere versie activeert upgradeneeded: maak objectstores en indexen aan binnen deze updatetransactie. success treedt pas op nadat de update is vastgelegd. Een lagere versie veroorzaakt asynchroon een VersionError; 0 veroorzaakt synchroon een TypeError.
Andere open verbindingen kunnen blocked veroorzaken; dit betekent dat de bewerking wacht, niet dat deze definitief is mislukt. Sluit ze met db.close() als reactie op versionchange. Verwerk zowel error als synchrone uitzonderingen.
Dit is een Web API en geen onderdeel van ECMAScript. Controleer de beschikbaarheid in de doelbrowser; Node 24 toont die niet aan. Het opslagbeleid kan toegang weigeren. Als het openen lukt, sluit het voorbeeld de verbinding en vraagt het met indexedDB.deleteDatabase(name) om de database te verwijderen. In het getoonde geval met SecurityError wordt geen database aangemaakt.
Voorbeelden
(() => {
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);
}
})();Resultaat
Open failed: SecurityError
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.