IDBIndex.getAllKeys()
The getAllKeys()
method of the IDBIndex
interface asynchronously retrieves the primary keys of all objects inside the index,
setting them as the result
of the request object.
Syntax
var allKeysRequest = IDBIndex.getAllKeys();
var allKeysRequest = IDBIndex.getAllKeys(query);
var allKeysRequest = IDBIndex.getAllKeys(query, count);
Parameters
- query Optional
-
A key or an
IDBKeyRange
identifying the keys to retrieve. If this value is null or missing, the browser will use an unbound key range. - count Optional
-
The number records to return. If this value exceeds the number of records in the query, the browser will only retrieve the first item. If it is lower than
0
or greater than2^32 - 1
aTypeError
exception will be thrown.
Return value
An IDBRequest
object on which subsequent events related to this
operation are fired.
Exceptions
This method may raise a DOMException
of the following types:
TransactionInactiveError
DOMException
-
Thrown if this
IDBIndex
's transaction is inactive. InvalidStateError
DOMException
-
Thrown if the
IDBIndex
has been deleted or removed.
A TypeError
exception is thrown if the count
parameter is
not between 0
and 2^32 - 1
included.
Example
var myIndex = objectStore.index('index');
var getAllKeysRequest = myIndex.getAllKeys();
getAllKeysRequest.onsuccess = function() {
console.log(getAllKeysRequest.result);
}
Specifications
Specification |
---|
Indexed Database API 3.0 # ref-for-dom-idbindex-getallkeysâ |
Browser compatibility
BCD tables only load in the browser
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 example live.)