IDBVersionChangeEvent
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年7月.
IndexedDB API の IDBVersionChangeEvent インターフェイスは、onupgradeneeded イベントハンドラー関数の結果として、データベースのバージョンが変更されたことを表します。
メモ: この機能はウェブワーカー内で利用可能です。
コンストラクター
IDBVersionChangeEvent()-
データベースのバージョンが変更されたことを表す新しい
IDBVersionChangeEventオブジェクトを作成して返します。
インスタンスプロパティ
親の Event インターフェイスからもプロパティを継承します。
IDBVersionChangeEvent.oldVersion読取専用-
データベースの古いバージョンを返します。
IDBVersionChangeEvent.newVersion読取専用-
データベースの新しいバージョンを返します。
インスタンスメソッド
固有のメソッドはありませんが、親の Event インターフェイスからメソッドを継承します。
例
以下のコードスニペットでは、データベースを開く要求をし、成功した場合と失敗した場合用のハンドラーを用意します。バージョンが変更された時 (upgradeneeded イベントの後)、success イベントは IDBVersionChangeEvent インターフェイスを実装します。動く例全体は、To-do Notifications アプリケーションを参照してください。(動く例を見る)
仕様書
| Specification |
|---|
| Indexed Database API 3.0 # events |
ブラウザーの互換性
関連情報
- IndexedDB の使用
- トランザクションの開始:
IDBDatabase - トランザクションの使用:
IDBTransaction - キーの範囲の設定:
IDBKeyRange - データの取得と変更:
IDBObjectStore - カーソルの使用:
IDBCursor - リファレンス例: To-do Notifications (動く例を見る)