IDBCursor: primaryKey Eigenschaft

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die schreibgeschützte primaryKey-Eigenschaft des IDBCursor-Interfaces gibt den aktuellen effektiven Schlüssel des Cursors zurück. Wenn der Cursor momentan iteriert wird oder außerhalb seines Bereichs iteriert hat, wird dieser auf undefiniert gesetzt. Der Primärschlüssel des Cursors kann jeden beliebigen Datentyp haben.

Wert

Ein Wert eines beliebigen Datentyps.

Beispiele

In diesem einfachen Fragment erstellen wir eine Transaktion, holen einen Objektstore und verwenden dann einen Cursor, um alle Datensätze im Objektstore zu durchlaufen. Innerhalb jeder Iteration protokollieren wir den Primärschlüssel des Cursors in der Konsole.

Der Cursor erfordert nicht, dass wir die Daten basierend auf einem Schlüssel auswählen; wir können 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 können. Für ein vollständiges funktionierendes Beispiel siehe unser IDBCursor-Beispiel (Beispiel live ansehen).

js
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);

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

Spezifikationen

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

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch