chrome.system.storage

Описание

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

Разрешения

system.storage

Типы

EjectDeviceResultCode

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

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

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

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

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

StorageAvailableCapacityInfo

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

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

    число

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

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

    нить

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

StorageUnitInfo

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

  • емкость

    число

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

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

    нить

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

  • имя

    нить

    Наименование единицы хранения.

  • Тип носителя единицы хранения.

StorageUnitType

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

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

"съемный"
В качестве носителя информации можно использовать съемный носитель, например USB-флеш-накопитель.

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

Методы

ejectDevice()

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

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

Параметры

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

    нить

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

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

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

    (result: EjectDeviceResultCode) => void

Возврат

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

    Хром 91+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

getAvailableCapacity()

Канал Promise Dev
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
): Promise<StorageAvailableCapacityInfo>

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

Параметры

Возврат

getInfo()

Обещать
chrome.system.storage.getInfo(
  callback?: function,
): Promise<StorageUnitInfo[]>

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

Параметры

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

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

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

    (info: StorageUnitInfo[]) => void

Возврат

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

    Хром 91+

    Обещания поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.

События

onAttached

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

Срабатывает при подключении к системе нового съемного носителя.

Параметры

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

    функция

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

    (info: StorageUnitInfo) => void

onDetached

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

Срабатывает при отсоединении съемного носителя от системы.

Параметры

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

    функция

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

    (id: string) => void

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

      нить