IDBIndex.getAllKeys()
The getAllKeys() method of the IDBIndex interface instantly 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
IDBKeyRangeidentifying 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
0or greater than2^32 - 1aTypeErrorexception 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:
| Exception | Description |
|---|---|
TransactionInactiveError | This IDBIndex's transaction is inactive. |
InvalidStateError | 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
Browser compatibility
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
getAllKeys |
48 |
≤18 |
44 |
No |
35 |
10.1 |
48 |
48 |
44 |
35 |
10.3 |
5.0 |
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.)
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/IDBIndex/getAllKeys