chrome.system.storage

дата обновления: 2026-09-25 robots: noindex

Описание

Используйте 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

Возвраты

  • Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getAvailableCapacity()

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

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

Параметры

Возвраты

  • Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getInfo()

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

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

Параметры

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

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

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

    (info: StorageUnitInfo[]) => void

Возвраты

  • Promise< StorageUnitInfo []>

    Chrome 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

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

      нить