chrome.system.storage

refresh date: 2026-09-25 robots: noindex

شرح

از chrome.system.storage API برای جستجوی اطلاعات دستگاه ذخیره‌سازی استفاده کنید و وقتی دستگاه ذخیره‌سازی جداشدنی متصل یا جدا می‌شود، مطلع شوید.

اجازه‌ها

system.storage

این اجازه هشداری را فعال می‌کند.

انواع

EjectDeviceResultCode

شمارشی

«موفقیت»
فرمان بیرون آوردن موفقیت‌آمیز است -- برنامه می‌تواند از کاربر بخواهد دستگاه را بردارد.

"in_use"
دستگاه درحال استفاده توسط برنامه دیگری است. خروج موفقیت‌آمیز نبود؛ کاربر نباید دستگاه را جدا کند تا زمانی که برنامه دیگر کارش با دستگاه تمام شود.

"no_such_device"
چنین دستگاهی وجود ندارد.

«failure»
فرمان خارج کردن ناموفق بود.

StorageAvailableCapacityInfo

مشخصات

• availableCapacity

  شماره

  ظرفیت دردسترس دستگاه ذخیره‌سازی، به بایت.

• id

  رشته

  id کپی‌شده از پارامتر تابع getAvailableCapacity id.

StorageUnitInfo

مشخصات

• ظرفیت

  شماره

  مقدار کل فضای ذخیره‌سازی، به بایت.

• id

  رشته

  شناسه گذرا که به‌طور منحصربه‌فرد دستگاه ذخیره‌سازی را شناسایی می‌کند. این شناسه در همان اجرای یک برنامه واحد ثابت خواهد بود. این شناسه بین اجراهای مختلف برنامه یا بین برنامه‌های مختلف پایدار نخواهد بود.

• نام

  رشته

  نام واحد ذخیره‌سازی.

• نوع

  StorageUnitType

  نوع رسانه واحد ذخیره‌سازی.

StorageUnitType

شمارشی

«ثابت»
فضای ذخیره‌سازی دارای رسانه ثابت است، مثلاً دیسک سخت یا SSD.

«removable»
فضای ذخیره‌سازی جداشدنی است، مثلاً حافظه فلش USB.

«نامشخص»
نوع فضای ذخیره‌سازی نامشخص است.

روش‌ها

ejectDevice()

قول

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

دستگاه ذخیره‌سازی جداشدنی را خارج می‌کند.

پارامترها

• id

  رشته

• تماس برگشتی

  تابع اختیاری

  پارامتر callback به‌صورت زیر است:

  (result: EjectDeviceResultCode) => void

  • نتیجه

    EjectDeviceResultCode

بازگشتی‌ها

• Promise<EjectDeviceResultCode>

  Chrome نسخه ۹۱ به بالا

  ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getAvailableCapacity()

Promise کانال برنامه‌نویس‌ها

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

دریافت ظرفیت دردسترس دستگاه ذخیره‌سازی id مشخص‌شده. ‫id شناسه دستگاه گذرا از StorageUnitInfo است.

پارامترها

• id

  رشته

• تماس برگشتی

  تابع اختیاری

  پارامتر callback به‌صورت زیر است:

  (info: StorageAvailableCapacityInfo) => void

  • اطلاعات

    StorageAvailableCapacityInfo

بازگشتی‌ها

• Promise<StorageAvailableCapacityInfo>

  ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

getInfo()

قول

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

اطلاعات فضای ذخیره‌سازی را از سیستم دریافت کنید. آرگومان ارسال‌شده به callback آرایه‌ای از اشیای StorageUnitInfo است.

پارامترها

• تماس برگشتی

  تابع اختیاری

  پارامتر callback به‌صورت زیر است:

  (info: StorageUnitInfo[]) => void

  • اطلاعات

    StorageUnitInfo[]

بازگشتی‌ها

• Promise<StorageUnitInfo[]>

  Chrome نسخه ۹۱ به بالا

  ‫Promises فقط برای «مانیفست نسخه ۳» و نسخه‌های جدیدتر پشتیبانی می‌شود، پلاتفرم‌های دیگر باید از callbacks استفاده کنند.

رویدادها

onAttached

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

وقتی فضای ذخیره‌سازی جداشدنی جدیدی به سیستم متصل می‌شود، فعال می‌شود.

پارامترها

• تماس برگشتی

  عملکرد

  پارامتر callback به‌صورت زیر است:

  (info: StorageUnitInfo) => void

  • اطلاعات

    StorageUnitInfo

onDetached

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

وقتی فضای ذخیره‌سازی جداشدنی از سیستم جدا می‌شود، فعال می‌شود.

پارامترها

• تماس برگشتی

  عملکرد

  پارامتر callback به‌صورت زیر است:

  (id: string) => void

  • id

    رشته