IDBCursor.continue()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

El siguiente método de la IDBCursor interfaz, avanza el cursor hacia la siguiente posición a lo largo de su dirección, para el elemento cuya tecla marque la opción de una tecla parámetro. si ninguna tecla es especificada, el cursor avanzará hacia la siguiente posición, basado en su dirección actual.

Nota: Esta característica está disponible en Web Workers.

Sintaxis

js
cursor.continue(optionalKey);

Parámetros

Tecla opcional

La tecla para posisionar al cursor en.

Excepciones

Este método puede plantear unDOMException con una DOMError de uno de los siguientes tipos:

TransactionInactiveError

Esta transacción en el Cursor IDB está inactiva.

DataError

El parámetro de una tecla podría tener una de las siguientes condiciones:

  • La tecla no es una tecla valida.
  • La tecla está más atrás o en el mismo sitio que la posición del cursor y además la dirección del cursor es la siguiente o la única siguiente.
  • La tecla está más adelante o en el mismo sitio que la posición del cursor y además la dirección del cursor es previa o la única previa.
InvalidStateError

El cursor está siendo reiterado o se ha reiterado mas allá de su final.

Ejemplo

En este simple fragmento nosotros creamos una transacción, recuperar un objeto del almacen, despues usamos un cursor para interactuar a traves de todos los registros en almacen de objetos. El cursor no requiere que nosotros seleccionemos los datos basados en una tecla; podemos tomarlo todo. También es importante resaltar que en cada interacción de la cadena, puedes tomar datos desde el registro actual debajo del objeto del cursor usando ``cursor.value.foo. Para dar un ejemplo completo, puedes mirar nuestra IDBCursor example (view example live.)

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.');
    }
  };
};

Especificaciones

Specification
Indexed Database API 3.0
# ref-for-dom-idbcursor-continue①

Compatibilidad con navegadores

BCD tables only load in the browser

Te puede interesar