chrome.system.storage

تاریخ به‌روزرسانی: 2026-09-25 ربات‌ها: noindex

توضیحات

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

مجوزها

system.storage

انواع

EjectDeviceResultCode

شمارشی

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

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

"چنین_دستگاهی_وجود ندارد"
چنین دستگاهی شناخته شده نیست.

«شکست»
دستور خروج ناموفق بود.

StorageAvailableCapacityInfo

خواص

  • ظرفیت موجود

    شماره

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

  • شناسه

    رشته

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

StorageUnitInfo

خواص

  • ظرفیت

    شماره

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

  • شناسه

    رشته

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

  • نام

    رشته

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

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

StorageUnitType

شمارشی

"ثابت"
فضای ذخیره‌سازی دارای رسانه‌های ثابتی مانند هارد دیسک یا SSD است.

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

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

روش‌ها

ejectDevice()

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

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

پارامترها

بازگشت‌ها

  • کروم ۹۱+

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

getAvailableCapacity()

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

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

پارامترها

بازگشت‌ها

getInfo()

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

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

پارامترها

بازگشت‌ها

  • کروم ۹۱+

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

رویدادها

onAttached

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

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

پارامترها

onDetached

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

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

پارامترها

  • تماس برگشتی

    تابع

    پارامتر callback به شکل زیر است: 

    (id: string) => void

    • شناسه

      رشته