chrome.fileSystemProvider

refresh date: 2026-09-25 robots: noindex

الوصف

استخدِم واجهة برمجة التطبيقات chrome.fileSystemProvider لإنشاء أنظمة ملفات يمكن الوصول إليها من مدير الملفات على نظام التشغيل ChromeOS.

الأذونات

fileSystemProvider

مدى التوفّر

نظام التشغيل ChromeOS فقط

البيان

يجب إدراج الإذن والقسم "fileSystemProvider" في بيان الإضافة لاستخدام واجهة برمجة التطبيقات File System Provider. على سبيل المثال:

{
  "name": "My extension",
  ...
  "permissions": [
    "fileSystemProvider"
  ],
  ...
  "file_system_provider_capabilities": {
    "configurable": true,
    "watchable": false,
    "multiple_mounts": true,
    "source": "network"
  },
  ...
}

يجب تعريف قسم file_system_provider على النحو التالي:

configurable (قيمة منطقية) - اختياري
ما إذا كان من الممكن ضبط الإعدادات من خلال onConfigureRequested. القيمة التلقائية هي false.
multiple_mounts (قيمة منطقية) - اختياري
تحديد ما إذا كان يمكن استخدام أنظمة ملفات متعددة (أكثر من واحد) تم تحميلها القيمة التلقائية هي false.
watchable (قيمة منطقية) - اختياري
ما إذا كان من الممكن ضبط مراقبين وتلقّي إشعارات بشأن التغييرات. القيمة التلقائية هي false.
‫source (تعداد "ملف" أو "جهاز" أو "شبكة") - مطلوب
مصدر البيانات لأنظمة الملفات المثبَّتة

يستخدم تطبيق "الملفات" المعلومات المذكورة أعلاه لعرض عناصر واجهة المستخدم ذات الصلة بشكلٍ مناسب. على سبيل المثال، إذا تم ضبط configurable على "صحيح"، سيتم عرض عنصر قائمة لإعداد مستوى الصوت. وبالمثل، إذا تم ضبط multiple_mounts على true، سيسمح تطبيق "الملفات" بإضافة أكثر من نقطة ربط واحدة من واجهة المستخدم. إذا كانت القيمة watchable هي false، سيتم عرض زر إعادة التحميل. يُرجى العِلم أنّه يجب إضافة إمكانية استخدام أدوات المراقبة إذا أمكن ذلك، حتى يمكن عرض التغييرات في نظام الملفات على الفور وبشكل تلقائي.

نظرة عامة

تسمح واجهة برمجة التطبيقات File System Provider للإضافات بتوفير أنظمة ملفات افتراضية متاحة في مدير الملفات على ChromeOS. تشمل حالات الاستخدام فك ضغط الأرشيفات والوصول إلى الملفات في خدمة سحابية غير Drive.

تحميل أنظمة الملفات

يمكن أن توفّر الإضافات محتوى نظام الملفات من مصدر خارجي (مثل خادم بعيد أو جهاز USB)، أو تستخدم ملفًا محليًا (مثل أرشيف) كمدخل لها.

لكي تتمكّن من كتابة أنظمة ملفات تعمل كمعالجات للملفات (المصدر هو "file")، يجب أن يكون مقدّم الخدمة تطبيقًا مجمّعًا، لأنّ الحدث onLaunched غير متاح للإضافات.

إذا كان المصدر شبكة أو جهازًا، يجب تركيب نظام الملفات عند استدعاء الحدث onMountRequested.

المصدر لبيانات نظام الملفات نقطة الإدخال
"file" تتوفّر للتطبيقات المجمّعة فقط.
"device" أو "network" onMountRequested

ضبط أنظمة الملفات

يمكن ضبط أنظمة الملفات المتوفّرة بعد تثبيتها من خلال الحدث onConfigureRequested. وهي مفيدة بشكل خاص لأنظمة الملفات التي توفّر المحتوى عبر الشبكة من أجل ضبط بيانات الاعتماد المناسبة. ويُعدّ التعامل مع هذا الحدث أمرًا اختياريًا.

رحلة المستخدم

يتذكّر Chrome أنظمة الملفات التي تم تركيبها ويُعيد تركيبها تلقائيًا بعد إعادة التشغيل. وبالتالي، بعد أن يتم تثبيت نظام ملفات من خلال إضافة توفّر هذا النظام، سيظلّ مثبّتًا إلى أن يتم إلغاء تحميل الإضافة أو إلى أن تستدعي الإضافة طريقة unmount.

الأنواع

AbortRequestedOptions

الخصائص

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • operationRequestId

    الرقم

    معرّف الطلب الذي سيتم إلغاؤه

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

Action

Chrome 45+

الخصائص

  • id

    سلسلة

    معرّف الإجراء. أي سلسلة أو CommonActionId للإجراءات الشائعة

  • title

    سلسلة اختيارية

    تمثّل هذه السمة عنوان الإجراء. وقد يتم تجاهله في الإجراءات الشائعة.

AddWatcherRequestedOptions

الخصائص

  • entryPath

    سلسلة

    مسار الإدخال الذي سيتم رصده.

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • تكراري

    قيمة منطقية

    تحديد ما إذا كان يجب أن يشمل الرصد جميع الإدخالات الفرعية بشكل متكرّر. يمكن أن ينطبق ذلك على الأدلة فقط.

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

Change

الخصائص

  • changeType

    ChangeType

    نوع التغيير الذي حدث في الإدخال.

  • cloudFileInfo

    CloudFileInfo اختيارية

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

    معلومات ذات صلة بالملف إذا كان مدعومًا بنظام ملفات سحابي

  • entryPath

    سلسلة

    مسار الإدخال الذي تم تغييره.

ChangeType

نوع التغيير الذي تم رصده في الدليل الذي تتم مراقبته.

تعداد

"CHANGED"

"DELETED"

CloseFileRequestedOptions

الخصائص

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • openRequestId

    الرقم

    معرّف الطلب المستخدَم لفتح الملف

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

CloudFileInfo

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

الخصائص

  • versionTag

    سلسلة اختيارية

    علامة تمثّل إصدار الملف.

CloudIdentifier

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

الخصائص

  • id

    سلسلة

    معرّف الموفّر للملف أو الدليل المحدّدَين

  • providerName

    سلسلة

    معرّف مقدم مساحة تخزين في السحابة الإلكترونية (مثل drive.google.com).

CommonActionId

Chrome 45+

قائمة بالإجراءات الشائعة يُستخدم الرمز "SHARE" لمشاركة الملفات مع الآخرين. "SAVE_FOR_OFFLINE" لتثبيت المحتوى (حفظه للوصول إليه بلا إنترنت) "OFFLINE_NOT_NECESSARY" لإعلامك بأنّه لم يعُد من الضروري تخزين الملف للوصول إليه بلا إنترنت. تستخدمها onGetActionsRequested وonExecuteActionRequested.

تعداد

"SAVE_FOR_OFFLINE"

"OFFLINE_NOT_NECESSARY"

"مشاركة"

ConfigureRequestedOptions

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

الخصائص

  • fileSystemId

    سلسلة

    معرّف نظام الملفات الذي سيتم إعداده

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

CopyEntryRequestedOptions

الخصائص

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

  • sourcePath

    سلسلة

    مسار المصدر للإدخال المطلوب نسخه

  • targetPath

    سلسلة

    مسار الوجهة لعملية النسخ

CreateDirectoryRequestedOptions

الخصائص

  • directoryPath

    سلسلة

    مسار الدليل المطلوب إنشاؤه

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • تكراري

    قيمة منطقية

    تحديد ما إذا كانت العملية متكررة (للدلائل فقط)

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

CreateFileRequestedOptions

الخصائص

  • filePath

    سلسلة

    مسار الملف المطلوب إنشاؤه

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

DeleteEntryRequestedOptions

الخصائص

  • entryPath

    سلسلة

    مسار الإدخال المطلوب حذفه

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • تكراري

    قيمة منطقية

    تحديد ما إذا كانت العملية متكررة (للدلائل فقط)

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

EntryMetadata

الخصائص

  • cloudFileInfo

    CloudFileInfo اختيارية

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

    معلومات تحدّد ملفًا معيّنًا في نظام ملفات السحابة الأساسي يجب تقديمها إذا طُلب ذلك في options وكان الملف مخزّنًا في السحابة الإلكترونية.

  • cloudIdentifier

    CloudIdentifier اختياري

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

    تمثيل مساحة التخزين السحابي لهذا الإدخال يجب تقديمها إذا طُلب ذلك في options وكان الملف مخزّنًا في السحابة الإلكترونية. بالنسبة إلى الملفات المحفوظة على الجهاز والتي لا يتم الاحتفاظ بنسخة احتياطية منها في مساحة التخزين السحابية، يجب أن تكون غير محدّدة عند طلبها.

  • isDirectory

    boolean اختياري

    يتم عرض "صحيح" إذا كان دليلًا. يجب تقديمها إذا طُلب ذلك في options.

  • mimeType

    سلسلة اختيارية

    نوع MIME الخاص بالإدخال. اختيارية دائمًا، ولكن يجب توفيرها إذا تم طلبها في options.

  • modificationTime

    التاريخ اختياري

    يشير هذا الحقل إلى تاريخ آخر مرة تم فيها تعديل هذا الإدخال. يجب تقديمها إذا طُلب ذلك في options.

  • الاسم

    سلسلة اختيارية

    اسم هذا الإدخال (وليس اسم المسار الكامل). يجب ألا يحتوي على "/"، ويجب أن يكون فارغًا بالنسبة إلى الجذر. يجب تقديمها إذا طُلب ذلك في options.

  • الحجم

    number اختياري

    حجم الملف بالبايت يجب تقديمها إذا طُلب ذلك في options.

  • صورة مصغّرة

    سلسلة اختيارية

    صورة مصغّرة كعنوان URI للبيانات بتنسيق PNG أو JPEG أو WEBP، وبحجم 32 كيلوبايت كحد أقصى اختياري، ولكن يمكن تقديمه فقط عندما يطلبه الحدث onGetMetadataRequested صراحةً.

ExecuteActionRequestedOptions

Chrome 45+

الخصائص

  • actionId

    سلسلة

    معرّف الإجراء المطلوب تنفيذه

  • entryPaths

    string[]

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

    مجموعة مسارات الإدخالات التي سيتم استخدامها في الإجراء

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

FileSystemInfo

الخصائص

  • displayName

    سلسلة

    تمثّل هذه السمة اسم نظام ملفات سهل القراءة للمستخدم.

  • fileSystemId

    سلسلة

    معرّف نظام الملفات

  • openedFiles

    OpenedFile[]

    قائمة بالملفات المفتوحة حاليًا

  • openedFilesLimit

    الرقم

    الحد الأقصى لعدد الملفات التي يمكن فتحها في وقت واحد إذا كانت القيمة 0، يعني ذلك أنّ عدد مرات التكرار غير محدود.

  • supportsNotifyTag

    boolean اختياري

    Chrome 45+

    توضّح ما إذا كان نظام الملفات يتيح استخدام الحقل tag لمراقبة الدلائل.

  • المشاهدون

    Watcher[]

    Chrome 45+

    قائمة المشاهدين

  • قابل للكتابة

    قيمة منطقية

    تُستخدَم لتحديد ما إذا كان نظام الملفات يتيح إجراء عمليات قد تغيّر محتوى نظام الملفات (مثل إنشاء الملفات أو حذفها أو الكتابة إليها).

GetActionsRequestedOptions

Chrome 45+

الخصائص

  • entryPaths

    string[]

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

    قائمة بمسارات الإدخالات لقائمة الإجراءات.

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

GetMetadataRequestedOptions

الخصائص

  • cloudFileInfo

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة cloudFileInfo.

  • cloudIdentifier

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة cloudIdentifier.

  • entryPath

    سلسلة

    تمثّل هذه السمة مسار الإدخال المطلوب استرجاع بيانات التعريف الخاصة به.

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • isDirectory

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة is_directory.

  • mimeType

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة mimeType.

  • modificationTime

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة modificationTime.

  • الاسم

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة name.

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

  • الحجم

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة size.

  • صورة مصغّرة

    قيمة منطقية

    اضبط القيمة على true إذا طُلب استخدام قيمة thumbnail.

MountOptions

الخصائص

  • displayName

    سلسلة

    تمثّل هذه السمة اسم نظام ملفات سهل القراءة للمستخدم.

  • fileSystemId

    سلسلة

    المعرّف السلسلي لنظام الملفات يجب أن تكون فريدة لكل إضافة.

  • openedFilesLimit

    number اختياري

    الحد الأقصى لعدد الملفات التي يمكن فتحها في وقت واحد إذا لم يتم تحديدها أو كانت القيمة 0، لن يتم فرض أي قيود.

  • مستمر

    boolean اختياري

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

    تحدّد هذه السمة ما إذا كان يجب أن يستأنف إطار العمل نظام الملفات في جلسة تسجيل الدخول التالية. القيمة التلقائية هي "صحيح".

  • supportsNotifyTag

    boolean اختياري

    Chrome 45+

    تحديد ما إذا كان نظام الملفات يتيح استخدام الحقل tag للأدلة التي يتم تتبُّعها

  • قابل للكتابة

    boolean اختياري

    تُستخدَم لتحديد ما إذا كان نظام الملفات يتيح إجراء عمليات قد تغيّر محتوى نظام الملفات (مثل إنشاء الملفات أو حذفها أو الكتابة إليها).

MoveEntryRequestedOptions

الخصائص

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

  • sourcePath

    سلسلة

    مسار المصدر للإدخال الذي سيتم نقله إلى مكان جديد

  • targetPath

    سلسلة

    مسار الوجهة لعملية النسخ

NotifyOptions

الخصائص

  • changeType

    ChangeType

    نوع التغيير الذي حدث في الإدخال المرصود. إذا تم حذف الإدخال، ستتم إزالته تلقائيًا من قائمة الإدخالات التي تم رصدها.

  • التغييرات

    Change[] اختياري

    قائمة بالتغييرات التي أُجريت على الإدخالات في الدليل الذي تتم مراقبته (بما في ذلك الإدخال نفسه)

  • fileSystemId

    سلسلة

    تمثّل هذه السمة معرّف نظام الملفات المرتبط بهذا التغيير.

  • observedPath

    سلسلة

    مسار الإدخال الذي تم رصده

  • تكراري

    قيمة منطقية

    وضع الإدخال الذي تم رصده

  • علامة

    سلسلة اختيارية

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

OpenedFile

الخصائص

  • filePath

    سلسلة

    مسار الملف المفتوح

  • الوضع

    OpenFileMode

    تُستخدَم لتحديد ما إذا كان الملف قد تم فتحه للقراءة أو الكتابة.

  • openRequestId

    الرقم

    معرّف الطلب الذي سيتم استخدامه في طلبات القراءة/الكتابة والإغلاق المتتالية.

OpenFileMode

طريقة فتح ملف يتم استخدامها من خلال onOpenFileRequested.

تعداد

"قراءة"

"WRITE"

OpenFileRequestedOptions

الخصائص

  • filePath

    سلسلة

    مسار الملف المطلوب فتحه

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • الوضع

    OpenFileMode

    ما إذا كان سيتم استخدام الملف للقراءة أو الكتابة

  • requestId

    الرقم

    معرّف الطلب الذي سيتم استخدامه في طلبات القراءة/الكتابة والإغلاق المتتالية.

ProviderError

رموز الخطأ المستخدَمة عند تقديم الإضافات استجابةً للطلبات، وكذلك في حال حدوث أخطاء عند استدعاء طرق واجهة برمجة التطبيقات لتحقيق النجاح، يجب استخدام "OK".

تعداد

"حسنًا"

"FAILED"

"IN_USE"

"EXISTS"

"NOT_FOUND"

"ACCESS_DENIED"

"TOO_MANY_OPENED"

"NO_MEMORY"

"NO_SPACE"

"NOT_A_DIRECTORY"

"INVALID_OPERATION"

"SECURITY"

"ABORT"

"NOT_A_FILE"

"NOT_EMPTY"

"INVALID_URL"

"IO"

ReadDirectoryRequestedOptions

الخصائص

  • directoryPath

    سلسلة

    مسار الدليل المطلوب محتواه.

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • isDirectory

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة is_directory.

  • mimeType

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة mimeType.

  • modificationTime

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة modificationTime.

  • الاسم

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة name.

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

  • الحجم

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة size.

  • صورة مصغّرة

    قيمة منطقية

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

    اضبط القيمة على true إذا طُلب استخدام قيمة thumbnail.

ReadFileRequestedOptions

الخصائص

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • length

    الرقم

    عدد وحدات البايت المطلوب عرضها

  • offset

    الرقم

    موضع البدء في الملف (بالبايت)

  • openRequestId

    الرقم

    معرّف الطلب المستخدَم لفتح الملف

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

RemoveWatcherRequestedOptions

الخصائص

  • entryPath

    سلسلة

    تمثّل هذه السمة مسار الإدخال الذي تمت مشاهدته.

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • تكراري

    قيمة منطقية

    وضع المشاهد.

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

TruncateRequestedOptions

الخصائص

  • filePath

    سلسلة

    مسار الملف المطلوب اقتطاعه

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • length

    الرقم

    عدد وحدات البايت التي سيتم الاحتفاظ بها بعد اكتمال العملية

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

UnmountOptions

الخصائص

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المطلوب إلغاء تحميله

UnmountRequestedOptions

الخصائص

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المطلوب إلغاء تحميله

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

Watcher

الخصائص

  • entryPath

    سلسلة

    مسار الإدخال الذي تتم مراقبته

  • lastTag

    سلسلة اختيارية

    العلامة المستخدَمة في آخر إشعار تم إرساله إلى المتابع.

  • تكراري

    قيمة منطقية

    تحديد ما إذا كان يجب أن يشمل العرض جميع الإدخالات الفرعية بشكل متكرّر. يمكن أن ينطبق ذلك على الأدلة فقط.

WriteFileRequestedOptions

الخصائص

  • البيانات

    ArrayBuffer

    مخزن مؤقت للبايتات التي سيتم كتابتها في الملف

  • fileSystemId

    سلسلة

    معرّف نظام الملفات المرتبط بهذه العملية

  • offset

    الرقم

    موضع البدء في الملف (بالبايت) لكتابة وحدات البايت منه

  • openRequestId

    الرقم

    معرّف الطلب المستخدَم لفتح الملف

  • requestId

    الرقم

    المعرّف الفريد لهذا الطلب.

الطُرق

get()

وعد 
chrome.fileSystemProvider.get(
  fileSystemId: string,
  callback?: function,
): Promise<FileSystemInfo>

تعرض هذه الطريقة معلومات عن نظام ملفات يتضمّن fileSystemId الذي تم تمريره.

المعلمات

  • fileSystemId

    سلسلة

  • callback

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

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

    (fileSystem: FileSystemInfo) => void

المرتجعات

  • Promise<FileSystemInfo>

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

    دالة ردّ الاتصال لتلقّي نتيجة الدالة get

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

getAll()

وعد 
chrome.fileSystemProvider.getAll(
  callback?: function,
): Promise<FileSystemInfo[]>

تعرِض هذه السمة جميع أنظمة الملفات التي تم تركيبها بواسطة الإضافة.

المعلمات

  • callback

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

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

    (fileSystems: FileSystemInfo[]) => void

المرتجعات

  • Promise<FileSystemInfo[]>

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

    دالة ردّ الاتصال لتلقّي نتيجة الدالة getAll

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

mount()

وعد 
chrome.fileSystemProvider.mount(
  options: MountOptions,
  callback?: function,
): Promise<void>

تثبِّت هذه الطريقة نظام ملفات باستخدام fileSystemId وdisplayName المحدّدين. سيظهر displayName في اللوحة اليمنى من تطبيق "الملفات". يمكن أن يحتوي displayName على أي أحرف، بما في ذلك "/"، ولكن لا يمكن أن يكون سلسلة فارغة. يجب أن يكون displayName وصفيًا ولكن ليس من الضروري أن يكون فريدًا. يجب ألا تكون السمة fileSystemId سلسلة فارغة.

استنادًا إلى نوع نظام الملفات الذي يتم تركيبه، يجب ضبط الخيار source بشكل مناسب.

في حال حدوث خطأ، سيتم ضبط قيمة runtime.lastError على رمز الخطأ المناسب.

المعلمات

  • الخيارات

    MountOptions

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

    دالة ردّ نداء عامة للنتيجة للإشارة إلى النجاح أو الفشل.

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

notify()

Promise Chrome 45 أو الإصدارات الأحدث 
chrome.fileSystemProvider.notify(
  options: NotifyOptions,
  callback?: function,
): Promise<void>

يُرسِل إشعارات بشأن التغييرات في الدليل الذي تتم مراقبته في observedPath في وضع recursive. إذا تم تركيب نظام الملفات باستخدام supportsNotifyTag، يجب توفير tag، ويتم دائمًا الإبلاغ عن جميع التغييرات منذ آخر إشعار، حتى إذا تم إيقاف تشغيل النظام. يمكن الحصول على العلامة الأخيرة باستخدام getAll.

لاستخدام هذه الميزة، يجب ضبط خيار البيان file_system_provider.notify على "صحيح".

يمكن أن تكون قيمة tag أي سلسلة فريدة لكل مكالمة، وبالتالي يمكن تحديد آخر إشعار تم تسجيله. على سبيل المثال، إذا بدأ تشغيل الإضافة بعد إعادة التشغيل، وكانت علامة الإشعار الأخير المسجّل تساوي "123"، يجب أن يتم استدعاء notify لجميع التغييرات التي حدثت منذ التغيير الذي تم وضع علامة "123" عليه. لا يمكن أن تكون سلسلة فارغة.

لا يمكن لبعض مقدّمي الخدمات توفير علامة، ولكن إذا كان نظام الملفات يتضمّن سجلّ تغييرات، يمكن أن تكون العلامة مثلاً رقم تغيير أو رقم نسخة.

يُرجى العِلم أنّه في حال تمت إزالة دليل رئيسي، ستتم أيضًا إزالة جميع الإدخالات الفرعية، وإذا كانت تتم مراقبتها، يجب إعلام واجهة برمجة التطبيقات بذلك. بالإضافة إلى ذلك، إذا تمت إعادة تسمية دليل، تتم في الواقع إزالة جميع الإدخالات الفرعية، لأنّه لم يعُد هناك إدخال ضمن مساراتها الأصلية.

في حال حدوث خطأ، سيتم ضبط قيمة runtime.lastError على رمز الخطأ المناسب.

المعلمات

  • الخيارات

    NotifyOptions

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

    دالة ردّ نداء عامة للنتيجة للإشارة إلى النجاح أو الفشل.

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

unmount()

وعد 
chrome.fileSystemProvider.unmount(
  options: UnmountOptions,
  callback?: function,
): Promise<void>

يؤدي هذا الأمر إلى إلغاء تحميل نظام ملفات باستخدام fileSystemId المحدّد. يجب استدعاؤه بعد استدعاء onUnmountRequested. يمكن أيضًا للإضافة التي توفّر نظام الملفات أن تقرّر إلغاء التحميل إذا لم يُطلب ذلك (على سبيل المثال، في حال فقدان الاتصال أو حدوث خطأ في الملف).

في حال حدوث خطأ، سيتم ضبط قيمة runtime.lastError على رمز الخطأ المناسب.

المعلمات

  • الخيارات

    UnmountOptions

  • callback

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

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

    () => void

المرتجعات

  • Promise<void>

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

    دالة ردّ نداء عامة للنتيجة للإشارة إلى النجاح أو الفشل.

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

الفعاليات

onAbortRequested

chrome.fileSystemProvider.onAbortRequested.addListener(
  callback: function,
)

يتم عرض هذا الخطأ عند طلب إلغاء عملية باستخدام operationRequestId. يجب إيقاف العملية التي تم تنفيذها باستخدام operationRequestId على الفور وتنفيذ successCallback لطلب الإلغاء هذا. في حال تعذُّر الإلغاء، يجب استدعاء errorCallback. يُرجى العِلم أنّه يجب عدم استدعاء عمليات ردّ الاتصال الخاصة بالعملية الملغاة، لأنّه سيتم تجاهلها. على الرغم من طلب errorCallback، قد يتم إيقاف الطلب بالقوة.

المعلمات

  • callback

    دالة

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

    (options: AbortRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      AbortRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onAddWatcherRequested

Chrome 45+ 
chrome.fileSystemProvider.onAddWatcherRequested.addListener(
  callback: function,
)

يتم طرح هذا الاستثناء عند طلب إعداد مراقب دليل جديد. في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: AddWatcherRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      AddWatcherRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onCloseFileRequested

chrome.fileSystemProvider.onCloseFileRequested.addListener(
  callback: function,
)

يتم طرح هذا الاستثناء عند طلب إغلاق ملف تم فتحه سابقًا باستخدام openRequestId.

المعلمات

  • callback

    دالة

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

    (options: CloseFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      CloseFileRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onConfigureRequested

Chrome 44 والإصدارات الأحدث 
chrome.fileSystemProvider.onConfigureRequested.addListener(
  callback: function,
)

يتم إطلاق هذا الحدث عند طلب عرض مربّع حوار إعدادات fileSystemId. في حال تمت معالجة الخطأ، يجب ضبط file_system_provider.configurable خيار ملف البيان على "صحيح".

المعلمات

  • callback

    دالة

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

    (options: ConfigureRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      ConfigureRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onCopyEntryRequested

chrome.fileSystemProvider.onCopyEntryRequested.addListener(
  callback: function,
)

يتم طرح هذا الاستثناء عند طلب نسخ إدخال (بشكل متكرر إذا كان دليلًا). في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: CopyEntryRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      CopyEntryRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onCreateDirectoryRequested

chrome.fileSystemProvider.onCreateDirectoryRequested.addListener(
  callback: function,
)

يتم طرح هذا الاستثناء عند طلب إنشاء دليل. يجب أن تفشل العملية مع ظهور الخطأ EXISTS إذا كان دليل الوجهة متوفّرًا من قبل. إذا كانت القيمة recursive صحيحة، يجب إنشاء جميع الأدلة الناقصة في مسار الدليل.

المعلمات

  • callback

    دالة

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

    (options: CreateDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onCreateFileRequested

chrome.fileSystemProvider.onCreateFileRequested.addListener(
  callback: function,
)

يتم طرح هذا الاستثناء عند طلب إنشاء ملف. إذا كان الملف متاحًا من قبل، يجب استدعاء errorCallback باستخدام رمز الخطأ "EXISTS".

المعلمات

  • callback

    دالة

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

    (options: CreateFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      CreateFileRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onDeleteEntryRequested

chrome.fileSystemProvider.onDeleteEntryRequested.addListener(
  callback: function,
)

يتم إرسال هذا الحدث عند طلب حذف إدخال. إذا كانت قيمة recursive هي "صحيح" وكان الإدخال عبارة عن دليل، يجب أيضًا حذف جميع الإدخالات بداخله بشكل متكرّر.

المعلمات

  • callback

    دالة

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

    (options: DeleteEntryRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      DeleteEntryRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onExecuteActionRequested

Chrome 48+ 
chrome.fileSystemProvider.onExecuteActionRequested.addListener(
  callback: function,
)

يتم طرح هذا الخطأ عند طلب تنفيذ إجراء لمجموعة من الملفات أو الدلائل. بعد اكتمال الإجراء، يجب استدعاء successCallback. في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: ExecuteActionRequestedOptions, successCallback: function, errorCallback: function) => void

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onGetActionsRequested

Chrome 48+ 
chrome.fileSystemProvider.onGetActionsRequested.addListener(
  callback: function,
)

يتم عرض هذا الخطأ عند طلب قائمة بالإجراءات لمجموعة من الملفات أو الدلائل في entryPaths. يجب أن تكون جميع الإجراءات التي تم إرجاعها قابلة للتطبيق على كل إدخال. إذا لم تكن هناك إجراءات من هذا النوع، يجب عرض مصفوفة فارغة. يجب عرض الإجراءات مع طلب successCallback. في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: GetActionsRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      GetActionsRequestedOptions

    • successCallback

      دالة

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

      (actions: Action[]) => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onGetMetadataRequested

chrome.fileSystemProvider.onGetMetadataRequested.addListener(
  callback: function,
)

يتم طرح هذا الاستثناء عند طلب البيانات الوصفية لملف أو دليل في entryPath. يجب عرض بيانات التعريف مع طلب successCallback. في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: GetMetadataRequestedOptions, successCallback: function, errorCallback: function) => void

onMountRequested

Chrome 44 والإصدارات الأحدث 
chrome.fileSystemProvider.onMountRequested.addListener(
  callback: function,
)

يتم إرسال هذا الحدث عند طلب عرض مربّع حوار لتركيب نظام ملفات جديد. إذا كانت الإضافة أو التطبيق معالج ملفات، يجب عدم التعامل مع هذا الحدث. بدلاً من ذلك، يجب التعامل مع app.runtime.onLaunched من أجل ربط أنظمة ملفات جديدة عند فتح ملف. بالنسبة إلى عمليات التحميل المتعددة، يجب ضبط خيار البيان file_system_provider.multiple_mounts على "صحيح".

المعلمات

  • callback

    دالة

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

    (successCallback: function, errorCallback: function) => void

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onMoveEntryRequested

chrome.fileSystemProvider.onMoveEntryRequested.addListener(
  callback: function,
)

يتم طرح هذا الاستثناء عند طلب نقل إدخال (بشكل متكرر إذا كان دليلًا). في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: MoveEntryRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      MoveEntryRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onOpenFileRequested

chrome.fileSystemProvider.onOpenFileRequested.addListener(
  callback: function,
)

يتم عرض هذا الخطأ عند طلب فتح ملف في filePath. إذا لم يكن الملف متاحًا، يجب أن يتعذّر تنفيذ العملية. يمكن تحديد الحد الأقصى لعدد الملفات التي يتم فتحها في وقت واحد باستخدام MountOptions.

المعلمات

  • callback

    دالة

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

    (options: OpenFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      OpenFileRequestedOptions

    • successCallback

      دالة

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

      (metadata?: EntryMetadata) => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onReadDirectoryRequested

chrome.fileSystemProvider.onReadDirectoryRequested.addListener(
  callback: function,
)

يتم طرح هذا الخطأ عند طلب محتوى دليل في directoryPath. يجب إرجاع النتائج على شكل أجزاء من خلال استدعاء successCallback عدة مرات. في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: ReadDirectoryRequestedOptions, successCallback: function, errorCallback: function) => void

    • successCallback

      دالة

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

      (entries: EntryMetadata[], hasMore: boolean) => void

      • المشاركات

        EntryMetadata[]

      • hasMore

        قيمة منطقية

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onReadFileRequested

chrome.fileSystemProvider.onReadFileRequested.addListener(
  callback: function,
)

يتم عرض هذا الخطأ عند طلب قراءة محتوى ملف تم فتحه سابقًا باستخدام openRequestId. يجب عرض النتائج في أجزاء من خلال طلب successCallback عدة مرات. في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: ReadFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      ReadFileRequestedOptions

    • successCallback

      دالة

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

      (data: ArrayBuffer, hasMore: boolean) => void

      • البيانات

        ArrayBuffer

      • hasMore

        قيمة منطقية

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onRemoveWatcherRequested

Chrome 45+ 
chrome.fileSystemProvider.onRemoveWatcherRequested.addListener(
  callback: function,
)

يتم عرض هذا الخطأ عند الحاجة إلى إزالة المراقب. في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: RemoveWatcherRequestedOptions, successCallback: function, errorCallback: function) => void

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onTruncateRequested

chrome.fileSystemProvider.onTruncateRequested.addListener(
  callback: function,
)

يتم طرح هذا الاستثناء عند طلب اقتطاع ملف إلى طول معيّن. في حال حدوث خطأ، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: TruncateRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      TruncateRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onUnmountRequested

chrome.fileSystemProvider.onUnmountRequested.addListener(
  callback: function,
)

يتم عرض هذا الخطأ عند طلب إلغاء تحميل نظام الملفات الذي يحمل المعرّف fileSystemId. في الردّ، يجب طلب طريقة واجهة برمجة التطبيقات unmount مع successCallback. إذا لم يكن من الممكن إلغاء التحميل (على سبيل المثال، بسبب عملية معلّقة)، يجب استدعاء errorCallback.

المعلمات

  • callback

    دالة

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

    (options: UnmountRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      UnmountRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void

onWriteFileRequested

chrome.fileSystemProvider.onWriteFileRequested.addListener(
  callback: function,
)

يتم طرح هذا الاستثناء عند طلب كتابة محتوى في ملف تم فتحه سابقًا باستخدام openRequestId.

المعلمات

  • callback

    دالة

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

    (options: WriteFileRequestedOptions, successCallback: function, errorCallback: function) => void

    • الخيارات

      WriteFileRequestedOptions

    • successCallback

      دالة

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

      () => void

    • errorCallback

      دالة

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

      (error: ProviderError) => void