The abort
event is fired on IDBDatabase
when a transaction is aborted and bubbles up to the connection object.
Bubbles | Yes |
Cancelable | No |
Interface | Event
|
Event handler property | onabort
|
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;
// Create an objectStore for this database
const 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;
db.addEventListener('abort', () => {
console.log('Transaction aborted');
});
// open a read/write db transaction, ready for adding the data
const transaction = db.transaction(['toDoList'], 'readwrite');
// 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;
// Create an objectStore for this database
const 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;
db.onabort = () => {
console.log('Transaction aborted');
};
// open a read/write db transaction, ready for adding the data
const transaction = db.transaction(['toDoList'], 'readwrite');
// 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.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
abort event
|
Chrome Full support 24 Full support 24 No support 23 — 24 Prefixed' Implemented with the vendor prefix: webkit |
Edge
Full support 12 |
Firefox Full support 16 Full support 16 No support 10 — 16 Prefixed' Implemented with the vendor prefix: moz |
IE
Partial support 10 |
Opera
Full support 15 |
Safari
Full support 7 |
WebView Android
Full support Yes |
Chrome Android
Full support 25 |
Firefox Android
Full support 22 |
Opera Android
Full support 14 |
Safari iOS
Full support 8 |
Samsung Internet Android
Full support 1.5 |
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
IDBDatabase: abort event by Mozilla Contributors is licensed under CC-BY-SA 2.5.