CKTIS / JavaScript
IDBVersionChangeEvent.oldVersion — предишната версия на базата данни IndexedDB
Свойството IDBVersionChangeEvent.oldVersion показва предишния номер на версията на база данни IndexedDB. При събитие upgradeneeded то помага да се изберат необходимите миграции; стойност 0 означава, че базата данни не е съществувала преди това.
Версия: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Синтаксис
event.oldVersionIDBVersionChangeEvent наследява Event и носи информация за версията на база данни IndexedDB. Неговото свойство IDBVersionChangeEvent.oldVersion е само за четене и съдържа предишния номер на версията като JavaScript number, а не като низ или BigInt.
Събитието upgradeneeded на IDBOpenDBRequest използва този интерфейс, когато отварянето на база данни изисква тя да бъде създадена или версията ѝ да бъде увеличена. Ако базата данни не е съществувала преди това, event.oldVersion е 0. В обработчик за миграции отделни условия като event.oldVersion < 1 и event.oldVersion < 2 позволяват да се изпълнят всички липсващи стъпки, включително когато междинни версии са пропуснати.
Не бъркайте oldVersion с newVersion: първото описва предишната версия, а второто — целевата версия. Примерът създава само синтетични събития, затова не извършва миграция и не доказва, че надстройката на база данни е успешна. Това е API на браузъра, а не функция на езика ECMAScript; наличността на конструктора трябва да се провери отделно от поддръжката на самото свойство.
Примери
(() => {
const firstCreation = new IDBVersionChangeEvent("upgradeneeded", {
oldVersion: 0,
newVersion: 3,
});
const upgrade = new IDBVersionChangeEvent("upgradeneeded", {
oldVersion: 2,
newVersion: 3,
});
console.log(firstCreation.oldVersion);
console.log(upgrade.oldVersion);
})();Резултат
0 2
Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.