StorageArea

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

Methoden

clear()

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

Entfernt alle Elemente aus dem Speicher.

Ausgabe

  • Promise<void>

    Chrome 95 und höher

get()

chrome.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 Dictionary mit Standardwerten (siehe Beschreibung des Objekts). Bei einer leeren Liste oder einem leeren Objekt wird ein leeres Ergebnisobjekt zurückgegeben. Übergeben Sie null, um den gesamten Inhalt des Speichers abzurufen.

Ausgabe

  • Promise<object>

    Chrome 95 und höher

getBytesInUse()

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

Ruft die von einem oder mehreren Elementen verwendete Speichermenge (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. Bei einer leeren Liste wird 0 zurückgegeben. Übergeben Sie null, um die Gesamtnutzung des gesamten Speichers zu erhalten.

Ausgabe

  • Promise<number>

    Chrome 95 und höher

getKeys()

Chrome 130 und höher 
chrome.storage.StorageArea.getKeys(): Promise<string[]>

Ruft alle Schlüssel aus dem Speicher ab.

Ausgabe

  • Promise<string[]>

remove()

chrome.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 die zu entfernenden Elemente.

Ausgabe

  • Promise<void>

    Chrome 95 und höher

set()

chrome.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 als {} 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

setAccessLevel()

Chrome 102 und höher 
chrome.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 Zugriff sowohl von vertrauenswürdigen als auch von nicht vertrauenswürdigen Kontexten ermöglicht.

Parameter

  • accessOptions

    Objekt

    • accessLevel

      AccessLevel

      Die Zugriffsebene des Speicherbereichs.

Ausgabe

  • Promise<void>

Ereignisse

onChanged

Chrome 73 und höher 
chrome.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