IDBDatabase.deleteObjectStore()

In This Article

The deleteObjectStore() method of the IDBDatabase interface destroys the object store with the given name in the connected database, along with any indexes that reference it.

As with IDBDatabase.createObjectStore, this method can be called only within a versionchange transaction.

Note: This feature is available in Web Workers.

Syntax

dbInstance.deleteObjectStore(name);

Parameters

name: The name of the object store you want to delete.

Return value

Void.

Exceptions

This method may raise a DOMException of one of the following types:

Exception	Description
`InvalidStateError`	Occurs if the method was not called from a `versionchange` transaction callback. For older WebKit browsers, you must call `IDBDatabase` Properties `name` `objectStoreNames` `onabort` `onclose` `onerror` `onversionchange` `version` Methods `close()` `createObjectStore()` `deleteObjectStore()` `transaction()` Inheritance: `EventTarget` first.
`TransactionInactiveError`	Occurs if a request is made on a source database that doesn't exist (e.g. has been deleted or removed.) In Firefox previous to version 41, an `InvalidStateError` was raised in this case as well, which was misleading; this has now been fixed (see bug 1176165.)
`NotFoundError`	You are trying to delete an object store that does not exist. Names are case sensitive.

Example

var dbName = "sampleDB";
var dbVersion = 2;
var request = indexedDB.open(dbName, dbVersion);
request.onupgradeneeded = function(e) {
  var db = request.result;
  if (e.oldVersion < 1) {
    db.createObjectStore("store1");
  }
  if (e.oldVersion < 2) {
    db.deleteObjectStore("store1");
    db.createObjectStore("store2");
  }
  // etc. for version < 3, 4...
};

Specification

Specification	Status	Comment
Indexed Database API The definition of 'deleteObjectStore()' in that specification.	Recommendation
Indexed Database API 2.0 The definition of 'deleteObjectStore()' in that specification.	Editor's Draft

Feature	Chrome	Edge	Firefox (Gecko)	Internet Explorer	Opera	Safari (WebKit)
Basic support	23webkit 24	(Yes)	10 moz 16.0 (16.0)	10, partial	15	7.1
Available in workers	(Yes)	?	37.0 (37.0)	?	(Yes)	?
Indexed Database 2.0	58	?	?	?	45	?

Feature	Android Webview	Chrome for Android	Edge	Firefox Mobile (Gecko)	Firefox OS	IE Phone	Opera Mobile	Safari Mobile
Basic support	(Yes)	(Yes)	(Yes)	22.0 (22.0)	1.0.1	10	22	8
Available in workers	(Yes)	(Yes)	?	37.0 (37.0)	(Yes)	?	(Yes)	?
Indexed Database 2.0	58	58	?	?	?	?	45	?

Document Tags and Contributors

Tags:

Contributors to this page: jpmedley, chrisdavidmills, libbymc, inexorabletash, chrahunt, fscholz

Last updated by: jpmedley, Jun 7, 2017, 8:17:30 AM