chrome.system.storage

תאריך הרענון: 2026-09-25 robots: noindex

תיאור

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

הרשאות

system.storage

סוגים

EjectDeviceResultCode

ספירה

‫success
הפקודה להוצאת המכשיר הצליחה – האפליקציה יכולה להציג למשתמש הנחיה להסרת המכשיר.

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

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

'failure'
הפקודה להוצאת הדיסק נכשלה.

StorageAvailableCapacityInfo

מאפיינים

  • availableCapacity

    number

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

  • id [מזהה]

    מחרוזת

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

StorageUnitInfo

מאפיינים

  • קיבולת

    number

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

  • id [מזהה]

    מחרוזת

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

  • שם

    מחרוזת

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

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

StorageUnitType

ספירה

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

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

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

Methods

ejectDevice()

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

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

פרמטרים

החזרות

  • ‫Chrome 91 ואילך

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

getAvailableCapacity()

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

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

פרמטרים

החזרות

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

getInfo()

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

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

פרמטרים

החזרות

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

      מחרוזת