browser.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 a échoué. L'utilisateur ne doit pas retirer l'appareil tant que l'autre application n'a pas terminé de l'utiliser.

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

"failure"
La commande d'éjection a échoué.

StorageAvailableCapacityInfo

Propriétés

  • availableCapacity

    nombre

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

  • id

    chaîne

    Une copie id du paramètre de fonction getAvailableCapacity id.

StorageUnitInfo

Propriétés

  • capacité

    nombre

    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 conservé pendant l'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 dispose d'un support fixe, par exemple un disque dur ou un SSD.

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

"unknown"
Le type de stockage est inconnu.

Méthodes

ejectDevice()

browser.system.storage.ejectDevice(
  id: string,
): Promise<EjectDeviceResultCode>

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

Paramètres

  • id

    chaîne

Renvoie

getAvailableCapacity()

Version en développement 
browser.system.storage.getAvailableCapacity(
  id: string,
): Promise<StorageAvailableCapacityInfo>

Obtenez la capacité disponible d'un périphérique de stockage id spécifié. id est l'ID de l'appareil temporaire de StorageUnitInfo.

Paramètres

  • id

    chaîne

Renvoie

getInfo()

browser.system.storage.getInfo(): Promise<StorageUnitInfo[]>

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

Renvoie

  • Promise<StorageUnitInfo[]>

    Chrome 91 et versions ultérieures browser.* depuis Chrome 148

Événements

onAttached

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

Se déclenche lorsqu'un nouveau stockage amovible est associé au système.

Paramètres

onDetached

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

Déclenché lorsqu'un espace de stockage amovible est déconnecté du système.

Paramètres

  • callback

    fonction

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

    (id: string) => void

    • id

      chaîne