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 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
Promisewird mit einemTypeErrorabgelehnt, wenn:- Die Datenbank nicht erfolgreich gelöscht wurde, da der gemeinsame Speicher nicht verfügbar ist (zum Beispiel, weil er über eine Browsereinstellung deaktiviert wurde).
keydie vom Browser definierte maximale Länge überschreitet.- Die aufrufende Seite die Shared Storage API nicht in einem erfolgreichen Privacy Sandbox-Anmeldeprozess enthalten hat.
- Im Fall von
WorkletSharedStoragewird dasPromisemit einemTypeErrorabgelehnt, 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 vorhanden ist, wird kein Fehler ausgelöst — der Vorgang wird dennoch mit undefined erfüllt.
Hinweis:
Im Fall von WindowSharedStorage, wenn der delete()-Vorgang aus einem anderen Grund als der Nichtverfügbarkeit des gemeinsamen Speichers nicht erfolgreich in die Datenbank schreibt, wird kein Fehler ausgelöst — der Vorgang 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
Loading…