browser.system.storage

الوصف

يمكنك استخدام واجهة برمجة التطبيقات chrome.system.storage لطلب معلومات جهاز التخزين والحصول على إشعار عند توصيل جهاز تخزين قابل للإزالة وفصله.

الأذونات

system.storage

الأنواع

EjectDeviceResultCode

Enum

"success"
تم تنفيذ أمر الإخراج بنجاح، ويمكن للتطبيق أن يطلب من المستخدم إزالة الجهاز.

"in_use"
الجهاز قيد الاستخدام من قِبل تطبيق آخر. لم تنجح عملية الإخراج، لذا يجب على المستخدم عدم إزالة الجهاز حتى ينتهي التطبيق الآخر من استخدامه.

"no_such_device"
لا يتوفّر جهاز بهذا الاسم.

"failure"
تعذّر تنفيذ أمر الإخراج.

StorageAvailableCapacityInfo

الخصائص

  • availableCapacity

    الرقم

    السعة المتاحة لجهاز التخزين، بالبايت

  • id

    سلسلة

    تم نسخ id من مَعلمة دالة getAvailableCapacity‏ id.

StorageUnitInfo

الخصائص

  • القدرة الاستيعابية

    الرقم

    إجمالي مساحة التخزين بالبايت

  • id

    سلسلة

    المعرّف المؤقت الذي يحدّد جهاز التخزين بشكل فريد سيظل هذا المعرّف ثابتًا ضمن عملية التشغيل نفسها لتطبيق واحد. ولن يكون معرّفًا دائمًا بين عمليات التشغيل المختلفة لأحد التطبيقات أو بين التطبيقات المختلفة.

  • الاسم

    سلسلة

    اسم وحدة التخزين

  • النوع

    StorageUnitType

    نوع الوسائط لوحدة التخزين

StorageUnitType

Enum

"fixed"
تحتوي وحدة التخزين على وسائط ثابتة، مثل القرص الصلب أو محرك الأقراص ذي الحالة الصلبة (SSD).

‫"removable"
وحدة التخزين قابلة للإزالة، مثل وحدة ذاكرة الفلاش USB.

"unknown"
نوع مساحة التخزين غير معروف.

الطُرق

ejectDevice()

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

لإخراج جهاز تخزين قابل للإزالة

المعلمات

  • id

    سلسلة

المرتجعات

  • الإصدار 91 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

getAvailableCapacity()

قناة مطوّري البرامج 
browser.system.storage.getAvailableCapacity(
  id: string,
): Promise<StorageAvailableCapacityInfo>

الحصول على السعة المتوفّرة لجهاز تخزين id محدّد ‫id هو رقم تعريف الجهاز المؤقت من StorageUnitInfo.

المعلمات

  • id

    سلسلة

المرتجعات

getInfo()

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

احصل على معلومات مساحة التخزين من النظام. الوسيطة التي تم تمريرها إلى دالة الاستدعاء هي مصفوفة من عناصر StorageUnitInfo.

المرتجعات

  • Promise<StorageUnitInfo[]>

    الإصدار 91 من Chrome والإصدارات الأحدث browser.* ‎ منذ الإصدار 148 من Chrome

الفعاليات

onAttached

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

يتم تفعيله عند توصيل وحدة تخزين جديدة قابلة للإزالة بالنظام.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (info: StorageUnitInfo) => void

onDetached

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

يتم تشغيل هذا الحدث عند فصل وحدة تخزين قابلة للإزالة عن النظام.

المعلمات

  • callback

    دالة

    تظهر المَعلمة callback على النحو التالي: 

    (id: string) => void

    • id

      سلسلة