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 getAvailableCapacityid
.
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
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()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
Éjecte un périphérique de stockage amovible.
Paramètres
-
id
chaîne
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(result: EjectDeviceResultCode) => void
-
résultat
-
Renvoie
-
Promise<EjectDeviceResultCode>
Chrome 91 et versions ultérieuresLes 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()
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
-
id
chaîne
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(info: StorageAvailableCapacityInfo) => void
Renvoie
-
Promise<StorageAvailableCapacityInfo>
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()
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
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(info: StorageUnitInfo[]) => void
-
infos
-
Renvoie
-
Promise<StorageUnitInfo[]>
Chrome 91 et versions ultérieuresLes 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
-
rappel
function
Le paramètre
callback
se présente comme suit :(info: StorageUnitInfo) => void
-
infos
-
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
-