IDBCursor: primaryKey Eigenschaft

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

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 derzeit iteriert wird oder außerhalb seines Bereichs iteriert hat, wird dieser auf undefiniert gesetzt. Der Primärschlüssel des Cursors kann jeden Datentyp haben.

In diesem Artikel

Wert

Ein Wert eines beliebigen Datentyps.

Ausnahmen

InvalidStateError DOMException

Wird ausgelöst, wenn der Cursor voranschreitet oder abgeschlossen ist.

Beispiele

In diesem einfachen Fragment erstellen wir eine Transaktion, rufen einen Objektspeicher ab und verwenden dann einen Cursor, um durch alle Datensätze im Objektspeicher zu iterieren. In 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 Daten 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ändig 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.");
    }
  };
}

Verwendung von IndexedDB
Transaktionen starten: IDBDatabase
Verwenden von Transaktionen: IDBTransaction
Festlegung eines Schlüsselspektrums: IDBKeyRange
Abrufen und Ändern Ihrer Daten: IDBObjectStore
Verwendung von Cursorn: IDBCursor
Referenzbeispiel: To-do-Benachrichtigungen (Beispiel live ansehen).

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

IDBCursor: primaryKey Eigenschaft

In diesem Artikel

Wert

Ausnahmen

Beispiele

Spezifikationen

Browser-Kompatibilität

Siehe auch

Help improve MDN