IDBObjectStore: clear() Methode
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die clear()
-Methode der IDBObjectStore
-Schnittstelle erstellt und gibt sofort ein IDBRequest
-Objekt zurück und leert diesen Objekt-Speicher in einem separaten Thread. Dies dient dazu, alle aktuellen Daten aus einem Objekt-Speicher zu löschen.
Das Leeren eines Objekt-Speichers besteht darin, alle Datensätze aus dem Objekt-Speicher zu entfernen und alle Datensätze in Indizes zu entfernen, die auf den Objekt-Speicher verweisen. Um nur einige der Datensätze in einem Speicher zu entfernen, verwenden Sie IDBObjectStore.delete
, indem Sie einen Schlüssel oder IDBKeyRange
übergeben.
Syntax
clear()
Parameter
Keine.
Rückgabewert
Ein IDBRequest
-Objekt, auf dem nachfolgende Ereignisse im Zusammenhang mit dieser Operation ausgelöst werden.
Wenn die Operation erfolgreich ist, ist der Wert der result
-Eigenschaft der Anfrage undefined
.
Ausnahmen
ReadOnlyError
DOMException
-
Wird ausgelöst, wenn die mit dieser Operation verknüpfte Transaktion im Nur-Lese-Modus ist.
TransactionInactiveError
DOMException
-
Wird ausgelöst, wenn die Transaktion dieses
IDBObjectStore
inaktiv ist.
Beispiele
Im folgenden Code-Snippet öffnen wir eine Lese-/Schreib-Transaktion auf unserer Datenbank und leeren mit clear()
alle aktuellen Daten aus dem Objekt-Speicher. Für ein vollständiges, funktionierendes Beispiel siehe unsere To-do Notifications App (Live-Beispiel ansehen).
// Let us open our database
const DBOpenRequest = window.indexedDB.open("toDoList", 4);
DBOpenRequest.onsuccess = (event) => {
note.appendChild(document.createElement("li")).textContent =
"Database initialized.";
// store the result of opening the database in the db variable.
// This is used a lot below
db = DBOpenRequest.result;
// Clear all the data from the object store
clearData();
};
function clearData() {
// open a read/write db transaction, ready for clearing the data
const transaction = db.transaction(["toDoList"], "readwrite");
// report on the success of the transaction completing, when everything is done
transaction.oncomplete = (event) => {
note.appendChild(document.createElement("li")).textContent =
"Transaction completed.";
};
transaction.onerror = (event) => {
note.appendChild(document.createElement("li")).textContent =
`Transaction not opened due to error: ${transaction.error}`;
};
// create an object store on the transaction
const objectStore = transaction.objectStore("toDoList");
// Make a request to clear all the data out of the object store
const objectStoreRequest = objectStore.clear();
objectStoreRequest.onsuccess = (event) => {
// report the success of our request
note.appendChild(document.createElement("li")).textContent =
"Request successful.";
};
}
Spezifikationen
Specification |
---|
Indexed Database API 3.0 # ref-for-dom-idbobjectstore-clear③ |
Browser-Kompatibilität
BCD tables only load in the browser
Siehe auch
- IndexedDB verwenden
- Transaktionen starten:
IDBDatabase
- Transaktionen verwenden:
IDBTransaction
- Einen Schlüsselbereich setzen:
IDBKeyRange
- Ihre Daten abrufen und ändern:
IDBObjectStore
- Cursor verwenden:
IDBCursor
- Referenzbeispiel: To-do Notifications (Live-Beispiel ansehen).