browser.system.storage

شرح

از 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()

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

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

پارامترها

• id

  رشته

بازگشتی‌ها

• Promise<EjectDeviceResultCode>

  Chrome نسخه ۹۱ و بالاتر browser.* از Chrome نسخه ۱۴۸

getAvailableCapacity()

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

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

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

پارامترها

• id

  رشته

بازگشتی‌ها

• Promise<StorageAvailableCapacityInfo>

getInfo()

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

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

بازگشتی‌ها

• Promise<StorageUnitInfo[]>

  Chrome نسخه ۹۱ و بالاتر browser.* از Chrome نسخه ۱۴۸

رویدادها

onAttached

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

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

پارامترها

• تماس برگشتی

  عملکرد

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

  (info: StorageUnitInfo) => void

  • اطلاعات

    StorageUnitInfo

onDetached

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

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

پارامترها

• تماس برگشتی

  عملکرد

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

  (id: string) => void

  • id

    رشته