SharedStorage: delete()-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 delete()
-Methode der SharedStorage
Schnittstelle löscht ein bestehendes Schlüssel-Wert-Paar aus dem gemeinsamen Speicher des aktuellen Ursprungs.
Syntax
delete(key)
Parameter
key
-
Ein String, der den Schlüssel des Schlüssel-Wert-Paares darstellt, das Sie löschen möchten.
Rückgabewert
Ein Promise
, das mit undefined
erfüllt wird.
Ausnahmen
- Das
Promise
wird mit einemTypeError
abgelehnt, wenn:- Die Datenbank nicht erfolgreich gelöscht wurde, da der gemeinsame Speicher nicht verfügbar ist (zum Beispiel, wenn er durch eine Browsereinstellung deaktiviert ist).
key
die vom Browser definierte maximale Länge überschreitet.- Die aufrufende Site die Shared Storage API nicht in einem erfolgreichen Anmeldeprozess für das Datenschutz-Sandbox enthalten hat.
- Im Fall von
WorkletSharedStorage
wird dasPromise
mit einemTypeError
abgelehnt, wenn:- Das Worklet-Modul nicht mit
SharedStorageWorklet.addModule()
hinzugefügt wurde.
- Das Worklet-Modul nicht mit
Hinweis: Wenn das Schlüssel-Wert-Paar nicht im gemeinsamen Speicher existiert, wird kein Fehler ausgelöst — der Vorgang wird trotzdem mit undefined
erfüllt.
Hinweis: Im Fall von WindowSharedStorage
, wenn der delete()
-Vorgang nicht erfolgreich in die Datenbank schreibt aus einem anderen Grund als der Nichtverfügbarkeit des gemeinsamen Speichers, wird kein Fehler ausgelöst — der Vorgang wird trotzdem mit undefined
erfüllt.
Beispiele
window.sharedStorage
.delete("ab-testing-group")
.then(console.log("Value deleted"));
Spezifikationen
Specification |
---|
Shared Storage API # dom-sharedstorage-delete |
Browser-Kompatibilität
BCD tables only load in the browser