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

js
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 einem TypeError 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 das Promise mit einem TypeError abgelehnt, wenn:

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

js
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 GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
delete
Experimental

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.

Siehe auch