chrome.system.storage

refresh date: 2026-09-25 robots: noindex

الوصف

يمكنك استخدام واجهة برمجة التطبيقات 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

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

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

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

الطُرق

ejectDevice()

Promise

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

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

المعلمات

• id

  سلسلة

• callback

  function اختياري

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

  (result: EjectDeviceResultCode) => void

  • نتيجة

    EjectDeviceResultCode

المرتجعات

• Promise<EjectDeviceResultCode>

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

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

getAvailableCapacity()

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

chrome.system.storage.getAvailableCapacity(
  id: string,
  callback?: function,
): Promise<StorageAvailableCapacityInfo>

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

المعلمات

• id

  سلسلة

• callback

  function اختياري

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

  (info: StorageAvailableCapacityInfo) => void

  • معلومات

    StorageAvailableCapacityInfo

المرتجعات

• Promise<StorageAvailableCapacityInfo>

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

getInfo()

Promise

chrome.system.storage.getInfo(
  callback?: function,
): Promise<StorageUnitInfo[]>

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

المعلمات

• callback

  function اختياري

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

  (info: StorageUnitInfo[]) => void

  • معلومات

    StorageUnitInfo[]

المرتجعات

• Promise<StorageUnitInfo[]>

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

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

الفعاليات

onAttached

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

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

المعلمات

• callback

  دالة

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

  (info: StorageUnitInfo) => void

  • معلومات

    StorageUnitInfo

onDetached

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

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

المعلمات

• callback

  دالة

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

  (id: string) => void

  • id

    سلسلة