chrome.system.storage

توضیحات

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

مجوزها

system.storage

این مجوز یک هشدار را راه اندازی می کند .

انواع

EjectDeviceResultCode

Enum

"موفقیت"
فرمان تخلیه موفقیت آمیز است -- برنامه می تواند از کاربر بخواهد دستگاه را حذف کند.

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

"no_such_device"
چنین دستگاهی شناخته شده نیست.

"شکست"
فرمان تخلیه ناموفق بود.

StorageAvailableCapacityInfo

خواص

• ظرفیت موجود

  شماره

  ظرفیت موجود دستگاه ذخیره سازی، بر حسب بایت.

• شناسه

  رشته

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

StorageUnitInfo

خواص

• ظرفیت

  شماره

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

• شناسه

  رشته

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

• نام

  رشته

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

• نوع

  StorageUnitType

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

StorageUnitType

Enum

"تثبیت شده"
حافظه دارای رسانه ثابت است، به عنوان مثال هارد دیسک یا SSD.

"قابل جابجایی"
حافظه قابل جابجایی است، به عنوان مثال درایو فلش USB.

"ناشناخته"
نوع ذخیره سازی مشخص نیست.

روش ها

ejectDevice()

قول بده

chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

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

پارامترها

• شناسه

  رشته

• پاسخ به تماس

  عملکرد اختیاری

  پارامتر callback به نظر می رسد:

  (result: EjectDeviceResultCode) => void

  • نتیجه

    EjectDeviceResultCode

برمی گرداند

• Promise< EjectDeviceResultCode >

  Chrome 91+

  Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

getAvailableCapacity()

کانال Promise Dev

chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

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

پارامترها

• شناسه

  رشته

• پاسخ به تماس

  عملکرد اختیاری

  پارامتر callback به نظر می رسد:

  (info: StorageAvailableCapacityInfo) => void

  • اطلاعات

    StorageAvailableCapacityInfo

برمی گرداند

• Promise< StorageAvailableCapacityInfo >

  Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

getInfo()

قول بده

chrome.system.storage.getInfo(
  callback?: function,
)

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

پارامترها

• پاسخ به تماس

  عملکرد اختیاری

  پارامتر callback به نظر می رسد:

  (info: StorageUnitInfo[]) => void

  • اطلاعات

    StorageUnitInfo []

برمی گرداند

• Promise< StorageUnitInfo []>

  Chrome 91+

  Promises فقط برای Manifest V3 و نسخه‌های جدیدتر پشتیبانی می‌شود، پلتفرم‌های دیگر باید از callback استفاده کنند.

رویدادها

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

  • شناسه

    رشته