IDBDatabase: close() メソッド
close()
は IDBDatabase
インターフェイスのメソッドで、ただちに戻り、別スレッドで接続を閉じます。
実際には、この接続を使用していて生成されたすべてのトランザクションが完了するまで、接続は閉じられません。一度このメソッドが呼び出されたら、この接続では、新しいトランザクションを生成することはできません。終了処理がペンディングされている場合は、トランザクションを生成するメソッドは、例外を発生させます。
メモ: この機能はウェブワーカー内で利用可能です。
構文
js
close()
引数
なし。
返値
なし。
例
js
// データベースを開く
const DBOpenRequest = window.indexedDB.open("toDoList", 4);
// これら 2 個のイベントハンドラーは、データベースが正常に開かれたか、失敗した時に動作します。
DBOpenRequest.onerror = (event) => {
note.innerHTML += "<li>データベースの読み込みに失敗しました。</li>";
};
DBOpenRequest.onsuccess = (event) => {
note.innerHTML += "<li>データベースを初期化しました。</li>";
// データベースを開いた結果を変数 db に保存します。
db = DBOpenRequest.result;
// さあ、データベースを再び閉じましょう!
db.close();
};
仕様書
Specification |
---|
Indexed Database API 3.0 # ref-for-dom-idbdatabase-close② |
ブラウザーの互換性
BCD tables only load in the browser
関連項目
- IndexedDB の使用
- トランザクションの開始 :
IDBDatabase
- トランザクションの使用 :
IDBTransaction
- キーの範囲の設定 :
IDBKeyRange
- データの取得と変更 :
IDBObjectStore
- カーソルの使用 :
IDBCursor
- リファレンス例 : To-do Notifications (動く例を見る)