IDBTransaction: complete-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Das complete-Ereignis der IndexedDB API wird ausgelöst, wenn die Transaktion erfolgreich übernommen wurde. Dies geschieht entweder, nachdem Sie IDBTransaction.commit() explizit aufgerufen haben, oder wenn alle Anfragen erfolgreich abgeschlossen wurden und nach der Verarbeitung ihrer Ergebnisse keine neuen Anfragen gestellt wurden. Weitere Informationen finden Sie unter IDBTransaction.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
js
addEventListener("complete", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
js
oncomplete = (event) => { }
Ereignistyp
Ein generisches Event.
Beispiele
Verwendung von addEventListener():
js
// Open the database
const DBOpenRequest = window.indexedDB.open("toDoList", 4);
DBOpenRequest.onupgradeneeded = (event) => {
const db = event.target.result;
db.onerror = () => {
console.log("Error creating database");
};
// Create an objectStore for this database
const objectStore = db.createObjectStore("toDoList", {
keyPath: "taskTitle",
});
// define what data items the objectStore will contain
objectStore.createIndex("hours", "hours", { unique: false });
objectStore.createIndex("minutes", "minutes", { unique: false });
objectStore.createIndex("day", "day", { unique: false });
objectStore.createIndex("month", "month", { unique: false });
objectStore.createIndex("year", "year", { unique: false });
};
DBOpenRequest.onsuccess = (event) => {
const db = DBOpenRequest.result;
// open a read/write db transaction, ready for adding the data
const transaction = db.transaction(["toDoList"], "readwrite");
// add a listener for `complete`
transaction.addEventListener("complete", (event) => {
console.log("Transaction was completed");
});
const objectStore = transaction.objectStore("toDoList");
const newItem = {
taskTitle: "my task",
hours: 10,
minutes: 10,
day: 10,
month: "January",
year: 2019,
};
const objectStoreRequest = objectStore.add(newItem);
objectStoreRequest.onsuccess = () => {
// Issue a second request in the onsuccess handler,
// so we can run this request after the first one completes,
// while still reusing the same transaction
const getAllRequest = objectStore.getAll();
getAllRequest.onsuccess = () => {
// No more requests, so the transaction completes after running this handler
console.log(getAllRequest.result);
};
};
};
Spezifikationen
| Spezifikation |
|---|
| Indexed Database API 3.0 # eventdef-idbtransaction-complete |