chrome.system.storage

Aktualisierungsdatum: 2026-09-25 robots: noindex

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 getrennt wird.

Berechtigungen

system.storage

Typen

EjectDeviceResultCode

Enum

„success“
Der Befehl zum Auswerfen 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 die Verwendung des Geräts beendet hat.

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

„failure“
Der Auswurf-Befehl ist fehlgeschlagen.

StorageAvailableCapacityInfo

Attribute

  • availableCapacity

    Zahl

    Die verfügbare Kapazität des Speichermediums in Byte.

  • id

    String

    Eine kopierte id des Funktionsparameters id von getAvailableCapacity.

StorageUnitInfo

Attribute

  • Kapazität

    Zahl

    Die Gesamtmenge des Speicherplatzes in Byte.

  • id

    String

    Die temporäre ID, die das Speichermedium eindeutig identifiziert. Diese ID bleibt innerhalb desselben Laufs einer einzelnen Anwendung bestehen. 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 hat feste Medien, z.B. eine Festplatte oder SSD.

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

„unknown“
Der Speichertyp ist unbekannt.

Methoden

ejectDevice()

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

Wirft ein Wechselmedium aus.

Parameter

Ausgabe

  • Chrome 91 und höher

    Promises 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,
): Promise<StorageAvailableCapacityInfo>

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

Parameter

Ausgabe

  • Promises 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,
): Promise<StorageUnitInfo[]>

Speicherinformationen vom System abrufen Das an den Callback übergebene Argument ist ein Array von StorageUnitInfo-Objekten.

Parameter

Ausgabe

  • Promise<StorageUnitInfo[]>

    Chrome 91 und höher

    Promises 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