DOM：IDBIndexインターフェイス

IndexedDB API の IDBIndex インターフェイスは、データベース内のインデックスへの非同期アクセスを提供します。インデックスは、別のオブジェクトストアでレコードを検索するための一種のオブジェクトストアです。参照オブジェクトストアと呼ばれます。このインターフェースを使用してデータを取得します。

主キーまたはインデックスを使用して、オブジェクトストア内のレコードを取得できます。インデックスを使用すると、主キー以外のレコードを格納するオブジェクトの値のプロパティを使用して、オブジェクトストアのレコードを検索できます。

インデックスは永続的な Key-Value ストレージであり、そのレコードの値部分は、参照されるオブジェクトストア内のレコードのキー部分です。インデックス内のレコードは、参照されるオブジェクトストア内のレコードが挿入、更新、または削除されるたびに自動的に入力されます。インデックス内の各レコードは、参照されるオブジェクトストア内の1つのレコードのみを指すことができます。ただし、複数のインデックスが同じオブジェクトストアを参照できます。オブジェクトストアが変更されると、オブジェクトストアを参照するすべてのインデックスは自動的に更新されます。

範囲内のキーのセットを取得できます。詳細については、IDBKeyRange を参照してください。

プロパティ

メソッド

例

次の例では、トランザクションとオブジェクトストアを開きます。次に、単純な連絡先データベースからインデックス lName を取得します。次に、IDBIndex.openCursor を使用してインデックスの基本カーソルを開きます ― これは、IDBObjectStore.openCursor を使用して ObjectStore で直接カーソルを開くのと同じように機能しますが、返されるレコードがインデックスに基づいてソートされる点が異なります。主キーではありません。

最後に、各レコードを反復処理し、データをHTMLテーブルに挿入します。完全な実例については、IndexedDB-examples デモリポジトリを参照してください（例をライブで表示します）。

function displayDataByIndex() {
  tableEntry.innerHTML = '';
  var transaction = db.transaction(['contactsList'], 'readonly');
  var objectStore = transaction.objectStore('contactsList');

  var myIndex = objectStore.index('lName');
  myIndex.openCursor().onsuccess = function(event) {
    var cursor = event.target.result;
    if(cursor) {
      var tableRow = document.createElement('tr');
      tableRow.innerHTML =   '<td>' + cursor.value.id + '</td>'
                           + '<td>' + cursor.value.lName + '</td>'
                           + '<td>' + cursor.value.fName + '</td>'
                           + '<td>' + cursor.value.jTitle + '</td>'
                           + '<td>' + cursor.value.company + '</td>'
                           + '<td>' + cursor.value.eMail + '</td>'
                           + '<td>' + cursor.value.phone + '</td>'
                           + '<td>' + cursor.value.age + '</td>';
      tableEntry.appendChild(tableRow);

      cursor.continue();
    } else {
      console.log('Entries all displayed.');
    }
  };
};

スクリプト：

スクリプト：

DOM

インターフェイス

IDBIndex インターフェイス

プロパティ

メソッド

例

テスト