chrome.system.storage

Description

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

Autorisations

system.storage

Types

EjectDeviceResultCode

Énumération

"success"
La commande d'exclusion a abouti : 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'a pas été exécutée sur l'appareil.

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

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

StorageAvailableCapacityInfo

Propriétés

  • availableCapacity

    Nombre

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

  • id

    chaîne

    id copié pour le paramètre de la 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 l'appareil de stockage. Cet ID est persistant au cours de la même exécution d'une seule 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 support de l'unité de stockage.

StorageUnitType

Énumération

"fixe"
L'espace de stockage contient des supports fixes, tels que disque dur ou SSD.

"removable"
L'espace de stockage est amovible (par exemple, sur une clé USB.

"unknown"
Type de stockage inconnu.

Méthodes

ejectDevice()

<ph type="x-smartling-placeholder"></ph> Promesse 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

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

Paramètres

Renvoie

  • Promise&lt;EjectDeviceResultCode&gt;

    Chrome 91 ou version ultérieure

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

getAvailableCapacity()

<ph type="x-smartling-placeholder"></ph> Promesse Version en développement 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

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

Paramètres

Renvoie

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

getInfo()

<ph type="x-smartling-placeholder"></ph> 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&lt;StorageUnitInfo[]&gt;

    Chrome 91 ou version ultérieure

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

É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

    fonction

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

    (id: string) => void

    • id

      chaîne