IDBFactory.cmp

IDBFactoryインターフェイスのcmp()メソッドは、2 つのキーが等価か決定するために比較し、そして、IndexedDB で保存や統合のような操作を命令します。

メモ: Do not use this method for comparing arbitrary JavaScript values, because many JavaScript values are either not valid IndexedDB keys (booleans and objects, for example) or are treated as equivalent IndexedDB keys (for example, since IndexedDB ignores arrays with non-numeric properties and treats them as empty arrays, so any non-numeric arrays are treated as equivalent). This throws an exception if either of the values is not a valid key.

構文

var result = window.indexedDB.cmp(a, b);

戻り値

比較結果を示す整数値。 次のテーブルに可能性のある値とその意味を載せます。:

戻り値 説明
-1 1 つ目のキーが 2 つ目のキーより小さい
0 1 つ目のキーと 2 つ目のキーが等しい
1 1 つ目のキーが 2 つ目のキーより大きい

例外

このメソッドでは、次の型のようなDOMError を持つ DOMExceptionが発生するかもしれません。

属性 説明
DataError 渡されたキーが不正な値である。

var a = 1;
var b = 2;
var result = window.indexedDB.cmp(a, b);
console.log( "Comparison results: " + result );

パラメーター

first

比較する 1 つ目のキー。

second

比較する 2 つ目のキー。

仕様

Specification Status Comment
Indexed Database API 2.0
cmp の定義
勧告

ブラウザ実装状況

BCD tables only load in the browser

関連情報