Opis
Użyj interfejsu API chrome.system.storage
, aby zapytać o informacje dotyczące urządzenia pamięci masowej i otrzymać powiadomienie, gdy urządzenie pamięci wymiennej zostanie podłączone lub odłączone.
Uprawnienia
system.storage
Typy
EjectDeviceResultCode
Typ wyliczeniowy
"success"
Polecenie wyjęcia zostało wykonane – aplikacja może poprosić użytkownika o wyjęcie urządzenia.
„in_use”
Urządzenie jest używane przez inną aplikację. Nie udało się wyjąć urządzenia; użytkownik nie powinien go wyjmować, dopóki inne aplikacje nie skończą z użyciem tego urządzenia.
"no_such_device"
Nie ma takiego urządzenia.
„failure”
Nie udało się wykonać polecenia wyrzucania.
StorageAvailableCapacityInfo
Właściwości
-
availableCapacity
liczba
Dostępna pojemność urządzenia pamięci masowej w bajtach.
-
id
ciąg znaków
Skopiowany parametr
id
funkcji getAvailableCapacityid
.
StorageUnitInfo
Właściwości
-
wydajność
liczba
Łączna ilość miejsca na dane w bajtach.
-
id
ciąg znaków
Tymczasowy identyfikator, który jednoznacznie identyfikuje urządzenie pamięci masowej. Ten identyfikator będzie trwały w ramach tego samego uruchomienia aplikacji. Nie będzie to trwały identyfikator między różnymi wersjami aplikacji ani między różnymi aplikacjami.
-
nazwa
ciąg znaków
Nazwa jednostki pamięci masowej.
-
typ
Typ mediów w jednostce pamięci.
StorageUnitType
Typ wyliczeniowy
„fixed” (przewiźnia)
Pamięć ma nośnik danych, np. dysk twardy lub SSD.
„removable” (usuwalny)
Nośnik jest wymienny, np. dysk flash USB.
„unknown” (nieznany)
Nieznany typ miejsca zapisu.
Metody
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
Wyrzucanie urządzenia pamięci wymiennej.
Parametry
-
id
ciąg znaków
-
wywołanie zwrotne
function opcjonalny
Parametr
callback
ma postać:(result: EjectDeviceResultCode) => void
-
wynik
-
Zwroty
-
Promise<EjectDeviceResultCode>
Chrome 91 lub nowszyObietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
)
Pobierz informacje o dostępnej pojemności określonego urządzenia pamięci masowej id
. Wartość id
to tymczasowy identyfikator urządzenia z StorageUnitInfo.
Parametry
-
id
ciąg znaków
-
wywołanie zwrotne
function opcjonalny
Parametr
callback
ma postać:(info: StorageAvailableCapacityInfo) => void
-
informacje
-
Zwroty
-
Obietnica<StorageAvailableCapacityInfo>
Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.
getInfo()
chrome.system.storage.getInfo(
callback?: function,
)
Pobierz informacje o miejscu na dane z systemu. Argument przekazywany do funkcji wywołania zwrotnego to tablica obiektów StorageUnitInfo.
Parametry
-
wywołanie zwrotne
function opcjonalny
Parametr
callback
ma postać:(info: StorageUnitInfo[]) => void
-
informacje
-
Zwroty
-
Promise<StorageUnitInfo[]>
Chrome 91 lub nowszyObietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.
Wydarzenia
onAttached
chrome.system.storage.onAttached.addListener(
callback: function,
)
Wywoływany, gdy do systemu podłączona jest nowa karta pamięci.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
ma postać:(info: StorageUnitInfo) => void
-
informacje
-
onDetached
chrome.system.storage.onDetached.addListener(
callback: function,
)
Wywoływane, gdy pamięć wymienna zostanie odłączona od systemu.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
ma postać:(id: string) => void
-
id
ciąg znaków
-