IDBFactory: cmp() 方法

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

cmp()IDBFactory 接口的方法,用于将两个值作为键进行比较,以确定 IndexedDB 操作(如存储和迭代)的相等性和排序。

注意:不要使用此方法比较任意 JavaScript 值,因为许多 JavaScript 值要么不是有效的 IndexedDB 键(例如布尔值和对象),要么被视为等效的 IndexedDB 键(例如,由于 IndexedDB 忽略具有非数字属性的数组并将它们视为空数组,因此任何非数字数组都被视为等效)。如果其中一个值不是有效键,则会抛出异常。

语法

js
cmp(first, second)

参数

first

要比较的第一个键。

second

要比较的第二个键。

返回值

一个整数,指示比较结果;下表列出了可能的值及其含义

返回值 描述
-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①

浏览器兼容性

BCD 表格仅在启用 JavaScript 的浏览器中加载。

另请参阅