IDBFactory.cmp

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

Note: 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

関連情報