StorageArea

refresh date: 2026-09-25 robots: noindex

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

  function optional

  Der Parameter callback sieht so aus:

  () => void

Ausgabe

• Promise<void>

  Chrome 95 oder höher

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

  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 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.

• callback

  function optional

  Der Parameter callback sieht so aus:

  (items: object) => void

  • Elemente

    Objekt

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

Ausgabe

• Promise<object>

  Chrome 95 oder 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.

  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 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.

• callback

  function optional

  Der Parameter callback sieht so aus:

  (bytesInUse: number) => void

  • bytesInUse

    Zahl

    Die Menge des verwendeten Speicherplatzes in Byte.

Ausgabe

• Promise<number>

  Chrome 95 oder höher

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

  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

  function 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[]>

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

  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 zu entfernende Elemente.

• callback

  function optional

  Der Parameter callback sieht so aus:

  () => void

Ausgabe

• Promise<void>

  Chrome 95 oder höher

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

  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 zu {} serialisiert, mit Ausnahme von Array (wird wie erwartet serialisiert), Date und Regex (werden mit ihrer String-Darstellung serialisiert).

• callback

  function optional

  Der Parameter callback sieht so aus:

  () => void

Ausgabe

• Promise<void>

  Chrome 95 oder höher

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

  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 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.

• callback

  function optional

  Der Parameter callback sieht so aus:

  () => void

Ausgabe

• Promise<void>

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

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

Ereignisse

onChanged

Chrome 73 oder 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