SharedStorage: append()-Methode

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Die append()-Methode des SharedStorage-Interfaces fügt einen String zum Wert eines bestehenden Schlüssel-Wert-Paares im gemeinsam genutzten Speicher des aktuellen Ursprungs hinzu.

Syntax

js
append(key, value)

Parameter

key

Ein String, der den Schlüssel des Schlüssel-Wert-Paares darstellt, zu dem Sie einen Wert hinzufügen möchten.

value

Ein String, den Sie dem bestehenden Wert des Schlüssel-Wert-Paares hinzufügen möchten.

Hinweis: Wenn der angegebene key im gemeinsam genutzten Speicher nicht gefunden wird, ist der append()-Vorgang gleichbedeutend mit set(), das heißt, ein neues Schlüssel-Wert-Paar mit dem angegebenen key wird zum gemeinsam genutzten Speicher hinzugefügt.

Rückgabewert

Ein Promise, das mit undefined erfüllt wird.

Ausnahmen

  • Das Promise wird mit einem TypeError abgelehnt, wenn:
    • Der hinzugefügte Eintrag aufgrund der Nichtverfügbarkeit des gemeinsam genutzten Speichers nicht erfolgreich in der Datenbank gespeichert wurde (zum Beispiel, wenn er durch eine Browsereinstellung deaktiviert ist).
    • key und/oder value die vom Browser definierte maximale Länge überschreiten.
    • Die aufrufende Stelle die Shared Storage API nicht in einem erfolgreichen Datenschutz-Sandbox-Anmeldeprozess eingeschlossen hat.
  • Im Fall von WorkletSharedStorage wird das Promise mit einem TypeError abgelehnt, wenn das Worklet-Modul nicht mit SharedStorageWorklet.addModule() hinzugefügt wurde.

Hinweis: Im Fall von WindowSharedStorage wird kein Fehler ausgelöst, wenn der append()-Vorgang aus einem anderen Grund als der Nichtverfügbarkeit des gemeinsam genutzten Speichers nicht erfolgreich in die Datenbank geschrieben wird — der Vorgang wird dennoch mit undefined erfüllt.

Beispiele

js
window.sharedStorage
  .append("integer-list", ",9")
  .then(console.log("Value appended to integer list"));

Spezifikationen

Specification
Shared Storage API
# dom-sharedstorage-append

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch