chrome.system.storage

Beschreibung

Mit der chrome.system.storage API können Sie Informationen zu Speichergeräten abfragen und sich benachrichtigen lassen, wenn ein Wechseldatenträger angeschlossen und getrennt wird.

Berechtigungen

system.storage

Typen

EjectDeviceResultCode

Enum

"success"
Der Ausschlussbefehl wurde ausgeführt. Die App kann den Nutzer zum Entfernen des Geräts auffordern.

"in_use"
Das Gerät wird von einer anderen Anwendung verwendet. Der Ausschluss war nicht erfolgreich. Der Nutzer sollte das Gerät erst entfernen, wenn die andere Anwendung die Nutzung des Geräts abgeschlossen hat.

"no_such_device"
Ein solches Gerät ist nicht bekannt.

"failure"
Der Ausschlussbefehl ist fehlgeschlagen.

StorageAvailableCapacityInfo

Attribute

  • availableCapacity

    Zahl

    Die verfügbare Kapazität des Speichergeräts in Byte.

  • id

    String

    id des getAvailableCapacity-Funktionsparameters id kopiert.

StorageUnitInfo

Attribute

  • Kapazität

    Zahl

    Die Gesamtmenge des Speicherplatzes in Byte.

  • id

    String

    Die temporäre ID, die das Speichergerät eindeutig identifiziert. Diese ID bleibt bei der Ausführung einer einzelnen Anwendung dauerhaft. Es ist keine dauerhafte Kennung für verschiedene Ausführungen einer Anwendung oder zwischen verschiedenen Anwendungen.

  • name

    String

    Der Name der Speichereinheit.

  • Der Medientyp der Speichereinheit.

StorageUnitType

Enum

"fixed"
Der Speicher enthält ein festes Medium, z.B. eine Festplatte oder SSD.

"removable"
Der Wechseldatenträger ist ein Wechselmedium, z.B. ein USB-Speicherstick.

"unknown"
Der Speichertyp ist unbekannt.

Methoden

ejectDevice()

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

Ein Wechseldatenträger wird ausgeworfen.

Parameters

Rückgaben

  • Chrome 91 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getAvailableCapacity()

Promise Entwicklerversion 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

Verfügbare Kapazität eines angegebenen id-Speichergeräts abrufen. Die id ist die vorübergehende Geräte-ID aus StorageUnitInfo.

Parameters

Rückgaben

  • Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

getInfo()

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

Rufen Sie die Speicherinformationen vom System ab. Das an den Callback übergebene Argument ist ein Array von StorageUnitInfo-Objekten.

Parameters

Rückgaben

  • Promise<StorageUnitInfo[]>

    Chrome 91 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks werden jedoch aus Gründen der Abwärtskompatibilität bereitgestellt. Sie können nicht beide in einem Funktionsaufruf verwenden. Das Promise wird mit demselben Typ aufgelöst, der an den Callback übergeben wird.

Veranstaltungen

onAttached

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

Wird ausgelöst, wenn ein neuer Wechseldatenträger an das System angeschlossen wird

Parameters

onDetached

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

Wird ausgelöst, wenn ein Wechseldatenträger vom System getrennt wird

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (id: string)=>void

    • id

      String