chrome.system.storage

תיאור

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

הרשאות

system.storage

סוגים

EjectDeviceResultCode

Enum

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

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

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

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

StorageAvailableCapacityInfo

מאפיינים

  • availableCapacity

    number

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

  • id [מזהה]

    string

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

StorageUnitInfo

מאפיינים

  • קיבולת

    number

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

  • id [מזהה]

    string

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

  • שם

    string

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

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

StorageUnitType

Enum

'קבוע'
האחסון כולל מדיה קבועה, למשל דיסק קשיח או SSD.

'removable'
האחסון נשלף, למשל כונן USB.

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

Methods

ejectDevice()

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

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

פרמטרים

החזרות

  • Chrome מגרסה 91 ואילך

    יש תמיכה ב-Promises רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

getAvailableCapacity()

Promise ערוץ פיתוח 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

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

פרמטרים

החזרות

  • יש תמיכה ב-Promises רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

getInfo()

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

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

פרמטרים

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

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

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

    (info: StorageUnitInfo[]) => void

החזרות

  • Promise<StorageUnitInfo[]>

    Chrome מגרסה 91 ואילך

    יש תמיכה ב-Promises רק ב-Manifest V3 ואילך. בפלטפורמות אחרות צריך להשתמש ב-callbacks.

אירועים

onAttached

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

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

פרמטרים

onDetached

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

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

פרמטרים

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

    פונקציה

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

    (id: string) => void

    • id [מזהה]

      string