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

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

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

    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()

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

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

getKeys()

Chrome 130 und höher 
chrome.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()

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

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

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

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

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>

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

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