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.

La méthode close() de l'interface IDBDatabase ferme de façon asynchrone la connexion à la base de donnée.

La connexion sera fermée lorsque toutes les transactions liées à cette connexion seront terminées. En revanche, on ne pourra pas démarrer de nouvelles transactions sur la connexion une fois que cette méthode a été appelée. Les méthodes qui initialisent des transactions déclencheront une exception lorsque la fermeture est en cours.

Note : Cette fonctionnalité est disponible via les Web Workers.

Syntaxe

js
db.close();

Valeur de retour

Aucune.

Exemple

js
// ouverture de la connexion à la base de données toDoList
var DBOpenRequest = window.indexedDB.open("toDoList", 4);

// deux gestionnaires d’événements effectuant les
// opérations après que l'ouverture se soit bien
// passée ou non.
DBOpenRequest.onerror = function (event) {
  note.innerHTML += "<li>Erreur lors du chargement de la base.</li>";
};

DBOpenRequest.onsuccess = function (event) {
  note.innerHTML += "<li>Base chargée.</li>";

  // affecte la connexion à la variable db
  db = DBOpenRequest.result;

  // fermeture de la base de donnée.
  db.close();
};

Spécifications

Specification
Indexed Database API 3.0
# ref-for-dom-idbdatabase-close②

Compatibilité des navigateurs

BCD tables only load in the browser

Voir aussi