chrome.system.storage

refresh date: 2026-09-25 robots: noindex

Opis

Użyj interfejsu chrome.system.storage API, 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 wysuwania zostało wykonane – aplikacja może poprosić użytkownika o odłączenie urządzenia.

„in_use”
Urządzenie jest używane przez inną aplikację. Wysunięcie się nie powiodło. Użytkownik nie powinien usuwać urządzenia, dopóki inna aplikacja nie zakończy pracy z nim.

„no_such_device”
Nie ma takiego urządzenia.

„failure”
Nie udało się wykonać polecenia wysuwania.

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

    Tymczasowy identyfikator, który jednoznacznie identyfikuje urządzenie pamięci masowej. Ten identyfikator będzie stał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.

StorageUnitType

Typ wyliczeniowy

„fixed”
Pamięć ma stały nośnik, 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 urządzenie pamięci masowej.

Parametry

Zwroty

  • Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getAvailableCapacity()

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

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

Parametry

Zwroty

  • Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getInfo()

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

Pobierz informacje o pamięci masowej z systemu. Argumentem przekazywanym do wywołania zwrotnego jest tablica obiektów StorageUnitInfo.

Parametry

Zwroty

  • Promise<StorageUnitInfo[]>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onAttached

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

Wywoływane, gdy do systemu zostanie podłączony nowy nośnik wymienny.

Parametry

onDetached

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

Wydarzenie wywoływane, gdy pamięć wymienna zostanie odłączona od systemu.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (id: string) => void

    • id

      tekst