chrome.system.storage

توضیحات

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

مجوزها

system.storage

انواع

EjectDeviceResultCode

Enum

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

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

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

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

StorageAvailableCapacityInfo

خواص

  • ظرفیت موجود

    شماره

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

  • شناسه

    رشته

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

StorageUnitInfo

خواص

  • ظرفیت

    شماره

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

  • شناسه

    رشته

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

  • نام

    رشته

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

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

StorageUnitType

Enum

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

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

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

روش ها

ejectDevice()

قول بده
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

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

پارامترها

برمی گرداند

  • Chrome 91+

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

getAvailableCapacity()

کانال Promise Dev
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

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

پارامترها

برمی گرداند

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

getInfo()

قول بده
chrome.system.storage.getInfo(
  callback?: function,
)

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

پارامترها

  • پاسخ به تماس

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

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

    (info: StorageUnitInfo[]) => void

برمی گرداند

  • Promise< StorageUnitInfo []>

    Chrome 91+

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

رویدادها

onAttached

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

هنگامی که یک حافظه قابل جابجایی جدید به سیستم متصل می شود، فعال می شود.

پارامترها

onDetached

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

هنگامی که یک حافظه قابل جابجایی از سیستم جدا می شود فعال می شود.

پارامترها

  • پاسخ به تماس

    تابع

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

    (id: string) => void

    • شناسه

      رشته