The versionchange
event is fired when a database structure change (upgradeneeded
event send on an IDBOpenDBRequest
or IDBFactory.deleteDatabase
) was requested elsewhere (most probably in another window/tab on the same computer).
IDBDatabase: versionchange event
Syntax
Use the event name in methods like addEventListener()
, or set an event handler property.
addEventListener('versionchange', event => { }); onversionchange = event => { };
Event type
A generic Event
.
Examples
This example opens a database and, on success, adds a listener to versionchange
:
// Open the database const dBOpenRequest = window.indexedDB.open('Nonexistent', 4); dBOpenRequest.onupgradeneeded = event => { const db = event.target.result; // Create an objectStore for this database const objectStore = db.createObjectStore('toDoList', { keyPath: 'taskTitle' }); // define what data items the objectStore will contain objectStore.createIndex('hours', 'hours', { unique: false }); objectStore.createIndex('minutes', 'minutes', { unique: false }); objectStore.createIndex('day', 'day', { unique: false }); objectStore.createIndex('month', 'month', { unique: false }); objectStore.createIndex('year', 'year', { unique: false }); }; dBOpenRequest.addEventListener('success', event => { const db = event.target.result; db.addEventListener('versionchange', event => { console.log('The version of this database has changed'); }); });
The same example, using the onversionchange
event handler property:
// Open the database const dBOpenRequest = window.indexedDB.open('Nonexistent', 4); dBOpenRequest.onupgradeneeded = event => { const db = event.target.result; // Create an objectStore for this database const objectStore = db.createObjectStore('toDoList', { keyPath: 'taskTitle' }); // define what data items the objectStore will contain objectStore.createIndex('hours', 'hours', { unique: false }); objectStore.createIndex('minutes', 'minutes', { unique: false }); objectStore.createIndex('day', 'day', { unique: false }); objectStore.createIndex('month', 'month', { unique: false }); objectStore.createIndex('year', 'year', { unique: false }); }; dBOpenRequest.onsuccess = event => { const db = event.target.result; db.onversionchange = event => { console.log('The version of this database has changed'); }; };
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
versionchange_event |
23
|
12
|
10
|
10
|
15
|
7
|
≤37
|
25
|
22
|
14
|
8
|
1.5
|
See also
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IDBDatabase/versionchange_event