IDBCursor

Instanzeigenschaften

IDBCursor.source Schreibgeschützt

Gibt den IDBObjectStore oder IDBIndex zurück, über den der Cursor iteriert. Diese Funktion gibt niemals null zurück oder löst eine Ausnahme aus, selbst wenn der Cursor gerade iteriert wird, über sein Ende hinaus ist oder seine Transaktion nicht aktiv ist.

IDBCursor.direction Schreibgeschützt

Gibt die Richtung der Traversierung des Cursors zurück.

IDBCursor.key Schreibgeschützt

Gibt den Schlüssel für den Datensatz an der Position des Cursors zurück. Wenn der Cursor außerhalb seines Bereichs ist, wird dies auf undefined gesetzt. Der Schlüssel des Cursors kann ein beliebiger Datentyp sein.

IDBCursor.primaryKey Schreibgeschützt

Gibt den aktuellen effektiven Primärschlüssel des Cursors zurück. Wenn der Cursor gerade iteriert wird oder außerhalb seines Bereichs iteriert hat, wird dies auf undefined gesetzt. Der Primärschlüssel des Cursors kann ein beliebiger Datentyp sein.

IDBCursor.request Schreibgeschützt

Gibt das IDBRequest zurück, das verwendet wurde, um den Cursor zu erhalten.

Instanzmethoden

IDBCursor.advance()

Legt fest, wie oft ein Cursor seine Position vorwärts bewegen soll.

IDBCursor.continue()

Setzt den Cursor auf die nächste Position entlang seiner Richtung, auf das Element, dessen Schlüssel mit dem optionalen key-Parameter übereinstimmt.

IDBCursor.continuePrimaryKey()

Setzt den Cursor auf den gegebenen Indexschlüssel und Primärschlüssel, die als Argumente übergeben werden.

IDBCursor.delete()

Gibt ein IDBRequest-Objekt zurück und löscht in einem separaten Thread den Datensatz an der Position des Cursors, ohne die Position des Cursors zu ändern. Dies kann verwendet werden, um spezifische Datensätze zu löschen.

IDBCursor.update()

Gibt ein IDBRequest-Objekt zurück und aktualisiert in einem separaten Thread den Wert an der aktuellen Position des Cursors im Objekt-Store. Dies kann verwendet werden, um spezifische Datensätze zu aktualisieren.

Konstanten

• NEXT: "next" : Der Cursor zeigt alle Datensätze, einschließlich Duplikaten. Er beginnt am unteren Ende des Schlüsselbereichs und bewegt sich aufwärts (monoton zunehmend in der Reihenfolge der Schlüssel).
• NEXTUNIQUE : "nextunique" : Der Cursor zeigt alle Datensätze, exklusive Duplikate. Wenn mehrere Datensätze mit demselben Schlüssel existieren, wird nur der erste iterierte abgerufen. Er beginnt am unteren Ende des Schlüsselbereichs und bewegt sich aufwärts.
• PREV: "prev" : Der Cursor zeigt alle Datensätze, einschließlich Duplikate. Er beginnt am oberen Ende des Schlüsselbereichs und bewegt sich abwärts (monoton abnehmend in der Reihenfolge der Schlüssel).
• PREVUNIQUE: "prevunique" : Der Cursor zeigt alle Datensätze, exklusive Duplikate. Wenn mehrere Datensätze mit demselben Schlüssel existieren, wird nur der erste iterierte abgerufen. Er beginnt am oberen Ende des Schlüsselbereichs und bewegt sich abwärts.

Beispiele

In diesem einfachen Fragment erstellen wir eine Transaktion, rufen einen Objekt-Store ab und verwenden dann einen Cursor, um durch alle Datensätze im Objekt-Store zu iterieren. Der Cursor erfordert nicht, dass wir die Daten basierend auf einem Schlüssel auswählen; wir können einfach alles erfassen. Beachten Sie auch, dass Sie in jeder Iteration der Schleife Daten aus dem aktuellen Datensatz unter dem Cursor-Objekt mit cursor.value.foo abrufen können. Für ein vollständiges Arbeitsbeispiel siehe unser 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-Kompatibilität

Siehe auch

• Verwendung von IndexedDB
• Starten von Transaktionen: IDBDatabase
• Verwendung von Transaktionen: IDBTransaction
• Festlegen eines Schlüsselbereichs: IDBKeyRange
• Abrufen und Ändern Ihrer Daten: IDBObjectStore
• Referenzbeispiel: To-do-Benachrichtigungen (Beispiel live ansehen).