Spec-Zone.ru › Web APIs

IDBVersionChangeEvent

Базовая линия Широко доступна

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с сентября 2021 года.

  • Узнать больше
  • Показать полную совместимость
  • Отправить отзыв

Примечание: Эта функция доступна в Web Workers.

Интерфейс IDBVersionChangeEvent из API IndexedDB указывает, что версия базы данных изменилась в результате обработки события onupgradeneeded.

Событие IDBVersionChangeEvent

Конструктор

IDBVersionChangeEvent()

Создаёт и возвращает новый объект IDBVersionChangeEvent, который используется для обозначения изменения версии базы данных.

Свойства экземпляра

Также наследует свойства от своего родительского интерфейса Event.

IDBVersionChangeEvent.oldVersion Только для чтения

Возвращает старую версию базы данных.

IDBVersionChangeEvent.newVersion Только для чтения

Возвращает новую версию базы данных.

Методы экземпляра

Нет специфических методов, но наследует методы от своего родительского интерфейса Event.

Пример

В следующем фрагменте кода мы делаем запрос на открытие базы данных и включаем обработчики для случаев успешного и неуспешного выполнения. При изменении версии (после события upgradeneeded), событие success будет реализовывать интерфейс IDBVersionChangeEvent. Для полного рабочего примера, смотрите наше приложение To-do Notifications (посмотреть пример онлайн).

const note = document.querySelector("ul");

// Let us open version 4 of our database
const DBOpenRequest = window.indexedDB.open("toDoList", 4);

// these two event handlers act on the database being opened successfully, or not
DBOpenRequest.onerror = (event) => {
  note.appendChild(document.createElement("li")).textContent =
    "Error loading database.";
};

DBOpenRequest.onsuccess = (event) => {
  note.appendChild(document.createElement("li")).textContent =
    "Database initialized.";

  // store the result of opening the database in the db variable. This is used a lot later on, for opening transactions and suchlike.
  const db = DBOpenRequest.result;
};

Спецификации

Спецификация
Indexed Database API 3.0
# events

Совместимость с браузерами

Рабочий стол Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox for Android Opera Android Safari на IOS Samsung Internet WebView Android
IDBVersionChangeEvent 41 79 25 28 10 41 25 28 10 4.0 41
IDBVersionChangeEvent 2412 12 1610–16 1515 8 2518 22 1414 8 1.51.0 4.4≤37
newVersion 23 12 10 15 8 25 22 14 8 1.5 4.4
oldVersion 23 12 10 15 8 25 22 14 8 1.5 4.4
worker_support 23 12 37 15 10 25 37 14 10 1.5 4.4

См. также

  • Использование IndexedDB
  • Начало транзакций: IDBDatabase
  • Использование транзакций: IDBTransaction
  • Установка диапазона ключей: IDBKeyRange
  • Получение и изменение данных: IDBObjectStore
  • Использование курсоров: IDBCursor
  • Пример: To-do Notifications (Открыть пример).

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IDBVersionChangeEvent

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API