Описание
Используйте API chrome.system.storage
для запроса информации об устройстве хранения и получения уведомлений о подключении и отключении съемного устройства хранения.
Разрешения
system.storage
Типы
EjectDeviceResultCode
Перечисление
"успех" "в_использовании" "нет_такого_устройства" "отказ"
Команда извлечения выполнена успешно — приложение может предложить пользователю удалить устройство.
Устройство используется другим приложением. Катапультирование не удалось; пользователь не должен удалять устройство до тех пор, пока другое приложение не завершит работу с устройством.
Такое устройство не известно.
Команда на выброс не удалась.
StorageAvailableCapacityInfo
Характеристики
- доступная емкость
число
Доступная емкость устройства хранения в байтах.
- идентификатор
нить
Скопированный
id
идентификатораid
функции getAvailableCapacity.
StorageUnitInfo
Характеристики
- емкость
число
Общий объем дискового пространства в байтах.
- идентификатор
нить
Временный идентификатор, который однозначно идентифицирует устройство хранения. Этот идентификатор будет постоянным в течение одного запуска одного приложения. Он не будет постоянным идентификатором между различными запусками приложения или между разными приложениями.
- имя
нить
Имя единицы хранения.
Тип носителя устройства хранения.
StorageUnitType
Перечисление
"зафиксированный" "съемный" "неизвестный"
Хранилище имеет фиксированный носитель, например жесткий диск или твердотельный накопитель.
Память может быть съемной, например USB-накопитель.
Тип хранилища неизвестен.
Методы
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
Извлекает съемное запоминающее устройство.
Параметры
- идентификатор
нить
- перезвонить
функция необязательна
Параметр
callback
выглядит так:(result: EjectDeviceResultCode) => void
- результат
Возврат
Обещание < EjectDeviceResultCode >
Хром 91+Промисы поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
)
Получите доступную емкость устройства хранения с указанным id
. id
— это временный идентификатор устройства из StorageUnitInfo.
Параметры
- идентификатор
нить
- перезвонить
функция необязательна
Параметр
callback
выглядит так:(info: StorageAvailableCapacityInfo) => void
- информация
Возврат
Обещание < StorageAvailableCapacityInfo >
Промисы поддерживаются только для Manifest V3 и более поздних версий, на других платформах необходимо использовать обратные вызовы.
getInfo()
chrome.system.storage.getInfo(
callback?: function,
)
Получите информацию о хранилище из системы. Аргумент, передаваемый обратному вызову, представляет собой массив объектов 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
- идентификатор
нить