StorageArea

Die StorageArea-Schnittstelle wird von der browser.storage API verwendet.

Methoden

clear()

browser.storage.StorageArea.clear(): Promise<void>

Entfernt alle Elemente aus dem Speicher.

Ausgabe

  • Promise<void>

    Chrome 95 und höher browser.* seit Chrome 148

    Promise, das bei Erfolg aufgelöst oder bei Fehlschlag abgelehnt wird.

get()

browser.storage.StorageArea.get(
  keys?: string | string[] | object,
): Promise<object>

Ruft ein oder mehrere Elemente aus dem Speicher ab.

Parameter

  • Schlüssel

    string | string[] | object optional

    Ein einzelner Schlüssel, eine Liste von Schlüsseln oder ein Wörterbuch mit Standardwerten (siehe Beschreibung des Objekts). Eine leere Liste oder ein leeres Objekt gibt ein leeres Ergebnisobjekt zurück. Übergeben Sie null, um den gesamten Inhalt des Speichers abzurufen.

Ausgabe

  • Promise<object>

    Chrome 95 und höher browser.* seit Chrome 148

    Promise, das mit einem Objekt aufgelöst wird, das eine Schlüssel/Wert-Zuordnung für die angeforderten Elemente enthält, oder bei einem Fehler abgelehnt wird.

getBytesInUse()

browser.storage.StorageArea.getBytesInUse(
  keys?: string | string[],
): Promise<number>

Ruft den von einem oder mehreren Elementen belegten Speicherplatz (in Byte) ab.

Parameter

  • Schlüssel

    string | string[] optional

    Ein einzelner Schlüssel oder eine Liste von Schlüsseln, für die die Gesamtnutzung abgerufen werden soll. Eine leere Liste gibt 0 zurück. Übergeben Sie null, um die Gesamtnutzung des gesamten Speichers abzurufen.

Ausgabe

  • Promise<number>

    Chrome 95 und höher browser.* seit Chrome 148

    Promise, das mit der Menge des vom Speicher verwendeten Speicherplatzes aufgelöst wird oder bei einem Fehler abgelehnt wird.

getKeys()

Chrome 130 und höher browser.* seit Chrome 148 
browser.storage.StorageArea.getKeys(): Promise<string[]>

Ruft alle Schlüssel aus dem Speicher ab.

Ausgabe

  • Promise<string[]>

    Promise, das mit Speicherschlüsseln aufgelöst oder bei einem Fehler abgelehnt wird.

remove()

browser.storage.StorageArea.remove(
  keys: string | string[],
): Promise<void>

Entfernt ein oder mehrere Elemente aus dem Speicher.

Parameter

  • Schlüssel

    string | string[]

    Ein einzelner Schlüssel oder eine Liste von Schlüsseln für zu entfernende Elemente.

Ausgabe

  • Promise<void>

    Chrome 95 und höher browser.* seit Chrome 148

    Promise, das bei Erfolg aufgelöst oder bei Fehlschlag abgelehnt wird.

set()

browser.storage.StorageArea.set(
  items: object,
): Promise<void>

Legt mehrere Elemente fest.

Parameter

  • Elemente

    Objekt

    Ein Objekt, das jedes Schlüssel/Wert-Paar enthält, mit dem der Speicher aktualisiert werden soll. Andere Schlüssel/Wert-Paare im Speicher sind davon nicht betroffen.

    Primitive Werte wie Zahlen werden wie erwartet serialisiert. Werte mit typeof "object" und "function" werden in der Regel zu {} serialisiert, mit Ausnahme von Array (wird wie erwartet serialisiert), Date und Regex (werden mit ihrer String-Darstellung serialisiert).

Ausgabe

  • Promise<void>

    Chrome 95 und höher browser.* seit Chrome 148

    Promise, das bei Erfolg aufgelöst oder bei Fehlschlag abgelehnt wird.

setAccessLevel()

Chrome 102 und höher browser.* seit Chrome 148 
browser.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): Promise<void>

Legt die gewünschte Zugriffsebene für den Speicherbereich fest. Standardmäßig ist der session-Speicher auf vertrauenswürdige Kontexte (Erweiterungsseiten und Service Worker) beschränkt, während der managed-, local- und sync-Speicher den Zugriff sowohl von vertrauenswürdigen als auch von nicht vertrauenswürdigen Kontexten aus ermöglichen.

Parameter

  • accessOptions

    Objekt

    • accessLevel

      AccessLevel

      Die Zugriffsebene des Speicherbereichs.

Ausgabe

  • Promise<void>

    Promise, das bei Erfolg aufgelöst oder bei Fehlschlag abgelehnt wird.

Ereignisse

onChanged

Chrome 73 und höher browser.* seit Chrome 148 
browser.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Wird ausgelöst, wenn sich ein oder mehrere Elemente ändern.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (changes: object) => void

    • Änderungen

      Objekt