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 ist erfolgreich. Die App kann den Nutzer auffordern, das Gerät zu entfernen.

"in_use"
Das Gerät wird von einer anderen Anwendung verwendet. Der Ausschluss ist fehlgeschlagen. Der Nutzer sollte das Gerät erst entfernen, wenn die andere App mit dem Gerät fertig ist.

"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

    Eine kopierte id des getAvailableCapacity-Funktionsparameters id.

StorageUnitInfo

Attribute

  • Kapazität

    Zahl

    Die Gesamtmenge des Speicherplatzes in Byte.

  • id

    String

    Die vorübergehende ID, die das Speichergerät eindeutig identifiziert. Diese ID wird bei der Ausführung einer einzelnen Anwendung dauerhaft beibehalten. Es handelt sich nicht um eine 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 enthält feste Medien, z.B. Festplatte oder SSD ein.

"entfernbar"
Der Speicher kann entfernt werden, z.B. einen USB-Speicherstick.

"unknown"
Der Speichertyp ist unbekannt.

Methoden

ejectDevice()

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

Ein Wechseldatenträger wird ausgeworfen.

Parameter

Gibt Folgendes zurück:

  • Promise&lt;EjectDeviceResultCode&gt;

    Chrome 91 und höher

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

getAvailableCapacity()

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

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

Parameter

Gibt Folgendes zurück:

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

getInfo()

<ph type="x-smartling-placeholder"></ph> 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.

Parameter

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (info: StorageUnitInfo[]) => void

Gibt Folgendes zurück:

  • Promise&lt;StorageUnitInfo[]&gt;

    Chrome 91 und höher

    Promise-Objekte 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 angehängt wird

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (info: StorageUnitInfo) => void

onDetached

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

Wird ausgelöst, wenn ein Wechselmedium vom System getrennt wurde

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

    (id: string) => void

    • id

      String