storage.managed

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

Настройка управляемого хранилища

Процедура настройки управляемого хранилища варьируется в разных браузерах. Инструкции для Chrome см. в статье "Manifest для областей хранилища".

Для Firefox необходимо создать файл манифеста JSON в определенном формате и расположении. Подробности синтаксиса и расположения манифеста см. в разделе Нативные манифесты.

Вот пример манифеста:

{
  "name": "favourite-colour-examples@mozilla.org",
  "description": "ignored",
  "type": "storage",
  "data": {
    "colour": "management thinks it should be blue!"
  }
}

С этим манифестом расширение favourite-colour может получить доступ к данным с помощью кода, подобного этому:

let storageItem = browser.storage.managed.get('colour');
storageItem.then((res) => {
  console.log(`Managed colour is: ${res.colour}`);
});

Методы

Объект managed реализует методы, определённые для типа storage.StorageArea:

storage.managed.get(): Извлекает один или несколько элементов из области хранилища.
storage.managed.getBytesInUse(): Получает объём занимаемого места (в байтах) одного или нескольких элементов в области хранилища.

События

Объект managed реализует события, определённые для типа storage.StorageArea:

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

Примеры расширений

favourite-colour

Совместимость с браузерами

	Рабочий стол						Мобильные устройства
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet
`managed`	Да	79	57 ["Платформенно-зависимые механизмы хранения, такие как ключи реестра Windows, не поддерживаются.", "Не поддерживается проверка схем хранения, предоставляемых расширениями.", "Событие `onChanged` не поддерживается."]	?	Нет	Нет	?	?	Нет	?	Нет	?

Примечание: Этот API основан на API chrome.storage Chromium. Данная документация взята из storage.json кода Chromium.

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Mozilla/Add-ons/WebExtensions/API/storage/managed