chrome.system.storage

refresh date: 2026-09-25 robots: noindex

Opis

Używaj interfejsu API chrome.system.storage, aby wysyłać zapytania o informacje o urządzeniu pamięci masowej i otrzymywać powiadomienia o podłączeniu i odłączeniu wymiennego urządzenia pamięci masowej.

Uprawnienia

system.storage

Typy

EjectDeviceResultCode

Typ wyliczeniowy

"success"
Polecenie wysunięcia zostało wykonane – aplikacja może poprosić użytkownika o usunięcie urządzenia.

"in_use"
Urządzenie jest używane przez inną aplikację. Nie udało się wysunąć urządzenia. Użytkownik nie powinien odłączać urządzenia, dopóki inna aplikacja nie zakończy z nim pracy.

"no_such_device"
Nie ma takiego urządzenia.

"failure"
Polecenie wysunięcia nie powiodło się.

StorageAvailableCapacityInfo

Właściwości

  • availableCapacity

    liczba

    Dostępna pojemność urządzenia pamięci masowej w bajtach.

  • id

    tekst

    Skopiowany parametr id funkcji getAvailableCapacity id.

StorageUnitInfo

Właściwości

  • wydajność

    liczba

    Łączna ilość miejsca na dane w bajtach.

  • id

    tekst

    Identyfikator tymczasowy, który jednoznacznie identyfikuje urządzenie pamięci masowej. Ten identyfikator będzie trwały w ramach tego samego uruchomienia pojedynczej aplikacji. Nie będzie to trwały identyfikator między różnymi uruchomieniami aplikacji ani między różnymi aplikacjami.

  • nazwa

    tekst

    Nazwa jednostki pamięci masowej.

  • Typ nośnika jednostki pamięci masowej.

StorageUnitType

Typ wyliczeniowy

"fixed"
Pamięć masowa ma stałe nośniki, np. dysk twardy lub SSD.

"removable"
Pamięć jest wymienna, np. dysk flash USB.

"unknown"
Typ pamięci jest nieznany.

Metody

ejectDevice()

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

Wysuwa wymienne urządzenie pamięci masowej.

Parametry

Zwroty

  • Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getAvailableCapacity()

Promise Wersja deweloperska 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
): Promise<StorageAvailableCapacityInfo>

Sprawdź dostępną pojemność określonego urządzenia pamięci masowej id. id to tymczasowy identyfikator urządzenia z StorageUnitInfo.

Parametry

Zwroty

  • Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getInfo()

Obietnica 
chrome.system.storage.getInfo(
  callback?: function,
): Promise<StorageUnitInfo[]>

pobierać informacje o pamięci z systemu, Argument przekazywany do wywołania zwrotnego to tablica obiektów StorageUnitInfo.

Parametry

Zwroty

  • Promise<StorageUnitInfo[]>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onAttached

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

Uruchamiane, gdy do systemu zostanie podłączona nowa pamięć wymienna.

Parametry

onDetached

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

Uruchamiane, gdy pamięć wymienna zostanie odłączona od systemu.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (id: string) => void

    • id

      tekst