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 vor der Verwendung auf produktiven Webseiten.
Die delete()
-Methode der SharedStorage
-Schnittstelle löscht ein bestehendes Schlüssel-Wert-Paar aus dem Shared Storage 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 Shared Storage nicht verfügbar ist (zum Beispiel deaktiviert durch eine Browsereinstellung).
key
die vom Browser festgelegte maximale Länge überschreitet.- Die aufrufende Seite die Shared Storage API nicht in einem erfolgreichen Datenschutz-Sandbox-Einschreibungsprozess 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 Shared Storage existiert, wird kein Fehler ausgelöst — die Operation wird dennoch mit undefined
erfüllt.
Hinweis:
Im Fall von WindowSharedStorage
: Wenn die delete()
-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 dennoch 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
Report problems with this compatibility data on GitHubdesktop | mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
delete |
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.