chrome.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

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

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

"غير معروف"
نوع التخزين غير معروف.

الطُرق

ejectDevice()

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

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

المعلمات

  • id

    سلسلة

المرتجعات

getAvailableCapacity()

قناة الإصدار التجريبي 
chrome.system.storage.getAvailableCapacity(
  id: string,
): Promise<StorageAvailableCapacityInfo>

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

المعلمات

  • id

    سلسلة

المرتجعات

getInfo()

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

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

المرتجعات

  • Promise<StorageUnitInfo[]>

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

الفعاليات

onAttached

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

يتم تشغيله عند توصيل جهاز تخزين خارجي جديد بالنظام.

المعلمات

  • callback

    دالة

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

    (info: StorageUnitInfo) => void

onDetached

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

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

المعلمات

  • callback

    دالة

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

    (id: string) => void

    • id

      سلسلة