الوصف
استخدِم واجهة برمجة التطبيقات chrome.system.storage
API لطلب معلومات عن جهاز التخزين وتلقّي إشعارات عند توصيل جهاز تخزين قابل للإزالة وفصله.
الأذونات
system.storage
الأنواع
EjectDeviceResultCode
التعداد
"success"
تم تنفيذ أمر الإخراج بنجاح، ويمكن أن يطلب التطبيق من المستخدم إزالة الجهاز.
"in_use"
الجهاز قيد الاستخدام من قِبل تطبيق آخر. تعذّر الإخراج: يجب ألا يزيل المستخدم الجهاز إلى أن ينتهي التطبيق الآخر من الجهاز.
"no_such_device"
لا يوجد هذا الجهاز معروف.
"failure"
تعذّر تنفيذ أمر الإخراج.
StorageAvailableCapacityInfo
أماكن إقامة
-
availableCapacity
الرقم
تشير هذه السمة إلى السعة المتاحة لجهاز التخزين بالبايت.
-
id
سلسلة
تم نسخ
id
لمَعلمة دالة getAvailableCapacityid
.
StorageUnitInfo
أماكن إقامة
-
السعة
الرقم
إجمالي حجم مساحة التخزين بالبايت
-
id
سلسلة
رقم التعريف المؤقت الذي يعرّف جهاز التخزين بشكل فريد. وسيظل رقم التعريف هذا ثابتًا خلال عملية تشغيل تطبيق واحد. ولن يكون معرِّفًا ثابتًا بين عمليات تشغيل التطبيقات المختلفة أو بين التطبيقات المختلفة.
-
اسم
سلسلة
اسم وحدة التخزين.
-
كتابة
نوع الوسائط لوحدة التخزين.
StorageUnitType
التعداد
"fixed"
تحتوي وحدة التخزين على وسائط ثابتة، على سبيل المثال القرص الثابت أو SSD.
"قابل للإزالة"
مساحة التخزين قابلة للإزالة، على سبيل المثال، محرّك أقراص USB المحمول.
"unknown"
نوع التخزين غير معروف.
الطُرق
ejectDevice()
chrome.system.storage.ejectDevice(
id: string,
callback?: function,
)
إخراج جهاز تخزين قابل للإزالة.
المَعلمات
-
id
سلسلة
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(result: EjectDeviceResultCode) => void
-
نتيجة
-
المرتجعات
-
Promise<EjectDeviceResultCode>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getAvailableCapacity()
chrome.system.storage.getAvailableCapacity(
id: string,
callback?: function,
)
يمكنك الحصول على السعة المتاحة لجهاز تخزين id
محدَّد. id
هو رقم تعريف الجهاز المؤقت من StorageUnitInfo.
المَعلمات
-
id
سلسلة
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(info: StorageAvailableCapacityInfo) => void
-
معلومات
-
المرتجعات
-
Promise<StorageAvailableCapacityInfo>
لا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getInfo()
chrome.system.storage.getInfo(
callback?: function,
)
الحصول على معلومات مساحة التخزين من النظام الوسيطة التي يتم تمريرها إلى معاودة الاتصال هي مصفوفة من عناصر StorageUnitInfo.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(info: StorageUnitInfo[]) => void
-
معلومات
-
المرتجعات
-
Promise<StorageUnitInfo[]>
Chrome 91 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من 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
سلسلة
-