chrome.system.storage

תיאור

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

הרשאות

system.storage

סוגים

EjectDeviceResultCode

Enum

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

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

"no_such_device"
לא ידוע על מכשיר כזה.

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

StorageAvailableCapacityInfo

מאפיינים

  • availableCapacity

    number

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

  • id [מזהה]

    מחרוזת

    בוצעה העתקה של id של פרמטר פונקציית getAvailableCapacity id.

StorageUnitInfo

מאפיינים

  • קיבולת

    number

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

  • id [מזהה]

    מחרוזת

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

  • שם

    מחרוזת

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

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

StorageUnitType

Enum

"קבוע"
באחסון יש מדיה קבועה, למשל. כונן קשיח או 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.

פרמטרים

החזרות

  • הבטחות נתמכות במניפסט מגרסה 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,
)

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

פרמטרים

onDetached

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

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

פרמטרים

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

    פונקציה

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

    (id: string) => void

    • id [מזהה]

      מחרוזת