chrome.system.storage

Описание

Используйте API chrome.system.storage для запроса информации об устройстве хранения и получения уведомлений о подключении и отключении съемного устройства хранения.

Разрешения

system.storage

Типы

EjectDeviceResultCode

Перечисление

"успех"
Команда извлечения выполнена успешно — приложение может предложить пользователю удалить устройство.

"в_использовании"
Устройство используется другим приложением. Катапультирование не удалось; пользователь не должен удалять устройство до тех пор, пока другое приложение не завершит работу с устройством.

"нет_такого_устройства"
Такое устройство не известно.

"отказ"
Команда на выброс не удалась.

StorageAvailableCapacityInfo

Характеристики

  • доступная емкость

    число

    Доступная емкость устройства хранения в байтах.

  • идентификатор

    нить

    Скопированный id идентификатора id функции getAvailableCapacity.

StorageUnitInfo

Характеристики

  • емкость

    число

    Общий объем дискового пространства в байтах.

  • идентификатор

    нить

    Временный идентификатор, который однозначно идентифицирует устройство хранения. Этот идентификатор будет постоянным в течение одного запуска одного приложения. Он не будет постоянным идентификатором между различными запусками приложения или между разными приложениями.

  • имя

    нить

    Имя единицы хранения.

  • Тип носителя устройства хранения.

StorageUnitType

Перечисление

"зафиксированный"
Хранилище имеет фиксированный носитель, например жесткий диск или твердотельный накопитель.

"съемный"
Память может быть съемной, например USB-накопитель.

"неизвестный"
Тип хранилища неизвестен.

Методы

ejectDevice()

Обещать
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

Извлекает съемное запоминающее устройство.

Параметры

Возврат

  • Обещание < EjectDeviceResultCode >

    Хром 91+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

getAvailableCapacity()

Канал разработчиков Promise
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

Получите доступную емкость устройства хранения с указанным id . id — это временный идентификатор устройства из StorageUnitInfo.

Параметры

Возврат

  • Обещание < StorageAvailableCapacityInfo >

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

getInfo()

Обещать
chrome.system.storage.getInfo(
  callback?: function,
)

Получите информацию о хранилище из системы. Аргумент, передаваемый обратному вызову, представляет собой массив объектов StorageUnitInfo.

Параметры

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

    функция необязательна

    Параметр callback выглядит так: 

    (info: StorageUnitInfo[]) => void

Возврат

  • Обещание< StorageUnitInfo []>

    Хром 91+

    Промисы поддерживаются в Манифесте V3 и более поздних версиях, но обратные вызовы предусмотрены для обратной совместимости. Вы не можете использовать оба при одном вызове функции. Промис разрешается с тем же типом, который передается в обратный вызов.

События

onAttached

chrome.system.storage.onAttached.addListener(
  callback: function,
)

Запускается, когда к системе подключается новый съемный накопитель.

Параметры

onDetached

chrome.system.storage.onDetached.addListener(
  callback: function,
)

Вызывается, когда съемный накопитель отсоединен от системы.

Параметры

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

    функция

    Параметр callback выглядит так: 

    (id: string) => void

    • идентификатор

      нить