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 der SharedStorage-Schnittstelle fügt einen String zum Wert eines vorhandenen 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 darstellt, zu 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 set(), das heißt, ein neues Schlüssel-Wert-Paar mit dem angegebenen key wird dem Shared Storage hinzugefügt.
Rückgabewert
Ein Promise, der sich mit undefined erfüllt.
Ausnahmen
- Das
Promisewird mit einemTypeErrorzurückgewiesen, wenn:- Der hinzugefügte Eintrag nicht erfolgreich in der Datenbank gespeichert wurde, weil der Shared Storage nicht verfügbar ist (zum Beispiel, wenn er über eine Browsereinstellung deaktiviert wurde).
keyund/odervaluedie browserdefinierte maximale Länge überschreiten.- Die aufrufende Seite die Shared Storage API nicht in einem erfolgreichen Privacy Sandbox Enrollment Process aufgenommen hat.
- Im Fall von
WorkletSharedStoragewird dasPromisemit einemTypeErrorzurückgewiesen, wenn das Worklet-Modul nicht mitSharedStorageWorklet.addModule()hinzugefügt wurde.
Hinweis:
Im Fall von WindowSharedStorage, wenn die append()-Operation aus einem anderen Grund als der Nichtverfügbarkeit des Shared Storage nicht erfolgreich in die Datenbank schreibt, wird kein Fehler ausgelöst — 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 |
Browser-Kompatibilität
Loading…