browser.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 oder entfernt wird.

Berechtigungen

system.storage

Typen

EjectDeviceResultCode

Enum

"success"
Der Befehl zum Auswerfen ist erfolgreich. Die Anwendung kann den Nutzer auffordern, das Gerät zu entfernen.

"in_use"
Das Gerät wird von einer anderen Anwendung verwendet. Das Auswerfen ist fehlgeschlagen. Der Nutzer sollte das Gerät erst entfernen, wenn die andere Anwendung das Gerät nicht mehr verwendet.

"no_such_device"
Es ist kein solches Gerät bekannt.

"failure"
Der Befehl zum Auswerfen ist fehlgeschlagen.

StorageAvailableCapacityInfo

Attribute

  • availableCapacity

    Zahl

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

  • id

    String

    Eine kopierte id des Parameters id der Funktion „getAvailableCapacity“.

StorageUnitInfo

Attribute

  • Kapazität

    Zahl

    Die Gesamtgröße des Speicherplatzes in Byte.

  • id

    String

    Die vorübergehende ID, die das Speichergerät eindeutig identifiziert. Diese ID bleibt innerhalb derselben Ausführung einer einzelnen Anwendung erhalten. Sie ist keine dauerhafte Kennung zwischen verschiedenen Ausführungen einer Anwendung oder zwischen verschiedenen Anwendungen.

  • name

    String

    Der Name der Speichereinheit.

  • Der Medientyp der Speichereinheit.

StorageUnitType

Enum

"fixed"
Der Speicher hat feste Medien, z.B. Festplatte oder SSD.

"removable"
Der Speicher ist entfernbar, z.B. ein USB-Speicher.

"unknown"
Der Speichertyp ist unbekannt.

Methoden

ejectDevice()

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

Wirft ein Wechselmedium aus.

Parameter

  • id

    String

Ausgabe

getAvailableCapacity()

Entwicklerversion 
browser.system.storage.getAvailableCapacity(
  id: string,
): Promise<StorageAvailableCapacityInfo>

Rufen Sie die verfügbare Kapazität eines angegebenen id-Speichergeräts ab. id ist die temporäre Geräte-ID aus StorageUnitInfo.

Parameter

  • id

    String

Ausgabe

getInfo()

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

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

Ausgabe

  • Promise<StorageUnitInfo[]>

    Chrome 91 und höher browser.* seit Chrome 148

Ereignisse

onAttached

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

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

Parameter

onDetached

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

Wird ausgelöst, wenn ein Wechselmedium vom System getrennt wird.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (id: string) => void

    • id

      String