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 freigegebenen Speicher des aktuellen Ursprungs hinzu.
Syntax
append(key, value)
Parameter
key
-
Ein String, der den Schlüssel des Schlüssel-Wert-Paares darstellt, dem Sie einen Wert hinzufügen möchten.
value
-
Ein String, den Sie dem vorhandenen Wert des Schlüssel-Wert-Paares hinzufügen möchten.
Hinweis:
Wenn der angegebene key
nicht im freigegebenen Speicher gefunden wird, ist der append()
-Vorgang äquivalent zu set()
. Das bedeutet, dass ein neues Schlüssel-Wert-Paar mit dem angegebenen key
zum freigegebenen Speicher hinzugefügt wird.
Rückgabewert
Ein Promise
, das mit undefined
erfüllt wird.
Ausnahmen
- Das
Promise
wird mit einemTypeError
abgelehnt, wenn:- Der hinzugefügte Eintrag aufgrund der Nichtverfügbarkeit des freigegebenen Speichers (z.B. durch Deaktivierung über eine Browsereinstellung) nicht erfolgreich in der Datenbank gespeichert wurde.
key
und/odervalue
die vom Browser definierte maximale Länge überschreiten.- Die aufrufende Stelle die Shared Storage API nicht durch einen erfolgreichen Privacy Sandbox Anmeldeprozess eingebunden hat.
- Im Fall von
WorkletSharedStorage
wird dasPromise
mit einemTypeError
abgelehnt, wenn das Worklet-Modul nicht mitSharedStorageWorklet.addModule()
hinzugefügt wurde.
Hinweis:
Im Fall von WindowSharedStorage
, wenn der append()
-Vorgang aus einem anderen Grund als der Nichtverfügbarkeit des freigegebenen Speichers nicht erfolgreich in die Datenbank geschrieben wird, wird kein Fehler ausgelöst — der Vorgang 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
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
append |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- No support
- No support
- Experimental. Expect behavior to change in the future.