IDBRequest

Instance properties

Also inherits properties from EventTarget.

IDBRequest.error Read only

Returns a DOMException in the event of an unsuccessful request, indicating what went wrong.

IDBRequest.result Read only

Returns the result of the request. If the request is not completed, the result is not available and an InvalidStateError exception is thrown.

IDBRequest.source Read only

The source of the request, such as an IDBIndex or an IDBObjectStore. If no source exists (such as when calling IDBFactory.open), it returns null.

IDBRequest.readyState Read only

The state of the request. Every request starts in the pending state. The state changes to done when the request completes successfully or when an error occurs.

IDBRequest.transaction Read only

The transaction for the request. This property can be null for certain requests, for example those returned from IDBFactory.open unless an upgrade is needed. (You're just connecting to a database, so there is no transaction to return).

Instance methods

No methods, but inherits methods from EventTarget.

Events

Listen to these events using addEventListener() or by assigning an event listener to the oneventname property of this interface.

error

Fired when an error caused a request to fail.

success

Fired when an IDBRequest succeeds.

Example

In the following code snippet, we open a database asynchronously and make a request; onerror and onsuccess functions are included to handle the success and error cases. For a full working example, see our To-do Notifications app (view example live.)

let db;

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

// these two event handlers act on the database being
// opened successfully, or not
DBOpenRequest.onerror = (event) => {
  note.appendChild(document.createElement("li")).textContent =
    "Error loading database.";
};

DBOpenRequest.onsuccess = (event) => {
  note.appendChild(document.createElement("li")).textContent =
    "Database initialized.";

  // store the result of opening the database.
  db = DBOpenRequest.result;
};

Specifications

Browser compatibility

See also

• Using IndexedDB
• Starting transactions: IDBDatabase
• Using transactions: IDBTransaction
• Setting a range of keys: IDBKeyRange
• Retrieving and making changes to your data: IDBObjectStore
• Using cursors: IDBCursor
• Reference example: To-do Notifications (View the example live).