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①

浏览器兼容性

另见