StorageArea

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

Metody

clear()

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

Usuwa wszystkie elementy z pamięci.

Zwroty

  • thought Promise<void>

    Chrome 95 lub nowsza wersja browser.* od Chrome 148

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

get()

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

Zwroty

  • Promise<object>

    Chrome 95 lub nowsza wersja browser.* od Chrome 148

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

getBytesInUse()

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

Zwroty

  • Promise<number>

    Chrome 95 lub nowsza wersja browser.* od Chrome 148

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

getKeys()

Chrome 130 lub nowsza browser.* od Chrome 148 
browser.storage.StorageArea.getKeys(): Promise<string[]>

Pobiera wszystkie klucze z pamięci.

Zwroty

  • Promise<string[]>

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

remove()

browser.storage.StorageArea.remove(
  keys: string | string[],
): 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.

Zwroty

  • thought Promise<void>

    Chrome 95 lub nowsza wersja browser.* od Chrome 148

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

set()

browser.storage.StorageArea.set(
  items: object,
): 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).

Zwroty

  • thought Promise<void>

    Chrome 95 lub nowsza wersja browser.* od Chrome 148

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

setAccessLevel()

Chrome 102 lub nowsza browser.* od Chrome 148 
browser.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): 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.

Zwroty

  • thought Promise<void>

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

Wydarzenia

onChanged

Chrome 73 lub nowsza browser.* od Chrome 148 
browser.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