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,
)

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

المعلمات

• id

  سلسلة

• رد الاتصال

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

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

  (result: EjectDeviceResultCode) => void

  • نتيجة

    EjectDeviceResultCode

المرتجعات

• Promise<EjectDeviceResultCode>

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

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

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

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

    سلسلة