chrome.system.storage

Beschreibung

Verwenden Sie die chrome.system.storage API, um Informationen zu Speichergeräten abzufragen und benachrichtigt zu werden, wenn ein Wechseldatenträger angeschlossen oder getrennt wird.

Berechtigungen

system.storage

Typen

EjectDeviceResultCode

Enum

„success“
Der Auswurfbefehl war 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 war nicht erfolgreich. Der Nutzer sollte das Gerät erst entfernen, wenn die andere Anwendung das Gerät nicht mehr benötigt.

„no_such_device“
Es ist kein solches Gerät bekannt.

„failure“
Der Auswurfbefehl ist fehlgeschlagen.

StorageAvailableCapacityInfo

Attribute

  • availableCapacity

    Zahl

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

  • id

    String

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

StorageUnitInfo

Attribute

  • Kapazität

    Zahl

    Die Gesamtmenge des Speicherplatzes in Byte.

  • id

    String

    Die temporäre ID, mit der das Speichergerät eindeutig identifiziert wird. Diese ID bleibt innerhalb derselben Ausführung einer einzelnen Anwendung erhalten. Sie ist keine persistente Kennung zwischen verschiedenen Ausführungen einer Anwendung oder zwischen verschiedenen Anwendungen.

  • name

    String

    Der Name des Speichergeräts.

  • Der Medientyp des Speichergeräts.

StorageUnitType

Enum

„fixed“
Der Speicher verfügt über feste Medien, z.B. eine Festplatte oder SSD.

„removable“
Der Speicher ist abnehmbar, z.B. ein USB-Speicher.

„unbekannt“
Der Speichertyp ist unbekannt.

Methoden

ejectDevice()

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

Ein Wechseldatenträger wird ausgeworfen.

Parameter

Gibt Folgendes zurück:

  • Chrome 91 und höher

    Versprechen werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getAvailableCapacity()

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

Verfügbare Kapazität eines bestimmten id-Speichergeräts abrufen id ist die temporäre Geräte-ID aus StorageUnitInfo.

Parameter

Gibt Folgendes zurück:

  • Versprechen werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getInfo()

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

Speicherinformationen aus dem System abrufen Das an den Rückruf übergebene Argument ist ein Array von StorageUnitInfo-Objekten.

Parameter

Gibt Folgendes zurück:

  • Promise<StorageUnitInfo[]>

    Chrome 91 und höher

    Versprechen werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onAttached

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

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

Parameter

onDetached

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

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

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (id: string) => void

    • id

      String