IDBFactory: cmp() Methode
Hinweis: Dieses Feature ist verfügbar in Web Workers.
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
cmp(first, second)
Parameter
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
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
- Verwendung von IndexedDB
- Transaktionen starten:
IDBDatabase
- Verwendung von Transaktionen:
IDBTransaction
- Festlegen eines Schlüsselbereichs:
IDBKeyRange
- Abrufen und Ändern Ihrer Daten:
IDBObjectStore
- Verwendung von Cursor:
IDBCursor
- Referenzbeispiel: To-do Notifications (Beispiel live ansehen).