SharedStorage: append()-Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.
Die append()-Methode der SharedStorage-Schnittstelle fügt einen String zum Wert eines bestehenden Schlüssel-Wert-Paares im Shared Storage des aktuellen Ursprungs hinzu.
Syntax
append(key, value)
Parameter
key-
Ein String, der den Schlüssel des Schlüssel-Wert-Paares repräsentiert, dem Sie einen Wert hinzufügen möchten.
value-
Ein String, den Sie zum bestehenden Wert des Schlüssel-Wert-Paares hinzufügen möchten.
Hinweis:
Wenn der angegebene key im Shared Storage nicht gefunden wird, entspricht die append()-Operation der set()-Methode, das heißt, ein neues Schlüssel-Wert-Paar mit dem angegebenen key wird zum Shared Storage hinzugefügt.
Rückgabewert
Ein Promise, das mit undefined erfüllt wird.
Ausnahmen
- Das
Promiseschlägt mit einemTypeErrorfehl, wenn:- Der hinzugefügte Eintrag nicht erfolgreich in der Datenbank gespeichert wurde, weil der Shared Storage nicht verfügbar ist (z.B. ist er über eine Browsereinstellung deaktiviert).
keyund/odervaluedie vom Browser definierte maximale Länge überschreiten.- Die aufrufende Seite die Shared Storage API nicht in einem erfolgreichen Privacy Sandbox Enrollment Prozess implementiert hat.
- Im Fall von
WorkletSharedStorageschlägt dasPromisemit einemTypeErrorfehl, wenn das Worklet-Modul nicht mitSharedStorageWorklet.addModule()hinzugefügt wurde.
Hinweis:
Im Fall von WindowSharedStorage, wenn die append()-Operation nicht erfolgreich in die Datenbank geschrieben wird aus einem Grund, der nicht die Nichtverfügbarkeit des Shared Storages ist, wird kein Fehler geworfen — die Operation wird trotzdem mit undefined erfüllt.
Beispiele
window.sharedStorage
.append("integer-list", ",9")
.then(() => console.log("Value appended to integer list"));
Spezifikationen
| Specification |
|---|
| Shared Storage API # dom-sharedstorage-append |