StorageArea

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

Methoden

clear()

Promise 
chrome.storage.StorageArea.clear(
  callback?: function,
): Promise<void>

Entfernt alle Elemente aus dem Speicher.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 95 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

get()

Promise 
chrome.storage.StorageArea.get(
  keys?: string | string[] | object,
  callback?: function,
): 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.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (items: object) => void

    • Elemente

      Objekt

      Objekt mit Elementen in den zugehörigen Schlüssel/Wert-Zuordnungen.

Ausgabe

  • Promise<object>

    Chrome 95 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getBytesInUse()

Promise 
chrome.storage.StorageArea.getBytesInUse(
  keys?: string | string[],
  callback?: function,
): 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.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (bytesInUse: number) => void

    • bytesInUse

      Zahl

      Die Menge des verwendeten Speichers in Byte.

Ausgabe

  • Promise<number>

    Chrome 95 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getKeys()

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

Ruft alle Schlüssel aus dem Speicher ab.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (keys: string[]) => void

    • Schlüssel

      String[]

      Array mit Schlüsseln, die aus dem Speicher gelesen wurden.

Ausgabe

  • Promise<string[]>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

remove()

Promise 
chrome.storage.StorageArea.remove(
  keys: string | string[],
  callback?: function,
): 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.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 95 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

set()

Promise 
chrome.storage.StorageArea.set(
  items: object,
  callback?: function,
): 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).

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 95 und höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

setAccessLevel()

Promise Chrome 102+ 
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
  callback?: function,
): 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.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

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