chrome.system.storage

refresh date: 2026-09-25 robots: noindex

الوصف

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

الأذونات

system.storage

الأنواع

EjectDeviceResultCode

تعداد

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

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

"no_such_device"
لا يتوفّر جهاز بهذا الاسم.

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

StorageAvailableCapacityInfo

الخصائص

  • availableCapacity

    الرقم

    تمثّل هذه السمة سعة جهاز التخزين المتوفّرة، بالبايت.

  • id

    سلسلة

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

StorageUnitInfo

الخصائص

  • السعة

    الرقم

    تمثّل هذه السمة إجمالي مساحة التخزين بالبايت.

  • id

    سلسلة

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

  • الاسم

    سلسلة

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

  • النوع

    StorageUnitType

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

StorageUnitType

تعداد

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

"قابلة للإزالة"
مساحة التخزين قابلة للإزالة، مثل وحدة ذاكرة الفلاش 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

      سلسلة