IDBIndex: getAllKeys() 方法

語法

getAllKeys()
getAllKeys(query)
getAllKeys(query, count)

引數

query 可選

要檢索的鍵或 IDBKeyRange。如果此值為空或缺失，瀏覽器將使用無邊界鍵範圍。

count 可選

要返回的記錄數。如果此值超過查詢中的記錄數，瀏覽器將僅檢索第一項。如果它低於 0 或大於 2^32 - 1，將丟擲 TypeError 異常。

返回值

一個 IDBRequest 物件，後續與此操作相關的事件會在此物件上觸發。

如果操作成功，請求的 result 屬性的值將是一個 Array，其中包含所有匹配給定查詢的記錄的鍵，最多可達 count 值（如果提供了 count）。

異常

此方法可能會引發以下型別的 DOMException

TransactionInactiveError DOMException

如果此 IDBIndex 的事務處於非活動狀態，則會丟擲此異常。

InvalidStateError DOMException

如果 IDBIndex 已被刪除或移除，則會丟擲此異常。

如果 count 引數不是介於 0 和 2^32 - 1 之間（包含），則會丟擲 TypeError 異常。

示例

const myIndex = objectStore.index("index");
const getAllKeysRequest = myIndex.getAllKeys();
getAllKeysRequest.onsuccess = () => {
  console.log(getAllKeysRequest.result);
};

規範

瀏覽器相容性

另見

• 使用 IndexedDB
• 開始事務：IDBDatabase
• 使用事務：IDBTransaction
• 設定鍵的範圍：IDBKeyRange
• 檢索和修改資料：IDBObjectStore
• 使用遊標：IDBCursor
• 參考示例：待辦事項通知（檢視即時示例）。