chrome.system.storage

الوصف

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

الأذونات

system.storage

الأنواع

EjectDeviceResultCode

Enum

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

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

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

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

StorageAvailableCapacityInfo

أماكن إقامة

  • availableCapacity

    الرقم

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

  • id

    سلسلة

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

StorageUnitInfo

أماكن إقامة

  • السعة

    الرقم

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

  • id

    سلسلة

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

  • الاسم

    سلسلة

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

  • كتابة

    StorageUnitType

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

StorageUnitType

Enum

"ثابت"
تتضمّن مساحة التخزين وسائط ثابتة، مثل القرص الصلب أو محرك الأقراص ذو الحالة الصلبة.

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

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

الطُرق

ejectDevice()

الوعد 
chrome.system.storage.ejectDevice(
  id: string,
  callback?: function,
)

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

المعلمات

  • id

    سلسلة

  • ردّ الاتصال

    الدالة اختيارية

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

    (result: EjectDeviceResultCode) => void

المرتجعات

  • Chrome 91 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

getAvailableCapacity()

Promise قناة المطوّرين 
chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

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

المعلمات

المرتجعات

  • لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

getInfo()

الوعد 
chrome.system.storage.getInfo(
  callback?: function,
)

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

المعلمات

  • ردّ الاتصال

    الدالة اختيارية

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

    (info: StorageUnitInfo[]) => void

المرتجعات

  • Promise<StorageUnitInfo[]>

    Chrome 91 والإصدارات الأحدث

    لا تتوفّر الوعود إلا في الإصدار Manifest V3 والإصدارات الأحدث، ويجب أن تستخدم المنصات الأخرى طلبات الاستدعاء.

الفعاليات

onAttached

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

يتم تشغيله عند ربط وحدة تخزين قابلة للإزالة جديدة بالنظام.

المعلمات

  • ردّ الاتصال

    دالة

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

    (info: StorageUnitInfo) => void

onDetached

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

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

المعلمات

  • ردّ الاتصال

    دالة

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

    (id: string) => void

    • id

      سلسلة