chrome.system.storage

refresh date: 2026-09-25 robots: noindex

Описание

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

Разрешения

system.storage

Типы

EjectDeviceResultCode

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

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

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

"no_such_device"
Устройство не найдено.

"failure"
Не удалось выполнить команду извлечения.

StorageAvailableCapacityInfo

Свойства

  • availableCapacity

    число

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

  • id

    string

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

StorageUnitInfo

Свойства

  • мощность

    число

    Общий объем хранилища в байтах.

  • id

    string

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

  • name

    string

    Название склада.

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

StorageUnitType

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

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

"removable"
Съемный накопитель, например USB-накопитель.

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

Методы

ejectDevice()

Promise 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
): Promise<EjectDeviceResultCode>

Извлекает съемный накопитель.

Параметры

  • id

    string

  • обратный вызов

    function необязательно

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

    (result: EjectDeviceResultCode) => void

Возвраты

  • Chrome 91 и более поздних версий

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

getAvailableCapacity()

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

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

Параметры

Возвраты

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

getInfo()

Promise 
chrome.system.storage.getInfo(
  callback?: function,
): Promise<StorageUnitInfo[]>

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

Параметры

  • обратный вызов

    function необязательно

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

    (info: StorageUnitInfo[]) => void

Возвраты

  • Promise<StorageUnitInfo[]>

    Chrome 91 и более поздних версий

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

События

onAttached

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

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

Параметры

  • обратный вызов

    function

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

    (info: StorageUnitInfo) => void

onDetached

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

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

Параметры

  • обратный вызов

    function

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

    (id: string) => void

    • id

      string