IDBCursor

Instanz-Eigenschaften

IDBCursor.source Schreibgeschtzt

Gibt den IDBObjectStore oder IDBIndex zurck, ber den der Cursor iteriert. Diese Funktion gibt niemals null zurck und wirft keine Ausnahme, selbst wenn der Cursor gerade iteriert wird, das Ende berschritten hat oder seine Transaktion nicht aktiv ist.

IDBCursor.direction Schreibgeschtzt

Gibt die Richtung der Traversierung des Cursors zurck.

IDBCursor.key Schreibgeschtzt

Gibt den Schlssel fr den Datensatz an der Position des Cursors zurck. Wenn der Cursor auerhalb seines Bereichs ist, wird dies auf undefined gesetzt. Der Schlssel des Cursors kann jeden Datentyp annehmen.

IDBCursor.primaryKey Schreibgeschtzt

Gibt den aktuellen effektiven Primrschlssel des Cursors zurck. Wenn der Cursor derzeit iteriert wird oder auerhalb seines Bereichs iteriert ist, wird dies auf undefined gesetzt. Der Primrschlssel des Cursors kann jeden Datentyp annehmen.

IDBCursor.request Schreibgeschtzt

Gibt das IDBRequest zurck, das verwendet wurde, um den Cursor zu erhalten.

Instanz-Methoden

IDBCursor.advance()

Legt die Anzahl der Male fest, die ein Cursor seine Position vorwrts bewegen soll.

IDBCursor.continue()

Bewegt den Cursor zur nchsten Position in seiner Richtung, zu dem Element, dessen Schlssel dem optionalen key-Parameter entspricht.

IDBCursor.continuePrimaryKey()

Setzt den Cursor auf den angegebenen Indexschlssel und den als Argumente bergebenen Primrschlssel.

IDBCursor.delete()

Gibt ein IDBRequest Objekt zurck und lscht in einem separaten Thread den Datensatz an der Position des Cursors, ohne die Position des Cursors zu ndern. Dies kann verwendet werden, um bestimmte Datenstze zu lschen.

IDBCursor.update()

Gibt ein IDBRequest Objekt zurck und aktualisiert in einem separaten Thread den Wert an der aktuellen Position des Cursors im Objektstore. Dies kann verwendet werden, um bestimmte Datenstze zu aktualisieren.

Konstanten

• NEXT: "next" : Der Cursor zeigt alle Datenstze an, einschlielich Duplikate. Er beginnt beim unteren Ende des Schlsselbereichs und bewegt sich nach oben (monoton steigend in der Reihenfolge der Schlssel).
• NEXTUNIQUE : "nextunique" : Der Cursor zeigt alle Datenstze an, ohne Duplikate. Wenn mehrere Datenstze mit demselben Schlssel existieren, wird nur der erste iterierte abgerufen. Er beginnt beim unteren Ende des Schlsselbereichs und bewegt sich nach oben.
• PREV: "prev" : Der Cursor zeigt alle Datenstze an, einschlielich Duplikate. Er beginnt beim oberen Ende des Schlsselbereichs und bewegt sich nach unten (monoton fallend in der Reihenfolge der Schlssel).
• PREVUNIQUE: "prevunique" : Der Cursor zeigt alle Datenstze an, ohne Duplikate. Wenn mehrere Datenstze mit demselben Schlssel existieren, wird nur der erste iterierte abgerufen. Er beginnt beim oberen Ende des Schlsselbereichs und bewegt sich nach unten.

Beispiele

In diesem einfachen Fragment erstellen wir eine Transaktion, rufen einen Objektstore ab und verwenden dann einen Cursor, um alle Datenstze im Objektstore zu durchlaufen. Der Cursor erfordert nicht, dass wir die Daten basierend auf einem Schlssel auswhlen; wir knnen einfach alle abrufen. Beachten Sie auch, dass Sie in jeder Iteration der Schleife Daten aus dem aktuellen Datensatz unter dem Cursor-Objekt mit cursor.value.foo abrufen knnen. Ein vollstndiges Arbeitsbeispiel finden Sie in unserem IDBCursor-Beispiel (Beispiel live ansehen.)

function displayData() {
  const transaction = db.transaction(["rushAlbumList"], "readonly");
  const objectStore = transaction.objectStore("rushAlbumList");

  objectStore.openCursor().onsuccess = (event) => {
    const cursor = event.target.result;
    if (cursor) {
      const listItem = document.createElement("li");
      listItem.textContent = `${cursor.value.albumTitle}, ${cursor.value.year}`;
      list.appendChild(listItem);

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

Spezifikationen

Browser-Kompatibilitt

Siehe auch

• Verwendung von IndexedDB
• Transaktionen starten: IDBDatabase
• Verwendung von Transaktionen: IDBTransaction
• Festlegen eines Schlsselbereichs: IDBKeyRange
• Abrufen und ndern Ihrer Daten: IDBObjectStore
• Referenzbeispiel: To-do Notifications (Beispiel live ansehen).