chrome.system.storage

תיאור

יש להשתמש ב-API chrome.system.storage כדי לשלוח שאילתות לגבי מידע על התקן האחסון ולקבל הודעה כשמחברים מכשיר אחסון נשלף ומנותקים.

הרשאות

system.storage

סוגים

EjectDeviceResultCode

טיפוסים בני מנייה (enum)

"success"
פקודת ההוצאה בוצעה בהצלחה – האפליקציה יכולה לבקש מהמשתמש להסיר את המכשיר.

"in_use"
המכשיר נמצא בשימוש של אפליקציה אחרת. ההוצאה נכשלה. המשתמש לא אמור להסיר את המכשיר עד שהאפליקציה האחרת תשלים עם המכשיר.

"no_such_device"
לא קיים מכשיר כזה.

"failure"
פקודת ההוצאה נכשלה.

StorageAvailableCapacityInfo

תכונות

• availableCapacity

  מספר

  הקיבולת הזמינה של מכשיר האחסון, בבייטים.

• id

  מחרוזת

  הועתק id של הפרמטר getAvailableCapacity id.

StorageUnitInfo

תכונות

• קיבולת

  מספר

  הנפח הכולל של נפח האחסון, בבייטים.

• id

  מחרוזת

  המזהה הזמני שמזהה באופן ייחודי את התקן האחסון. המזהה הזה יישמר באותה הפעלה של אפליקציה אחת. הוא לא יהיה מזהה קבוע בין הפעלות שונות של אפליקציה או בין אפליקציות שונות.

• name

  מחרוזת

  השם של יחידת האחסון.

• סוג

  StorageUnitType

  סוג המדיה של יחידת האחסון.

StorageUnitType

טיפוסים בני מנייה (enum)

"fixed"
בנפח האחסון יש מדיה קבועה, כמו דיסק קשיח או SSD.

"ניתן להסרה"
התקן האחסון נשלף, למשל כונן USB נייד.

'לא ידוע'
סוג האחסון לא ידוע.

שיטות

ejectDevice()

הבטחה

chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

מוציא התקן אחסון נשלף.

פרמטרים

• id

  מחרוזת

• קריאה חוזרת (callback)

  פונקציה אופציונלי

  הפרמטר callback נראה כך:

  (result: EjectDeviceResultCode)=>void

  • תוצאה אחת

    EjectDeviceResultCode

החזרות

• Promise<EjectDeviceResultCode>

  Chrome 91 ומעלה

  יש תמיכה בהבטחות במניפסט מגרסה V3 ואילך, אבל אפשר לבצע קריאה חוזרת (callback) לצורך תאימות לאחור. אי אפשר להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה מסתיימת עם אותו הסוג שמועבר לקריאה החוזרת.

getAvailableCapacity()

Promise ערוץ פיתוח

chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

קבלת הקיבולת הזמינה של מכשיר אחסון id שצוין. id הוא מזהה המכשיר זמני מ-StorageUnitInfo.

פרמטרים

• id

  מחרוזת

• קריאה חוזרת (callback)

  פונקציה אופציונלי

  הפרמטר callback נראה כך:

  (info: StorageAvailableCapacityInfo)=>void

  • מידע

    StorageAvailableCapacityInfo

החזרות

• Promise<StorageAvailableCapacityInfo>

  יש תמיכה בהבטחות במניפסט מגרסה V3 ואילך, אבל אפשר לבצע קריאה חוזרת (callback) לצורך תאימות לאחור. אי אפשר להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה מסתיימת עם אותו הסוג שמועבר לקריאה החוזרת.

getInfo()

הבטחה

chrome.system.storage.getInfo(
  callback?: function,
)

מקבלים את פרטי האחסון מהמערכת. הארגומנט שמועבר לקריאה חוזרת הוא מערך של אובייקטים של StorageUnitInfo.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה אופציונלי

  הפרמטר callback נראה כך:

  (info: StorageUnitInfo[])=>void

  • מידע

    StorageUnitInfo[]

החזרות

• Promise<StorageUnitInfo[]>

  Chrome 91 ומעלה

  יש תמיכה בהבטחות במניפסט מגרסה V3 ואילך, אבל אפשר לבצע קריאה חוזרת (callback) לצורך תאימות לאחור. אי אפשר להשתמש בשתיהן באותה בקשה להפעלת פונקציה. ההבטחה מסתיימת עם אותו הסוג שמועבר לקריאה החוזרת.

אירועים

onAttached

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

מופעל כשהתקן אחסון חדש נשלף חובר למערכת.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (info: StorageUnitInfo)=>void

  • מידע

    StorageUnitInfo

onDetached

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

מופעל כשהתקן אחסון נשלף מנותק מהמערכת.

פרמטרים

• קריאה חוזרת (callback)

  פונקציה

  הפרמטר callback נראה כך:

  (id: string)=>void

  • id

    מחרוזת