chrome.system.storage

refresh date: 2026-09-25 robots: noindex

תיאור

אפשר להשתמש ב-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()

Promise

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

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

פרמטרים

• id [מזהה]

  מחרוזת

• callback

  function optional

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

  (result: EjectDeviceResultCode) => void

  • תוצאה

    EjectDeviceResultCode

החזרות

• Promise<EjectDeviceResultCode>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getAvailableCapacity()

Promise Dev channel

chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
): Promise<StorageAvailableCapacityInfo>

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

פרמטרים

• id [מזהה]

  מחרוזת

• callback

  function optional

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

  (info: StorageAvailableCapacityInfo) => void

  • מידע

    StorageAvailableCapacityInfo

החזרות

• ‫Promise<StorageAvailableCapacityInfo>

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

getInfo()

Promise

chrome.system.storage.getInfo(
  callback?: function,
): Promise<StorageUnitInfo[]>

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

פרמטרים

• callback

  function optional

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

  (info: StorageUnitInfo[]) => void

  • מידע

    StorageUnitInfo[]

החזרות

• Promise<StorageUnitInfo[]>

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

  הבטחות נתמכות רק ב-Manifest V3 ואילך, בפלטפורמות אחרות צריך להשתמש בקריאות חוזרות (callbacks).

אירועים

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 [מזהה]

    מחרוזת