WorkletSharedStorage: length()-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 length()-Methode des WorkletSharedStorage-Interfaces gibt die Anzahl der aktuell im gemeinsamen Speicher für den aktuellen Ursprung gespeicherten Einträge zurück.

Syntax

js
length()

Parameter

Keine.

Rückgabewert

Ein Promise, das mit einer Zahl erfüllt wird, die die Gesamtanzahl der aktuell im gemeinsamen Speicher vorhandenen Schlüssel-Wert-Paare darstellt.

Ausnahmen

TypeError

Wird ausgelöst, wenn:

  • Das Worklet-Modul noch nicht mit addModule() hinzugefügt wurde.
  • Die aufrufende Stelle die Shared Storage API nicht in einem erfolgreichen Anmeldeprozess für die Privacy Sandbox integriert hat.
  • Der Browser aus einem anderen Grund nicht in der Lage ist, die Anzahl der Einträge abzurufen.

Beispiele

js
// length() available inside a shared storage worklet module

async function retrieveLength() {
  const length = await this.sharedStorage.length();
  console.log(length);
}

Spezifikationen

Specification
Shared Storage API
# dom-workletsharedstorage-length

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch