chrome.system.storage

الوصف

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

الأذونات

system.storage

الأنواع

EjectDeviceResultCode

التعداد

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

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

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

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

StorageAvailableCapacityInfo

أماكن إقامة

• availableCapacity

  الرقم

  تشير هذه السمة إلى السعة المتاحة لجهاز التخزين بالبايت.

• id

  سلسلة

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

StorageUnitInfo

أماكن إقامة

• السعة

  الرقم

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

• id

  سلسلة

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

• اسم

  سلسلة

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

• كتابة

  StorageUnitType

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

StorageUnitType

التعداد

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

"قابل للإزالة"
مساحة التخزين قابلة للإزالة، على سبيل المثال، محرّك أقراص USB المحمول.

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

الطُرق

ejectDevice()

وعد

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

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

المَعلمات

• id

  سلسلة

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (result: EjectDeviceResultCode)=>void

  • نتيجة

    EjectDeviceResultCode

المرتجعات

• Promise<EjectDeviceResultCode>

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

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

getAvailableCapacity()

وعد قناة مطوّري البرامج

chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
)

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

المَعلمات

• id

  سلسلة

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (info: StorageAvailableCapacityInfo)=>void

  • معلومات

    StorageAvailableCapacityInfo

المرتجعات

• Promise<StorageAvailableCapacityInfo>

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

getInfo()

وعد

chrome.system.storage.getInfo(
  callback?: function,
)

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

المَعلمات

• معاودة الاتصال

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

  تبدو معلَمة callback على النحو التالي:

  (info: StorageUnitInfo[])=>void

  • معلومات

    StorageUnitInfo[]

المرتجعات

• Promise<StorageUnitInfo[]>

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

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

فعاليات

onAttached

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

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

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة callback على النحو التالي:

  (info: StorageUnitInfo)=>void

  • معلومات

    StorageUnitInfo

onDetached

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

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

المَعلمات

• معاودة الاتصال

  الوظيفة

  تبدو معلَمة callback على النحو التالي:

  (id: string)=>void

  • id

    سلسلة