SharedStorage: set() Methode
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.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die set() Methode der SharedStorage Schnittstelle speichert entweder ein neues Schlüssel-Wert-Paar im gemeinsamen Speicher des aktuellen Ursprungs oder aktualisiert ein bestehendes.
Syntax
set(key, value)
set(key, value, options)
Parameter
key-
Ein String, der den Schlüssel im Schlüssel-Wert-Paar darstellt, das Sie hinzufügen oder aktualisieren möchten.
value-
Ein String, der den Wert darstellt, den Sie hinzufügen oder aktualisieren möchten.
optionsOptional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthält:
ignoreIfPresent-
Ein booleanischer Wert. Der Wert
truebewirkt, dass der Set-Vorgang abgebrochen wird, wenn ein Schlüssel-Wert-Paar mit dem angegebenenkeybereits existiert. Der Standardwertfalsebewirkt, dass der Set-Vorgang den vorherigen Wert überschreibt.
Rückgabewert
Ein Promise, das mit undefined erfüllt wird.
Ausnahmen
- Das
Promisewird mit einemTypeErrorabgelehnt, wenn:- Der erstellte Eintrag nicht erfolgreich in der Datenbank gespeichert wurde, da der gemeinsame Speicher nicht verfügbar ist (zum Beispiel, wenn er über eine Browsereinstellung deaktiviert ist).
keyund/odervaluedie vom Browser definierte maximale Länge überschreiten.- Die aufrufende Site die Shared Storage-API nicht in einem erfolgreichen Einbindungsprozess in die Datenschutzoase eingeschlossen hat.
- Im Fall von
WorkletSharedStoragewird dasPromisemit einemTypeErrorabgelehnt, wenn das Worklet-Modul nicht mitSharedStorageWorklet.addModule()hinzugefügt wurde.
Hinweis:
Im Fall von WindowSharedStorage, wenn der set()-Vorgang aus einem anderen Grund nicht erfolgreich in die Datenbank schreibt, als dass der gemeinsame Speicher nicht verfügbar ist, wird kein Fehler ausgelöst — der Vorgang wird dennoch mit undefined erfüllt.
Beispiele
window.sharedStorage
.set("ab-testing-group", "0", {
ignoreIfPresent: true,
})
.then(() => console.log("Set operation completed"));