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,
  callback?: function,
): Promise<EjectDeviceResultCode>

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

المعلمات

المرتجعات

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

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

getAvailableCapacity()

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

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

المعلمات

المرتجعات

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

getInfo()

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

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

المعلمات

  • callback

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

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

    (info: StorageUnitInfo[]) => void

المرتجعات

  • Promise<StorageUnitInfo[]>

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

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

الفعاليات

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

      سلسلة