IDBFactory: deleteDatabase()-Methode

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.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die deleteDatabase()-Methode der IDBFactory-Schnittstelle fordert die Löschung einer Datenbank an. Die Methode gibt sofort ein IDBOpenDBRequest-Objekt zurück und führt die Löschoperation asynchron durch.

Wenn die Datenbank erfolgreich gelöscht wird, wird ein success-Event auf dem von dieser Methode zurückgegebenen Anforderungsobjekt ausgelöst, wobei das result auf undefined gesetzt ist. Tritt ein Fehler bei der Löschung der Datenbank auf, so wird ein error-Event auf dem von dieser Methode zurückgegebenen Anforderungsobjekt ausgelöst.

Wenn deleteDatabase() aufgerufen wird, erhalten alle anderen offenen Verbindungen zu dieser spezifischen Datenbank ein versionchange-Event.

Syntax

js
// For the current standard:
deleteDatabase(name)

// For the experimental version with `options` (see below):
deleteDatabase(name)
deleteDatabase(name, options)

Parameter

name

Der Name der Datenbank, die Sie löschen möchten. Beachten Sie, dass der Versuch, eine nicht vorhandene Datenbank zu löschen, keine Ausnahme auslöst, im Gegensatz zu IDBDatabase.deleteObjectStore(), das eine Ausnahme auslöst, wenn der benannte Objekt-Store nicht existiert.

options Optional

In Gecko, seit Version 26, können Sie einen nicht standardmäßigen optionalen Speicherparameter einschließen, der angibt, ob Sie eine permanent (der Standardwert) IndexedDB oder eine IndexedDB im temporary-Speicher (auch bekannt als Shared Pool) löschen möchten.

Rückgabewert

Ein IDBOpenDBRequest, bei dem nachfolgende Ereignisse im Zusammenhang mit dieser Anfrage ausgelöst werden.

Wenn die Operation erfolgreich ist, ist der Wert der result-Eigenschaft der Anfrage null.

Beispiele

js
const DBDeleteRequest = window.indexedDB.deleteDatabase("toDoList");

DBDeleteRequest.onerror = (event) => {
  console.error("Error deleting database.");
};

DBDeleteRequest.onsuccess = (event) => {
  console.log("Database deleted successfully");

  console.log(event.result); // should be undefined
};

Spezifikationen

Specification
Indexed Database API 3.0
# ref-for-dom-idbfactory-deletedatabase①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch