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, bevor Sie diese produktiv verwenden.
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
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 einemTypeError
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/odervalue
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 dasPromise
mit einemTypeError
abgelehnt, wenn das Worklet-Modul nicht mitSharedStorageWorklet.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
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