IDBVersionChangeEvent()
Baseline
広く利用可能
この機能は広く実装されており、多くのバージョンの端末やブラウザーで動作します。2020年1月以降、すべてのブラウザーで利用可能です。
安全なコンテキスト用: この機能は一部またはすべての対応しているブラウザーにおいて、安全なコンテキスト (HTTPS) でのみ利用できます。
IDBVersionChangeEvent() コンストラクターは、onupgradeneeded イベントハンドラーを実行した結果データベースのバージョンが変更されたことを表す、新しい IDBVersionChangeEvent オブジェクトを作成します。
構文
js
new IDBVersionChangeEvent(type)
new IDBVersionChangeEvent(type, options)
引数
type-
イベントの名前を表す文字列です。大文字と小文字は区別され、ブラウザーは
versionchange、success、blockedのいずれかに設定します。 options省略可-
オブジェクトです。
Event()で定義されているプロパティに加え、以下のプロパティを持つことができます。oldVersion省略可-
データベースの更新前のバージョンを表す数値です。デフォルト値は
0です。 newVersion省略可-
データベースの新しいバージョンを表す
unsigned long値、もしくはデータベースが削除される場合はnullです。デフォルト値はnullです。
返値
新しい IDBVersionChangeEvent オブジェクトを返します。
例
動作する例全体は、To-do Notifications アプリケーションを参照してください。(動く例を見る)
仕様書
| 仕様書 |
|---|
| Indexed Database API 3.0 # dom-idbversionchangeevent-idbversionchangeevent |