diff options
Diffstat (limited to 'files/ja/web/api/idbcursor/continue/index.html')
-rw-r--r-- | files/ja/web/api/idbcursor/continue/index.html | 129 |
1 files changed, 129 insertions, 0 deletions
diff --git a/files/ja/web/api/idbcursor/continue/index.html b/files/ja/web/api/idbcursor/continue/index.html new file mode 100644 index 0000000000..eb671e3487 --- /dev/null +++ b/files/ja/web/api/idbcursor/continue/index.html @@ -0,0 +1,129 @@ +--- +title: IDBCursor.continue() +slug: Web/API/IDBCursor/continue +tags: + - API + - Database + - IDBCursor + - IndexedDB + - Reference + - continue + - ストレージ + - メソッド +translation_of: Web/API/IDBCursor/continue +--- +<div>{{APIRef("IndexedDB")}}</div> + +<p><strong><code>continue()</code></strong> は {{domxref("IDBCursor")}} インターフェースのメソッドで、カーソルを現在の方向に次の位置、任意のキーパラメーターに一致するキーを持つアイテムまで進めます。キーを指定しない場合、カーソルはその方向に基づいて、すぐ隣の位置へ進みます。</p> + +<p>{{AvailableInWorkers}}</p> + +<h2 id="Syntax" name="Syntax">構文</h2> + +<pre class="syntaxbox"><var>cursor</var>.continue(<var>key</var>);</pre> + +<h3 id="Parameters" name="Parameters">引数</h3> + +<dl> + <dt><code><var>key</var></code> {{optional_inline}}</dt> + <dd>カーソルを進めるためのキーです。</dd> +</dl> + +<h3 id="Exceptions" name="Exceptions">例外</h3> + +<p>このメソッドは次の内いずれかの {{domxref("DOMException")}} を発生させることがあります。</p> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">例外</th> + <th scope="col">解説</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>TransactionInactiveError</code></td> + <td>この IDBCursor のトランザクションがアクティブではありません。</td> + </tr> + <tr> + <td><code>DataError</code></td> + <td> + <p>キーパラメーターが以下の状態のうちのいずれかである可能性があります。</p> + + <ul> + <li>キーが妥当なキーではない</li> + <li>キーがこのカーソルの位置と同じかそれより小さく、カーソルの方向が <code>next</code> または <code>nextunique</code> である</li> + <li>キーがこのカーソルの位置と同じかそれより大きく、カーソルの方向が <code>prev</code> または <code>prevunique</code> である</li> + </ul> + </td> + </tr> + <tr> + <td><code>InvalidStateError</code></td> + <td>カーソルが現在走査中または末尾を越えて走査しました。</td> + </tr> + </tbody> +</table> + +<h2 id="Example" name="Example">例</h2> + +<p>この単純で部分的な実例ではトランザクションを作り、オブジェクトストアを取得した後、オブジェクトストア内の全ての反復処理するためカーソルを使用しています。カーソルはキーに基づいてデータを選択するには必要ありません。その全てを捕らえることができます。また、それぞれのループ内での繰り返しでカーソルオブジェクトを用い、 <code>cursor.value.foo</code> とすることで、現在のレコードからカーソルの下のデータを取得できることには注目です。完全な例については <a href="https://github.com/mdn/indexeddb-examples/tree/master/idbcursor">IDBCursor の例</a> (<a href="https://mdn.github.io/indexeddb-examples/idbcursor/">ライブデモを見る</a>) を参照してください。</p> + +<pre>function displayData() { + var transaction = db.transaction(['rushAlbumList'], "readonly"); + var objectStore = transaction.objectStore('rushAlbumList'); + + objectStore.openCursor().onsuccess = function(event) { + var cursor = event.target.result; + if(cursor) { + var listItem = document.createElement('li'); + listItem.innerHTML = cursor.value.albumTitle + ', ' + cursor.value.year; + list.appendChild(listItem); + + cursor.continue(); + } else { + console.log('Entries all displayed.'); + } + }; +};</pre> + +<h2 id="Specifications" name="Specifications">仕様書</h2> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">仕様書</th> + <th scope="col">状態</th> + <th scope="col">備考</th> + </tr> + </thead> + <tbody> + <tr> + <td>{{SpecName('IndexedDB', '#widl-IDBCursor-continue-void-any-key', 'continue()')}}</td> + <td>{{Spec2('IndexedDB')}}</td> + <td></td> + </tr> + <tr> + <td>{{SpecName("IndexedDB 2", "#dom-idbcursor-continue", "continue()")}}</td> + <td>{{Spec2("IndexedDB 2")}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2> + +<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div> + +<p>{{Compat("api.IDBCursor.continue")}}</p> + +<h2 id="See_also" name="See_also">関連情報</h2> + +<ul> + <li><a href="/en-US/docs/Web/API/IndexedDB_API/Using_IndexedDB">Using IndexedDB</a></li> + <li>トランザクションの開始: {{domxref("IDBDatabase")}}</li> + <li>トランザクションを使う: {{domxref("IDBTransaction")}}</li> + <li>キーの範囲設定: {{domxref("IDBKeyRange")}}</li> + <li>データの取得と変更: {{domxref("IDBObjectStore")}}</li> + <li>カーソルを使う: {{domxref("IDBCursor")}}</li> + <li>リファレンス 実例: <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> |