IDBFactory: cmp() 方法
注意:此功能在 Web Workers 中可用。
IDBFactory 介面的 cmp() 方法用於比較兩個值作為鍵,以確定它們在 IndexedDB 操作(例如儲存和迭代)中的相等性和順序。
注意:請勿將此方法用於比較任意 JavaScript 值,因為許多 JavaScript 值要麼不是有效的 IndexedDB 鍵(例如布林值和物件),要麼被視為等效的 IndexedDB 鍵(例如,由於 IndexedDB 會忽略具有非數字屬性的陣列並將其視為空陣列,因此任何非數字陣列都被視為等效)。如果任一值不是有效鍵,則會丟擲異常。
語法
js
cmp(first, second)
引數
返回值
一個整數,指示比較結果;下表列出了可能的值及其含義
| 返回值 | 描述 |
|---|---|
| -1 | 第一個鍵小於第二個鍵 |
| 0 | 第一個鍵等於第二個鍵 |
| 1 | 第一個鍵大於第二個鍵 |
異常
DataErrorDOMException-
如果提供的鍵中有一個不是有效鍵,則丟擲此異常。
示例
js
const a = 1;
const b = 2;
const result = window.indexedDB.cmp(a, b);
console.log(`Comparison results: ${result}`);
規範
| 規範 |
|---|
| Indexed Database API 3.0 # ref-for-dom-idbfactory-cmp① |
瀏覽器相容性
載入中…
另見
- 使用 IndexedDB
- 開始事務:
IDBDatabase - 使用事務:
IDBTransaction - 設定鍵的範圍:
IDBKeyRange - 檢索和修改資料:
IDBObjectStore - 使用遊標:
IDBCursor - 參考示例:待辦事項通知(檢視即時示例)。