chrome.system.storage

Description

Utilisez l'API chrome.system.storage pour interroger les informations d'un périphérique de stockage et recevoir une notification lorsqu'un périphérique de stockage amovible est associé ou dissocié.

Autorisations

system.storage

Types

EjectDeviceResultCode

Enum

"success"
La commande d'éjection aboutit : l'application peut inviter l'utilisateur à supprimer l'appareil.

"in_use"
L'appareil est en cours d'utilisation par une autre application. L'exclusion a échoué. L'utilisateur ne doit pas retirer l'appareil tant que l'autre application n'en a pas terminé.

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

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

StorageAvailableCapacityInfo

Propriétés

  • availableCapacity

    number

    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é

    number

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

  • id

    chaîne

    ID temporaire qui identifie de manière unique l'appareil de stockage. Cet ID sera persistant pendant 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.

  • name

    chaîne

    Nom de l'unité de stockage.

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

StorageUnitType

Enum

"fixed"
Le stockage comporte un support fixe, par exemple un disque dur ou un SSD.

"removable"
La mémoire de stockage doit être amovible (lecteur flash USB, par exemple).

"unknown"
Le type de stockage est inconnu.

Méthodes

ejectDevice()

Promesse 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

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

Paramètres

Renvoie

  • Chrome 91 et versions ultérieures

    Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

getAvailableCapacity()

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

Obtenir la capacité disponible d'un appareil de stockage id spécifié. id est l'ID temporaire d'appareil provenant de StorageUnitInfo.

Paramètres

Renvoie

  • Les promesses sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

getInfo()

Promesse 
chrome.system.storage.getInfo(
  callback?: function,
)

Obtenez les informations de stockage auprès 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 sont compatibles avec Manifest V3 et les versions ultérieures, mais des rappels sont fournis pour assurer la rétrocompatibilité. Vous ne pouvez pas utiliser les deux dans le même appel de fonction. La promesse est résolue avec le même type que celui transmis au rappel.

Événements

onAttached

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

Déclenché lorsqu'une nouvelle mémoire de stockage amovible est connectée au système

Paramètres

onDetached

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

Déclenché lorsqu'une mémoire de stockage amovible est dissociée du système

Paramètres

  • rappel

    function

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

    (id: string)=>void

    • id

      chaîne