IDBCursor

Mthodes

IDBCursor.advance()

Dfinit le nombre d'itrations vers l'avant.

IDBCursor.continue()

Avance le curseur sur la position suivante le long de sa direction, jusqu' l'lment dont la cl correspond au paramtre (optionnel) pass la fonction.

IDBCursor.delete()

Retourne un objet IDBRequest, et, dans un thread spar, supprime l'enregistrement la position du curseur, sans changer la position du curseur. Ceci peut tre utilis pour supprimer des enregistrements spcifiques.

IDBCursor.update()

Retourne un objet IDBRequest, et, dans un thread spar, met jour la valeur la position actuelle du curseur dans le magasin d'objets. Ceci peut tre utilis pour mettre jour des enregistrements spcifiques.

Proprits

IDBCursor.source Lecture seule

Renvoie le IDBObjectStore ou IDBIndex sur lequel le curseur itre. Cette fonction ne retourne jamais null et ne dclenche pas d'exception, mme dans les cas ou le curseur est en train d'itrer, s'il a itr en dehors la plage ou si la transaction n'est pas active.

IDBCursor.direction Lecture seule

Renvoie la direction de parcours du curseur. Voir le paragraphe suivant, Constantes, pour les valeurs possibles.

IDBCursor.key Lecture seule

Renvoie la cl de l'enregistrement la position du curseur ou undefined si le curseur est en dehors de la plage. La cl peut tre de n'importe quel type de donnes.

IDBCursor.primaryKey Lecture seule

Renvoie la cl primaire effective actuelle du curseur ou undefined si le curseur est actuellement itr ou a itr en dehors de sa plage. La cl primaire du curseur peut tre de tout type de donnes.

Constantes

Exemple

Dans ce fragment simple, nous crons une transaction, rcuprons un magasin d'objets, puis utilisons un curseur pour parcourir tous les enregistrements du magasin d'objets. Le curseur ne nous oblige pas slectionner les donnes bases sur une cl, nous pouvons simplement travailler sur tout les enregistrements. Notez galement que dans chaque itration de la boucle, vous pouvez rcuprer les donnes de l'enregistrement en cours sous l'objet curseur l'aide curseur.value.toto. Pour un exemple de travail complet, voir notre exemple IDBCursor (l'exemple en live).

function afficheDonnee() {
  var transaction = db.transaction(["grandListAlbum"], "readonly");
  var objectStore = transaction.objectStore("grandListAlbum");

  objectStore.openCursor().onsuccess = function (event) {
    var curseur = event.target.result;
    if (curseur) {
      var listItem = document.createElement("li");
      listItem.innerHTML =
        curseur.value.titreAlbum + ", " + curseur.value.annee;
      list.appendChild(listItem);

      curseur.continue();
    } else {
      console.log("Entres tous affichs.");
    }
  };
}

Spcifications

Compatibilit des navigateurs

Voir aussi

• Manipuler IndexedDB
• Dmarrer des transactions : IDBDatabase
• Manipuler des transactions : IDBTransaction
• Dfinir un intervalle de cls : IDBKeyRange
• Rcuprer des donnes et les modifier : IDBObjectStore
• Manipuler des curseurs: IDBCursor
• Exemple de rfrence pour IndexedDB : To-do Notifications