Зона хранения

Интерфейс StorageArea используется API chrome.storage .

Методы

clear()

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

Удаляет все товары со склада.

Возвраты

  • Обещание<пустота>

    Chrome 95+

    Обещание, которое выполняется в случае успеха или отвергается в случае неудачи.

get()

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

Извлекает один или несколько предметов со склада.

Параметры

  • ключи

    строка | строка[] | объект (необязательно)

    Ключ для получения, список ключей для получения или словарь, определяющий значения по умолчанию (см. описание объекта). Пустой список или объект вернет пустой объект результата. Передайте null , чтобы получить все содержимое хранилища.

Возвраты

  • Promise<object>

    Chrome 95+

    Промис, который разрешается с выводом объекта, содержащего карту ключ-значение для запрошенных элементов, или отклоняется в случае неудачи.

getBytesInUse()

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

Получает объем пространства (в байтах), используемого одним или несколькими элементами.

Параметры

  • ключи

    строка | строка[] необязательно

    Отдельный ключ или список ключей для получения общего объема использования. Пустой список вернет 0. Передайте null , чтобы получить общий объем использования всего хранилища.

Возвраты

  • Обещание<число>

    Chrome 95+

    Обещание, которое выполняется по мере увеличения объема используемого пространства хранилища, или отклоняется в случае неудачи.

getKeys()

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

Получает все ключи из хранилища.

Возвраты

  • Promise<string[]>

    Обещание, которое выполняется при наличии ключей хранения, или отклоняется в случае неудачи.

remove()

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

Удаляет один или несколько предметов со склада.

Параметры

  • ключи

    строка | строка[]

    Один ключ или список ключей для удаления предметов.

Возвраты

  • Обещание<пустота>

    Chrome 95+

    Обещание, которое выполняется в случае успеха или отвергается в случае неудачи.

set()

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

Задает несколько элементов.

Параметры

  • предметы

    объект

    Объект, предоставляющий каждую пару ключ/значение для обновления хранилища. Любые другие пары ключ/значение в хранилище останутся без изменений.

    Примитивные значения, такие как числа, будут сериализоваться должным образом. Значения с typeof "object" и "function" обычно сериализуются в фигурные скобки {} , за исключением Array (сериализуются должным образом), Date и Regex (сериализуются с использованием их String представления).

Возвраты

  • Обещание<пустота>

    Chrome 95+

    Обещание, которое выполняется в случае успеха или отвергается в случае неудачи.

setAccessLevel()

Chrome 102+
chrome.storage.StorageArea.setAccessLevel(
  accessOptions: object,
): Promise<void>

Задает желаемый уровень доступа к области хранения. По умолчанию доступ к хранилищу session ограничен доверенными контекстами (страницами расширений и сервисными работниками), в то время как доступ к managed , local и sync хранилищу разрешен как из доверенных, так и из недоверенных контекстов.

Параметры

  • accessOptions

    объект

Возвраты

  • Обещание<пустота>

    Обещание, которое выполняется в случае успеха или отвергается в случае неудачи.

События

onChanged

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

Срабатывает при изменении одного или нескольких элементов.

Параметры

  • перезвонить

    функция

    Параметр callback выглядит следующим образом: 

    (changes: object) => void

    • изменения

      объект