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

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

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

js
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

Siehe auch