IDBObjectStore: put() Methode

Syntax

put(item)
put(item, key)

Parameter

item

Der Eintrag, den Sie aktualisieren (oder einfügen) möchten.

key Optional

Der Primärschlüssel des Datensatzes, den Sie aktualisieren möchten (z.B. von IDBCursor.primaryKey).

Rückgabewert

Ein IDBRequest Objekt, auf dem nachfolgende Ereignisse bezogen auf diese Operation ausgelöst werden.

Wenn die Operation erfolgreich ist, ist der Wert der result-Eigenschaft der Anfrage der Schlüssel für den neuen oder aktualisierten Datensatz.

Ausnahmen

Diese Methode kann eine DOMException von einem der folgenden Typen auslösen:

ReadOnlyError DOMException

Wird ausgelöst, wenn die mit dieser Operation verbundene Transaktion im schreibgeschützten Modus ist.

TransactionInactiveError DOMException

Wird ausgelöst, wenn die Transaktion dieses IDBObjectStore inaktiv ist.

DataError DOMException

Wird ausgelöst, wenn einer der folgenden Bedingungen zutrifft:

• Der Objekt-Store verwendet In-line-Schlüssel oder hat einen Schlüsselgenerator, und ein key Parameter wurde bereitgestellt.
• Der Objekt-Store verwendet Out-of-line-Schlüssel und hat keinen Schlüsselgenerator, und kein key Parameter wurde bereitgestellt.
• Der Objekt-Store verwendet In-line-Schlüssel, aber keinen Schlüsselgenerator, und der Schlüsselpfad des Objekt-Stores ergibt keinen gültigen Schlüssel.
• Der key Parameter wurde bereitgestellt, enthält aber keinen gültigen Schlüssel.

InvalidStateError DOMException

Wird ausgelöst, wenn das IDBObjectStore gelöscht oder entfernt wurde.

DataCloneError DOMException

Wird ausgelöst, wenn die zu speichernden Daten nicht durch den internen strukturierten Klon-Algorithmus geklont werden konnten.

Beispiele

Das folgende Beispiel fordert einen bestimmten Datensatz an; wenn diese Anfrage erfolgreich ist, erhält die onsuccess Funktion den zugehörigen Datensatz vom IDBObjectStore (verfügbar als objectStoreTitleRequest.result), aktualisiert eine Eigenschaft des Datensatzes und legt dann den aktualisierten Datensatz in einer anderen Anfrage mit put() zurück in den Objekt-Store. Für ein vollständiges Arbeitsbeispiel siehe unsere To-do Notifications App (beispiel live ansehen).

const title = "Walk dog";

// Open up a transaction as usual
const objectStore = db
  .transaction(["toDoList"], "readwrite")
  .objectStore("toDoList");

// Get the to-do list object that has this title as its title
const objectStoreTitleRequest = objectStore.get(title);

objectStoreTitleRequest.onsuccess = () => {
  // Grab the data object returned as the result
  const data = objectStoreTitleRequest.result;

  // Update the notified value in the object to "yes"
  data.notified = "yes";

  // Create another request that inserts the item back into the database
  const updateTitleRequest = objectStore.put(data);

  // Log the transaction that originated this request
  console.log(
    `The transaction that originated this request is ${updateTitleRequest.transaction}`,
  );

  // When this new request succeeds, run the displayData() function again to update the display
  updateTitleRequest.onsuccess = () => {
    displayData();
  };
};

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
• Verwenden von Cursors: IDBCursor
• Referenzbeispiel: To-do Notifications (Beispiel live ansehen).