StorageArea

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

Metody

clear()

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

Usuwa wszystkie elementy z pamięci.

Zwroty

  • Promise<void>

    Chrome 95 lub nowsza

    Obietnica, która jest spełniana w przypadku powodzenia lub odrzucana w przypadku niepowodzenia.

get()

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

Pobiera co najmniej 1 element z pamięci.

Parametry

  • klucze

    string | string[] | object opcjonalny

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

Zwroty

  • Promise<object>

    Chrome 95 lub nowsza

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

getBytesInUse()

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

Pobiera ilość miejsca (w bajtach) zajmowanego przez co najmniej 1 element.

Parametry

  • klucze

    string | string[] opcjonalny

    Pojedynczy klucz lub lista kluczy, dla których chcesz uzyskać łączne wykorzystanie. Pusta lista zwróci wartość 0. Przekaż wartość null, aby uzyskać łączne wykorzystanie wszystkich miejsc na dane.

Zwroty

  • Promise<number>

    Chrome 95 lub nowsza

    Obietnica, która zwraca ilość miejsca używanego przez pamięć lub odrzuca żądanie w przypadku niepowodzenia.

getKeys()

Chrome 130 lub nowsza 
chrome.storage.StorageArea.getKeys(): Promise<string[]>

Pobiera wszystkie klucze z pamięci.

Zwroty

  • Promise<string[]>

    Obietnica, która jest spełniana w przypadku kluczy pamięci lub odrzucana w przypadku niepowodzenia.

remove()

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

Usuwa co najmniej 1 element z pamięci.

Parametry

  • klucze

    string | string[]

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

Zwroty

  • Promise<void>

    Chrome 95 lub nowsza

    Obietnica, która jest spełniana w przypadku powodzenia lub odrzucana w przypadku niepowodzenia.

set()

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

Ustawia wiele elementów.

Parametry

  • elementy

    obiekt

    Obiekt, który zawiera pary klucz-wartość do aktualizacji pamięci. Nie wpłynie to na inne pary klucz/wartość w pamięci.

    Wartości pierwotne, takie jak liczby, zostaną serializowane zgodnie z oczekiwaniami. Wartości ze znakami typeof, "object" i "function" są zwykle serializowane jako {}, z wyjątkiem znaków Array (serializowany zgodnie z oczekiwaniami), Date i Regex (serializowane przy użyciu reprezentacji String).

Zwroty

  • Promise<void>

    Chrome 95 lub nowsza

    Obietnica, która jest spełniana w przypadku powodzenia lub odrzucana w przypadku niepowodzenia.

setAccessLevel()

Chrome 102 lub nowsza 
chrome.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), a pamięć managed, local i sync umożliwia dostęp zarówno z zaufanych, jak i niezaufanych kontekstów.

Parametry

  • accessOptions

    obiekt

    • accessLevel

      AccessLevel

      Poziom dostępu do obszaru pamięci.

Zwroty

  • Promise<void>

    Obietnica, która jest spełniana w przypadku powodzenia lub odrzucana w przypadku niepowodzenia.

Wydarzenia

onChanged

Chrome 73 lub nowsza 
chrome.storage.StorageArea.onChanged.addListener(
  callback: function,
)

Wywoływane, gdy zmieni się co najmniej 1 element.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (changes: object) => void

    • poniższych zmian

      obiekt