chrome.system.storage

الوصف

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

الأذونات

system.storage

الأنواع

EjectDeviceResultCode

Enum

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

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

"no_such_device"
لا يوجد مثل هذا الجهاز معروف.

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

StorageAvailableCapacityInfo

أماكن إقامة

  • availableCapacity

    الرقم

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

  • id

    سلسلة

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

StorageUnitInfo

أماكن إقامة

  • السعة

    الرقم

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

  • id

    سلسلة

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

  • الاسم

    سلسلة

    تمثّل هذه السمة اسم وحدة التخزين.

  • كتابة

    StorageUnitType

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

StorageUnitType

Enum

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

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

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

الطُرق

ejectDevice()

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

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

المعلمات

المرتجعات

  • Promise<EjectDeviceResultCode>

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

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

getAvailableCapacity()

وعود قناة مطوري البرامج 
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[]>

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

    لا تتوفّر الوعود إلا مع إصدار 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

      سلسلة