IDBVersionChangeEvent()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。

IDBVersionChangeEvent() コンストラクターは、onupgradeneeded イベントハンドラーを実行した結果データベースのバージョンが変更されたことを表す、新しい IDBVersionChangeEvent オブジェクトを作成します。

構文

new IDBVersionChangeEvent(type)
new IDBVersionChangeEvent(type, options)

イベントの名前を表す文字列です。大文字と小文字は区別され、ブラウザーは versionchange、success、blocked のいずれかに設定します。

オブジェクトです。Event() で定義されているプロパティに加え、以下のプロパティを持つことができます。

oldVersion 省略可: データベースの更新前のバージョンを表す数値です。デフォルト値は 0 です。
newVersion 省略可: データベースの新しいバージョンを表す unsigned long 値、もしくはデータベースが削除される場合は null です。デフォルト値は null です。

新しい IDBVersionChangeEvent オブジェクトを返します。

動作する例全体は、To-do Notifications アプリケーションを参照してください。(動く例を見る)

Specification
Indexed Database API 3.0 # dom-idbversionchangeevent-idbversionchangeevent

BCD tables only load in the browser