chrome.system.storage

Description

Utilisez l'API chrome.system.storage pour interroger les informations sur les périphériques de stockage et être averti lorsqu'un périphérique de stockage amovible est connecté ou déconnecté.

Autorisations

system.storage

Types

EjectDeviceResultCode

Énumération

"success"
La commande d'éjection a réussi. L'application peut inviter l'utilisateur à retirer l'appareil.

"in_use"
L'appareil est utilisé par une autre application. L'éjection n'a pas fonctionné. L'utilisateur ne doit pas retirer l'appareil tant que l'autre application ne l'a pas terminé.

"no_such_device"
Aucun appareil de ce type n'est connu.

"failure"
Échec de la commande d'éjection.

StorageAvailableCapacityInfo

Propriétés

  • availableCapacity

    Total

    Capacité disponible du périphérique de stockage, en octets.

  • id

    chaîne

    id copié du paramètre de fonction getAvailableCapacity id.

StorageUnitInfo

Propriétés

  • capacité

    Total

    Quantité totale d'espace de stockage, en octets.

  • id

    chaîne

    ID temporaire qui identifie de manière unique le périphérique de stockage. Cet ID sera persistant lors de la même exécution d'une même application. Il ne s'agit pas d'un identifiant persistant entre différentes exécutions d'une application ou entre différentes applications.

  • nom

    chaîne

    Nom de l'unité de stockage.

  • Type de contenu de l'unité de stockage.

StorageUnitType

Énumération

"fixed"
Le stockage est fixe (disque dur ou SSD, par exemple).

"removable"
Le stockage est amovible, par exemple une clé USB.

"unknown"
Le type de stockage est inconnu.

Méthodes

ejectDevice()

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

Éjecte un périphérique de stockage amovible.

Paramètres

Renvoie

  • Chrome 91 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getAvailableCapacity()

Promesse Version en développement 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
): Promise<StorageAvailableCapacityInfo>

Obtenez la capacité disponible d'un périphérique de stockage id spécifié. id correspond à l'ID d'appareil éphémère de StorageUnitInfo.

Paramètres

Renvoie

  • Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

getInfo()

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

Obtenez les informations de stockage du système. L'argument transmis au rappel est un tableau d'objets StorageUnitInfo.

Paramètres

Renvoie

  • Promise<StorageUnitInfo[]>

    Chrome 91 et versions ultérieures

    Les promesses ne sont compatibles qu'avec Manifest V3 et les versions ultérieures. Les autres plates-formes doivent utiliser des rappels.

Événements

onAttached

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

Déclenché lorsqu'un nouveau stockage amovible est connecté au système.

Paramètres

onDetached

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

Déclenché lorsqu'un stockage amovible est détaché du système.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    (id: string) => void

    • id

      chaîne