dom / latest / idbfactory.html /

IDBFactory

The IDBFactory interface of the IndexedDB API lets applications asynchronously access the indexed databases. The object that implements the interface is window.indexedDB. You open — that is, create and access — and delete a database with this object, and not directly with IDBFactory.

Note: This feature is available in Web Workers

Methods

IDBFactory.open

The current method to request opening a connection to a database.

IDBFactory.deleteDatabase

A method to request the deletion of a database.

IDBFactory.cmp

A method that compares two keys and returns a result indicating which one is greater in value.

IDBFactory.databases

A method that returns a list of all available databases, including their names and versions.

Example

In the following code snippet, we make a request to open a database, and include handlers for the success and error cases. For a full working example, see our To-do Notifications app (view example live.)

// In the following line, you should include the prefixes of implementations you want to test.
window.indexedDB = window.indexedDB || window.mozIndexedDB || window.webkitIndexedDB || window.msIndexedDB;
// DON'T use "var indexedDB = ..." if you're not in a function.
// Moreover, you may need references to some window.IDB* objects:
window.IDBTransaction = window.IDBTransaction || window.webkitIDBTransaction || window.msIDBTransaction;
window.IDBKeyRange = window.IDBKeyRange || window.webkitIDBKeyRange || window.msIDBKeyRange;
// (Mozilla has never prefixed these objects, so we don't need window.mozIDB*)

// Let us open version 4 of our database
var DBOpenRequest = window.indexedDB.open("toDoList", 4);

// these two event handlers act on the database being opened successfully, or not
DBOpenRequest.onerror = function(event) {
  console.error("Error loading database.");
};

DBOpenRequest.onsuccess = function(event) {
  console.info("Database initialized.");

  // store the result of opening the database in the db variable. This is used a lot later on, for opening transactions and suchlike.
  db = DBOpenRequest.result;
};

Specifications

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
IDBFactory
24
23-57
12
16
10-16
10
15
7
≤37-57
4.4
25
25-57
22
14
8
1.5
1.5-7.0
cmp
23
12
10
10
15
7
4.4
25
22
14
8
1.5
databases
71
79
No
See bug 934640.
No
58
14
71
71
No
See bug 934640.
50
14
10.0
deleteDatabase
23
12
10
10
15
7
4.4
25
22
14
8
1.5
open
23
12
10
10
15
7
4.4
25
22
14
8
1.5
worker_support
23
12
37
10
15
10
≤37
25
37
14
10
1.5

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IDBFactory