---
title: IDBFactory.cmp
slug: Web/API/IDBFactory/cmp
tags:
  - API
  - Database
  - IDBFactory
  - IndexedDB
  - Storage
  - cmp
translation_of: Web/API/IDBFactory/cmp
---
<p>{{ APIRef("IDBFactory") }}</p>
<div>
 <p>{{domxref("IDBFactory")}}インターフェイスの<code>cmp()</code>メソッドは、2つのキーが等価か決定するために比較し、そして、IndexedDBで保存や統合のような操作を命令します。</p>
</div>
<div class="note">
 <p><strong>Note</strong>: 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.</p>
</div>
<h2 id="構文">構文</h2>
<pre class="brush: js">var result = window.indexedDB.cmp(a, b);</pre>
<h3 id="戻り値">戻り値</h3>
<p>比較結果を示す整数値。 次のテーブルに可能性のある値とその意味を載せます。:</p>
<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">戻り値</th>
   <th scope="col">説明</th>
  </tr>
  <tr>
   <td>-1</td>
   <td>1つ目のキーが2つ目のキーより小さい</td>
  </tr>
  <tr>
   <td>0</td>
   <td>1つ目のキーと2つ目のキーが等しい</td>
  </tr>
  <tr>
   <td>1</td>
   <td>1つ目のキーが2つ目のキーより大きい</td>
  </tr>
 </tbody>
</table>
<h3 id="例外">例外</h3>
<p>このメソッドでは、次の型のような{{domxref("DOMError")}} を持つ {{domxref("DOMException")}}が発生するかもしれません。</p>
<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">属性</th>
   <th scope="col">説明</th>
  </tr>
  <tr>
   <td><a href="/ja/docs/DOM/DOMError"><code>DataError</code></a></td>
   <td>渡されたキーが不正な値である。</td>
  </tr>
 </thead>
</table>
<h2 id="例">例</h2>
<pre class="brush: js;highlight:[3]">var a = 1;
var b = 2;
var result = window.indexedDB.cmp(a, b);
console.log( "Comparison results: " + result );</pre>
<h2 id="パラメーター">パラメーター</h2>
<dl>
 <dt>
  first</dt>
 <dd>
  比較する1つ目のキー。</dd>
 <dt>
  second</dt>
 <dd>
  比較する2つ目のキー。</dd>
</dl>
<h2 id="仕様">仕様</h2>
<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('IndexedDB', '#widl-IDBFactory-cmp-short-any-first-any-second', 'cmp')}}</td>
   <td>{{Spec2('IndexedDB')}}</td>
   <td> </td>
  </tr>
 </tbody>
</table>
<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザ実装状況</h2>

<p>{{Compat("api.IDBFactory.cmp")}}</p>

<h2 id="関連情報">関連情報</h2>
<ul>
 <li><a href="/ja/docs/Web/API/IndexedDB_API/Using_IndexedDB">Using IndexedDB</a></li>
 <li>Starting transactions: {{domxref("IDBDatabase")}}</li>
 <li>Using transactions: {{domxref("IDBTransaction")}}</li>
 <li>Setting a range of keys: {{domxref("IDBKeyRange")}}</li>
 <li>Retrieving and making changes to your data: {{domxref("IDBObjectStore")}}</li>
 <li>Using cursors: {{domxref("IDBCursor")}}</li>
 <li>Reference example: <a class="external" href="https://github.com/mdn/to-do-notifications/tree/gh-pages">To-do Notifications</a> (<a class="external" href="http://mdn.github.io/to-do-notifications/">view example live</a>.)</li>
</ul>