IDBDatabase: close() メソッド

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.

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

関連項目