IDBDatabase.onerror

The onerror event handler of the IDBDatabase interface handles the error event, fired when access to the database fails.

Note: This feature is available in Web Workers.

SyntaxEdit

db.onerror = function() { ... }

ExampleEdit

This example shows an IDBOpenDBRequest.onupgradeneeded block that creates a new object store; it also includes onerror and onabort functions to handle non-success cases.

DBOpenRequest.onupgradeneeded = function(event) {
  var db = event.target.result;
    
  db.onerror = function(event) {
    note.innerHTML += '<li>Error opening database.</li>';
  };

  db.onabort = function(event) {
    note.innerHTML += '<li>Database opening aborted!</li>';
  };

  // Create an objectStore for this database
    
  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>';
};

SpecificationsEdit

Specification Status Comment
Indexed Database API
The definition of 'onerror' in that specification.
Editor's Draft  

Browser compatibilityEdit

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

See alsoEdit

Document Tags and Contributors

 Contributors to this page: jpmedley, chrisdavidmills, fscholz
 Last updated by: jpmedley,