IDBFactory: cmp() 方法

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

注意:此功能在 Web Workers 中可用。

IDBFactory 介面的 cmp() 方法用於比較兩個值作為鍵,以確定它們在 IndexedDB 操作(例如儲存和迭代)中的相等性和順序。

注意:請勿將此方法用於比較任意 JavaScript 值,因為許多 JavaScript 值要麼不是有效的 IndexedDB 鍵(例如布林值和物件),要麼被視為等效的 IndexedDB 鍵(例如,由於 IndexedDB 會忽略具有非數字屬性的陣列並將其視為空陣列,因此任何非數字陣列都被視為等效)。如果任一值不是有效鍵,則會丟擲異常。

語法

js
cmp(first, second)

引數

first

要比較的第一個鍵。

要比較的第二個鍵。

返回值

一個整數,指示比較結果;下表列出了可能的值及其含義

返回值 描述
-1 第一個鍵小於第二個鍵
0 第一個鍵等於第二個鍵
1 第一個鍵大於第二個鍵

異常

DataError DOMException

如果提供的鍵中有一個不是有效鍵,則丟擲此異常。

示例

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①

瀏覽器相容性

另見