browser.system.storage

תיאור

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

הרשאות

system.storage

סוגים

EjectDeviceResultCode

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

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

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

"no_such_device"
אין מכשיר כזה.

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

StorageAvailableCapacityInfo

מאפיינים

• availableCapacity

  number

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

• id [מזהה]

  מחרוזת

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

StorageUnitInfo

מאפיינים

• תפוסה

  number

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

• id [מזהה]

  מחרוזת

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

• שם

  מחרוזת

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

• סוג

  StorageUnitType

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

StorageUnitType

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

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

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

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

Methods

ejectDevice()

browser.system.storage.ejectDevice(
  id: string,
): Promise<EjectDeviceResultCode>

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

פרמטרים

• id [מזהה]

  מחרוזת

החזרות

• Promise<EjectDeviceResultCode>

  ‫Chrome 91 ואילך ‫browser.* ‎ מגרסה 148 של Chrome

getAvailableCapacity()

ערוץ Dev

browser.system.storage.getAvailableCapacity(
  id: string,
): Promise<StorageAvailableCapacityInfo>

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

פרמטרים

• id [מזהה]

  מחרוזת

החזרות

• ‫Promise<StorageAvailableCapacityInfo>

getInfo()

browser.system.storage.getInfo(): Promise<StorageUnitInfo[]>

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

החזרות

• Promise<StorageUnitInfo[]>

  ‫Chrome 91 ואילך ‫browser.* ‎ מגרסה 148 של Chrome

אירועים

onAttached

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

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

פרמטרים

• callback

  פונקציה

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

  (info: StorageUnitInfo) => void

  • מידע

    StorageUnitInfo

onDetached

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

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

פרמטרים

• callback

  פונקציה

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

  (id: string) => void

  • id [מזהה]

    מחרוזת