The abort
event is fired when an IndexedDB
transaction is aborted.
Bubbles | Yes |
---|---|
Cancelable | No |
Interface | Event |
Event handler property | onabort |
This can happen for any of the following reasons:
- bad requests, (for example, trying to add the same key twice, or put the same index key when the key has a uniqueness constraint),
- an explicit
abort()
call - an uncaught exception in the request's success/error handler,
- an I/O error (an actual failure to write to disk, for example disk detached, or other OS/hardware failure)
- quota exceeded.
Examples
This example opens a database (creating the database if it does not exist), then opens a transaction, adds a listener to the abort
event, then aborts the transaction to trigger the event.
// Open the database const DBOpenRequest = window.indexedDB.open('toDoList', 4); DBOpenRequest.onupgradeneeded = event => { const db = event.target.result; db.onerror = () => { console.log('Error creating database'); }; // 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 }); }; DBOpenRequest.onsuccess = event => { const db = DBOpenRequest.result; // open a read/write db transaction, ready for adding the data const transaction = db.transaction(['toDoList'], 'readwrite'); // add a listener for `abort` transaction.addEventListener('abort', () => { console.log('Transaction was aborted'); }); // abort the transaction transaction.abort(); };
The same example, but assigning the event handler to the onabort
property:
// Open the database const DBOpenRequest = window.indexedDB.open('toDoList', 4); DBOpenRequest.onupgradeneeded = event => { const db = event.target.result; db.onerror = () => { console.log('Error creating database'); }; // 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 }); }; DBOpenRequest.onsuccess = event => { const db = DBOpenRequest.result; // open a read/write db transaction, ready for adding the data const transaction = db.transaction(['toDoList'], 'readwrite'); // add a listener for `abort` transaction.onabort = (event) => { console.log('Transaction was aborted'); }; // abort the transaction transaction.abort(); };
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
abort event | Chrome
Full support
24
| Edge Full support 12 | Firefox
Full support
16
| IE Partial support 10 | Opera Full support 15 | Safari Full support 7 | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support 22 | Opera Android Full support 14 | Safari iOS Full support 8 | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
- Partial support
- Partial support
- Requires a vendor prefix or different name for use.
- Requires a vendor prefix or different name for use.
See also
- Using IndexedDB
onabort
event handler property