IDBFactory: cmp() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die cmp()-Methode des IDBFactory-Interfaces vergleicht zwei Werte als Schlüssel, um Gleichheit und Reihenfolge für IndexedDB-Operationen zu bestimmen, wie z. B. Speichern und Iterieren.

Hinweis: Verwenden Sie diese Methode nicht zum Vergleichen beliebiger JavaScript-Werte, da viele JavaScript-Werte entweder keine gültigen IndexedDB-Schlüssel sind (z. B. Booleans und Objekte) oder als gleichwertige IndexedDB-Schlüssel behandelt werden (zum Beispiel ignoriert IndexedDB Arrays mit nicht-numerischen Eigenschaften und behandelt sie als leere Arrays, daher werden alle nicht-numerischen Arrays als gleichwertig behandelt). Dies führt zu einer Ausnahme, wenn einer der Werte kein gültiger Schlüssel ist.

Syntax

js
cmp(first, second)

Parameter

first

Der erste zu vergleichende Schlüssel.

second

Der zweite zu vergleichende Schlüssel.

Rückgabewert

Ein ganzzahliger Wert, der das Ergebnis des Vergleichs anzeigt; die folgende Tabelle listet die möglichen Werte und ihre Bedeutungen auf:

Rückgabewert Beschreibung
-1 1. Schlüssel ist kleiner als der 2.
0 1. Schlüssel ist gleich dem 2.
1 1. Schlüssel ist größer als der 2.

Ausnahmen

DataError DOMException

Wird ausgelöst, wenn einer der angegebenen Schlüssel kein gültiger Schlüssel war.

Beispiele

js
const a = 1;
const b = 2;
const result = window.indexedDB.cmp(a, b);
console.log(`Comparison results: ${result}`);

Spezifikationen

Specification
Indexed Database API 3.0
# ref-for-dom-idbfactory-cmp①

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch