The name
property of the IDBObjectStore
interface indicates the name of this object store.
Note: This feature is available in Web Workers
The name
property of the IDBObjectStore
interface indicates the name of this object store.
Note: This feature is available in Web Workers
A string containing the object store's name.
There are a several exceptions that can occur when you attempt to change an object store's name.
InvalidStateError
DOMException
Thrown if either the object store has been deleted or the current transaction is not an upgrade transaction; you can only rename indexes during upgrade transactions; that is, when the mode is versionchange
.
TransactionInactiveError
DOMException
Thrown if the current transaction is not active.
ConstraintError
DOMException
Thrown if an object store is already using the specified name
.
In the following code snippet, we open a read/write transaction on our database and add some data to an object store using add()
. After the object store has been created, we log objectStore.name
to the console. For a full working example, see our To-do Notifications app (>view example live).
js
// Let us open our database const DBOpenRequest = window.indexedDB.open("toDoList", 4); DBOpenRequest.onsuccess = (event) => { note.innerHTML += "<li>Database initialized.</li>"; // store the result of opening the database in the db variable. // This is used a lot below db = DBOpenRequest.result; // Run the addData() function to add the data to the database addData(); }; function addData() { // Create a new object ready to insert into the IDB const newItem = [ { taskTitle: "Walk dog", hours: 19, minutes: 30, day: 24, month: "December", year: 2013, notified: "no", }, ]; // open a read/write db transaction, ready for adding the data const transaction = db.transaction(["toDoList"], "readwrite"); // report on the success of the transaction completing, when everything is done transaction.oncomplete = (event) => { note.innerHTML += "<li>Transaction completed.</li>"; }; transaction.onerror = (event) => { note.innerHTML += "<li>Transaction not opened due to error. Duplicate items not allowed.</li>"; }; // create an object store on the transaction const objectStore = transaction.objectStore("toDoList"); console.log(objectStore.name); // Make a request to add our newItem object to the object store const objectStoreRequest = objectStore.add(newItem[0]); objectStoreRequest.onsuccess = (event) => { // report the success of our request note.innerHTML += "<li>Request successful.</li>"; }; }
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
name |
23 | 12 | 10 | 10 | 15 | 8 | 4.4 | 25 | 22 | 14 | 8 | 1.5 |
renaming_through_name_setter |
55 | ≤18 | 49 | No | 42 | 10.1 | 55 | 55 | 49 | 42 | 10.3 | 6.0 |
IDBDatabase
IDBTransaction
IDBKeyRange
IDBObjectStore
IDBCursor
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IDBObjectStore/name