IDBVersionChangeEvent()

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

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

構文

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

引数

type

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

options 省略可

オブジェクトです。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