StorageArea

refresh date: 2026-09-25 robots: noindex

Interfejs StorageArea jest używany przez interfejs API chrome.storage.

Metody

clear()

Obietnica

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

Usuwa wszystkie elementy z pamięci.

Parametry

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  () => void

Zwroty

• thought Promise<void>

  Chrome 95 lub nowsza wersja

  Obiekt Promise, który jest rozwiązywany w przypadku powodzenia lub odrzucany w przypadku niepowodzenia.

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

get()

Obietnica

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

Pobiera co najmniej 1 element z pamięci.

Parametry

• klucze

  string | string[] | object opcjonalnie

  Pojedynczy klucz do pobrania, lista kluczy do pobrania lub słownik określający wartości domyślne (patrz opis obiektu). Pusta lista lub obiekt zwraca pusty obiekt wynikowy. Przekaż null, aby uzyskać całą zawartość pamięci.

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (items: object) => void

  • elementy

    obiekt

    Obiekt z elementami w mapowaniach par klucz-wartość.

Zwroty

• Promise<object>

  Chrome 95 lub nowsza wersja

  Obiekt Promise, który zwraca obiekt zawierający mapę klucz-wartość dla żądanych elementów lub odrzuca żądanie w przypadku niepowodzenia.

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getBytesInUse()

Obietnica

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

Pobiera ilość miejsca (w bajtach) używanego przez co najmniej 1 element.

Parametry

• klucze

  string | string[] opcjonalnie

  Pojedynczy klucz lub lista kluczy, dla których chcesz uzyskać łączne wykorzystanie. Pusta lista zwraca 0. Przekaż null, aby uzyskać informacje o łącznym wykorzystaniu całego miejsca na dane.

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (bytesInUse: number) => void

  • bytesInUse

    liczba

    Ilość miejsca używanego w pamięci masowej (w bajtach).

Zwroty

• Promise<number>

  Chrome 95 lub nowsza wersja

  Obiekt Promise, który zwraca ilość miejsca używanego przez pamięć masową lub odrzuca w przypadku niepowodzenia.

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getKeys()

Promise Chrome 130 lub nowsza wersja

chrome.storage.StorageArea.getKeys(
  callback?: function,
): Promise<string[]>

Pobiera wszystkie klucze z pamięci.

Parametry

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  (keys: string[]) => void

  • klucze

    string[]

    Tablica z kluczami odczytanymi z pamięci.

Zwroty

• Promise<string[]>

  Obiekt Promise, który jest rozwiązywany za pomocą kluczy pamięci masowej lub odrzucany w przypadku niepowodzenia.

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

remove()

Obietnica

chrome.storage.StorageArea.remove(
  keys: string | string[],
  callback?: function,
): Promise<void>

Usuwa co najmniej 1 element z miejsca na dane.

Parametry

• klucze

  string | string[]

  Pojedynczy klucz lub lista kluczy elementów do usunięcia.

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  () => void

Zwroty

• thought Promise<void>

  Chrome 95 lub nowsza wersja

  Obiekt Promise, który jest rozwiązywany w przypadku powodzenia lub odrzucany w przypadku niepowodzenia.

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

set()

Obietnica

chrome.storage.StorageArea.set(
  items: object,
  callback?: function,
): Promise<void>

Ustawia wiele elementów.

Parametry

• elementy

  obiekt

  Obiekt, który podaje każdą parę klucz-wartość, za pomocą której można zaktualizować pamięć masową. Nie będzie to miało wpływu na inne pary klucz-wartość w pamięci.

  Wartości podstawowe, takie jak liczby, zostaną zserializowane zgodnie z oczekiwaniami. Wartości z typeof "object" i "function" będą zwykle serializowane do {}, z wyjątkiem Array (serializuje się zgodnie z oczekiwaniami), Date i Regex (serializują się przy użyciu reprezentacji String).

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  () => void

Zwroty

• thought Promise<void>

  Chrome 95 lub nowsza wersja

  Obiekt Promise, który jest rozwiązywany w przypadku powodzenia lub odrzucany w przypadku niepowodzenia.

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

setAccessLevel()

Promise Chrome 102 lub nowsza wersja

chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
  callback?: function,
): Promise<void>

Ustawia żądany poziom dostępu do obszaru pamięci. Domyślnie pamięć session jest ograniczona do zaufanych kontekstów (stron rozszerzeń i skryptów service worker), natomiast pamięci managed, local i sync umożliwiają dostęp zarówno z zaufanych, jak i niezaufanych kontekstów.

Parametry

• accessOptions

  obiekt

  • accessLevel

    AccessLevel

    Poziom dostępu do obszaru pamięci.

• callback

  function opcjonalne

  Parametr callback wygląda tak:

  () => void

Zwroty

• thought Promise<void>

  Obiekt Promise, który jest rozwiązywany w przypadku powodzenia lub odrzucany w przypadku niepowodzenia.

  Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onChanged

Chrome 73 lub nowsza wersja

chrome.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Uruchamiane, gdy co najmniej 1 element ulegnie zmianie.

Parametry

• callback

  funkcja

  Parametr callback wygląda tak:

  (changes: object) => void

  • poniższych zmian

    obiekt