תיאור
יש להשתמש ב-API chrome.system.storage
כדי לשלוח שאילתות לגבי מידע על התקן האחסון ולקבל הודעה כשמחברים מכשיר אחסון נשלף ומנותקים.
הרשאות
system.storage
סוגים
EjectDeviceResultCode
טיפוסים בני מנייה (enum)
"success"
פקודת ההוצאה בוצעה בהצלחה – האפליקציה יכולה לבקש מהמשתמש להסיר את המכשיר.
"in_use"
המכשיר נמצא בשימוש של אפליקציה אחרת. ההוצאה נכשלה. המשתמש לא אמור להסיר את המכשיר עד שהאפליקציה האחרת תשלים עם המכשיר.
"no_such_device"
לא קיים מכשיר כזה.
"failure"
פקודת ההוצאה נכשלה.
StorageAvailableCapacityInfo
תכונות
-
availableCapacity
מספר
הקיבולת הזמינה של מכשיר האחסון, בבייטים.
-
id
מחרוזת
הועתק
id
של הפרמטר getAvailableCapacityid
.
StorageUnitInfo
תכונות
-
קיבולת
מספר
הנפח הכולל של נפח האחסון, בבייטים.
-
id
מחרוזת
המזהה הזמני שמזהה באופן ייחודי את התקן האחסון. המזהה הזה יישמר באותה הפעלה של אפליקציה אחת. הוא לא יהיה מזהה קבוע בין הפעלות שונות של אפליקציה או בין אפליקציות שונות.
-
name
מחרוזת
השם של יחידת האחסון.
-
סוג
סוג המדיה של יחידת האחסון.
StorageUnitType
טיפוסים בני מנייה (enum)
"fixed"
בנפח האחסון יש מדיה קבועה, כמו דיסק קשיח או SSD.
"ניתן להסרה"
התקן האחסון נשלף, למשל כונן USB נייד.
'לא ידוע'
סוג האחסון לא ידוע.
שיטות
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
מוציא התקן אחסון נשלף.
פרמטרים
-
id
מחרוזת
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(result: EjectDeviceResultCode) => void
-
תוצאה אחת
-
החזרות
-
Promise<EjectDeviceResultCode>
Chrome 91 ומעלהיש תמיכה בהבטחות במניפסט מגרסה V3 ואילך, אבל אפשר לבצע קריאה חוזרת (callback) לצורך תאימות לאחור. אי אפשר להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה מסתיימת עם אותו הסוג שמועבר לקריאה החוזרת.
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
)
קבלת הקיבולת הזמינה של מכשיר אחסון id
שצוין. id
הוא מזהה המכשיר זמני מ-StorageUnitInfo.
פרמטרים
-
id
מחרוזת
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(info: StorageAvailableCapacityInfo) => void
החזרות
-
Promise<StorageAvailableCapacityInfo>
יש תמיכה בהבטחות במניפסט מגרסה V3 ואילך, אבל אפשר לבצע קריאה חוזרת (callback) לצורך תאימות לאחור. אי אפשר להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה מסתיימת עם אותו הסוג שמועבר לקריאה החוזרת.
getInfo()
chrome.system.storage.getInfo(
callback?: function,
)
מקבלים את פרטי האחסון מהמערכת. הארגומנט שמועבר לקריאה חוזרת הוא מערך של אובייקטים של StorageUnitInfo.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה אופציונלי
הפרמטר
callback
נראה כך:(info: StorageUnitInfo[]) => void
-
מידע
-
החזרות
-
Promise<StorageUnitInfo[]>
Chrome 91 ומעלהיש תמיכה בהבטחות במניפסט מגרסה V3 ואילך, אבל אפשר לבצע קריאה חוזרת (callback) לצורך תאימות לאחור. אי אפשר להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה מסתיימת עם אותו הסוג שמועבר לקריאה החוזרת.
אירועים
onAttached
chrome.system.storage.onAttached.addListener(
callback: function,
)
מופעל כשהתקן אחסון חדש נשלף חובר למערכת.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(info: StorageUnitInfo) => void
-
מידע
-
onDetached
chrome.system.storage.onDetached.addListener(
callback: function,
)
מופעל כשהתקן אחסון נשלף מנותק מהמערכת.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(id: string) => void
-
id
מחרוזת
-