IDBDatabase

IDBDatabase interface of the IndexedDB API provides a connection to a database ; you can use an IDBDatabase object to open a transaction on your database then create, manipulate, and delete objects (data) in that database. The interface provides the only way to get and manage versions of the database.

注意: 此特征可用于 Web 工作者 .

注意 : Everything you do in IndexedDB always happens in the context of a transaction , representing interactions with data in the database. All objects in IndexedDB — including object stores, indexes, and cursors — are tied to a particular transaction. Thus, you cannot execute commands, access data, or open anything outside of a transaction.

特性

IDBDatabase.name 只读
A DOMString that contains the name of the connected database.
IDBDatabase.version 只读
A 64-bit integer that contains the version of the connected database. When a database is first created, this attribute is an empty string.
IDBDatabase.objectStoreNames 只读
A DOMStringList that contains a list of the names of the object stores currently in the connected database.

方法

Inherits from: EventTarget

IDBDatabase.close()
Returns immediately and closes the connection to a database in a separate thread.
IDBDatabase.createMutableFile()
Creates a file handle, allowing files to be stored inside an IndexedDB database.
IDBDatabase.createObjectStore()
Creates and returns a new object store or index.
IDBDatabase.deleteObjectStore()
Destroys the object store with the given name in the connected database, along with any indexes that reference it.
IDBDatabase.transaction()
Immediately returns a transaction object ( IDBTransaction ) containing the IDBTransaction.objectStore method, which you can use to access your object store. Runs in a separate thread.

Events

监听这些事件使用 addEventListener() 或通过把事件监听器赋值给 on eventname 特性为此接口。

abort
Fired when when a transaction is aborted and bubbles up to the connection object. Also available via the onabort 特性。
close
Fired when the database connection is unexpectedly closed. Also available via the onclose 特性。
error
Fired when a request returns an error and the event bubbles up to the connection object. Also available via the onerror 特性。
versionchange
Fired when a database structure change was requested. Also available via the onversionchange 特性。

范例

In the following code snippet, we open a database asynchronously ( IDBFactory ), handle success and error cases, and create a new object store in the case that an upgrade is needed ( IDBdatabase ). For a complete working example, see our To-do Notifications app ( view example live .)

// Let us open our database
var DBOpenRequest = window.indexedDB.open("toDoList", 4);
// these two event handlers act on the IDBDatabase object,
// when the database is opened successfully, or not
DBOpenRequest.onerror = function(event) {
  note.innerHTML += '<li>Error loading database.</li>';
};
DBOpenRequest.onsuccess = function(event) {
  note.innerHTML += '<li>Database initialised.</li>';
  // store the result of opening the database in the db
  // variable. This is used a lot later on
  db = DBOpenRequest.result;
  // Run the displayData() function to populate the task
  // list with all the to-do list data already in the IDB
  displayData();
};
// This event handles the event whereby a new version of
// the database needs to be created Either one has not
// been created before, or a new version number has been
// submitted via the window.indexedDB.open line above
DBOpenRequest.onupgradeneeded = function(event) {
  var db = event.target.result;
  db.onerror = function(event) {
    note.innerHTML += '<li>Error loading database.</li>';
  };
  // Create an objectStore for this database using
  // IDBDatabase.createObjectStore
  var 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 });
  objectStore.createIndex("notified", "notified", { unique: false });
  note.innerHTML += '<li>Object store created.</li>';
};
					

This next line opens up a transaction on the Database, then opens an object store that we can then manipulate the data inside of.

var objectStore = db.transaction('toDoList', 'readwrite').objectStore('toDoList');
					

规范

规范 状态 Comment
Indexed Database API 2.0
The definition of 'IDBDatabase' in that specification.
Recommendation Initial version
Indexed Database API Draft
The definition of 'IDBDatabase' in that specification.
Recommendation

浏览器兼容性

更新 GitHub 上的兼容性数据
Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
IDBDatabase Chrome 24
24
不支持 23 — 57
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes
Yes
不支持 ? — 57
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Chrome Android 25
25
不支持 25 — 57
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
1.5
不支持 1.5 — 7.0
Prefixed
Prefixed Implemented with the vendor prefix: webkit
abort event Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
close Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
close event Chrome 31 Edge ≤18 Firefox 50 IE ? Opera Yes Safari 10.1 WebView Android Yes Chrome Android 31 Firefox Android 50 Opera Android Yes Safari iOS 10.3 Samsung Internet Android 2.0
createObjectStore Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
deleteObjectStore Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
error event Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
name Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
objectStoreNames Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
onabort Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
onclose Chrome 31
31
注意事项
注意事项 approx
Edge ≤18 Firefox 50 IE ? Opera Yes Safari 10.1 WebView Android Yes Chrome Android 31 Firefox Android 50 Opera Android Yes Safari iOS 10.3 Samsung Internet Android 2.0
onerror Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
onversionchange Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
transaction Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
version Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
versionchange event Chrome 24
24
不支持 23 — 24
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge 12 Firefox 16
16
不支持 10 — 16
Prefixed
Prefixed Implemented with the vendor prefix: moz
IE 部分支持 10 Opera 15 Safari 7 WebView Android Yes Chrome Android 25 Firefox Android 22 Opera Android 14 Safari iOS 8 Samsung Internet Android 1.5
Available in workers Chrome Yes
Yes
不支持 23 — 57
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Edge ≤18 Firefox 37 IE ? Opera Yes Safari ? WebView Android Yes
Yes
不支持 ? — 57
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Chrome Android Yes
Yes
不支持 25 — 57
Prefixed
Prefixed Implemented with the vendor prefix: webkit
Firefox Android 37 Opera Android Yes Safari iOS ? Samsung Internet Android Yes
Yes
不支持 1.5 — 7.0
Prefixed
Prefixed Implemented with the vendor prefix: webkit

图例

完整支持
完整支持
部分支持
部分支持
兼容性未知
兼容性未知
见实现注意事项。
见实现注意事项。
要求使用供应商前缀或不同名称。
要求使用供应商前缀或不同名称。

另请参阅