chrome.syncFileSystem

الوصف

استخدام واجهة برمجة التطبيقات chrome.syncFileSystem لحفظ البيانات ومزامنتها في Google Drive ولا تُستخدم واجهة برمجة التطبيقات هذه للوصول إلى مستندات المستخدم العشوائية المخزنة في Google Drive. وتوفر مساحة تخزين قابلة للمزامنة وخاصة بالتطبيق للاستخدام في وضع عدم الاتصال والتخزين المؤقت حتى تتوفّر البيانات نفسها عبر برامج مختلفة. يُرجى الاطّلاع على إدارة البيانات لمعرفة المزيد عن استخدام واجهة برمجة التطبيقات هذه.

الأذونات

syncFileSystem

الأنواع

ConflictResolutionPolicy

التعداد

"last_write_win"

FileInfo

أماكن إقامة

  • إجراء

    SyncAction اختيارية

    إجراء المزامنة الذي تم اتّخاذه لتنشيط حدث onFileStatusChanged وقد تكون قيمة الإجراء 'added' أو 'updated' أو 'deleted'. ينطبق ذلك فقط إذا كانت الحالة هي "'synced'".

  • direction

    SyncDirection اختيارية

    يمكنك مزامنة اتجاه حدث onFileStatusChanged. قد تكون قيمة اتجاه المزامنة 'local_to_remote' أو 'remote_to_local'. ينطبق ذلك فقط إذا كانت الحالة هي "'synced'".

  • fileEntry

    تذكرة الدخول

    fileEntry للملف الهدف الذي تغيّرت حالته. يحتوي على معلومات اسم ومسار الملف الذي تمت مزامنته. عند حذف الملف، ستظل معلومات fileEntry متاحة لكن الملف لن يعود متاحًا.

  • status

    FileStatus

    حالة الملف الناتجة بعد الحدث onFileStatusChanged قد تكون قيمة الحالة 'synced' أو 'pending' أو 'conflicting'.

FileStatus

التعداد

"synced"
غير متعارض ولا توجد تغييرات محلية في انتظار المراجعة

"pending"
تتضمّن تغييرًا أو أكثر من التغييرات المحلية المعلّقة التي لم تتم مزامنتها.

"conflicting"
يتعارض الملف مع الإصدار البعيد، ويجب حلّ المشكلة يدويًا.

FileStatusInfo

أماكن إقامة

  • خطأ

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

    يشير هذا المصطلح إلى خطأ اختياري يتم عرضه فقط إذا حدثت مشكلة في استرداد FileStatus للملف المحدَّد.

  • fileEntry

    تذكرة الدخول

    تم منح أحد الإدخالات في الأصل إلى getFileStatuses.

  • status

    FileStatus

    قد تكون قيمة الحالة 'synced' أو 'pending' أو 'conflicting'.

ServiceInfo

أماكن إقامة

ServiceStatus

التعداد

"initializing"
يتم حاليًا إعداد خدمة المزامنة (على سبيل المثال، استعادة البيانات من قاعدة البيانات، والتحقّق من الاتصال، والمصادقة مع الخدمة، وما إلى ذلك).

"running"
خدمة المزامنة قيد التشغيل.

"authentication_required"
لا تجري خدمة المزامنة مزامنة للملفات لأنه يجب أن يصادق المستخدم على الخدمة البعيدة للمتابعة.

"temporary_unavailable"
لا تجري خدمة المزامنة مزامنة للملفات لأنّ الخدمة البعيدة غير متاحة (مؤقتًا) بسبب بعض الأخطاء التي يمكن استردادها، مثلاً الشبكة غير متصلة بالإنترنت أو الخدمة البعيدة متوقّفة أو لا يمكن الوصول إليها وما إلى ذلك. يجب تقديم المزيد من التفاصيل من خلال المَعلمة description في OnServiceInfoUpdate (التي قد تحتوي على تفاصيل خاصة بالخدمة).

"غير مفعَّل"
تم إيقاف خدمة المزامنة ولن تتم مزامنة المحتوى مطلقًا. (على سبيل المثال، قد يحدث هذا عندما لا يكون للمستخدم حساب على الخدمة البعيدة أو حدث خطأ لا يمكن استرداده في خدمة المزامنة.)

StorageInfo

أماكن إقامة

  • quotaBytes

    الرقم

  • usageBytes

    الرقم

SyncAction

التعداد

SyncDirection

التعداد

"local_to_remote"

"remote_to_local"

الطُرق

getConflictResolutionPolicy()

وعد 
chrome.syncFileSystem.getConflictResolutionPolicy(
  callback?: function,
)

الحصول على السياسة الحالية لحل النزاعات

المَعلمات

المرتجعات

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

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

getFileStatus()

وعد 
chrome.syncFileSystem.getFileStatus(
  fileEntry: Entry,
  callback?: function,
)

عرض FileStatus لـ fileEntry المحددة. قد تكون قيمة الحالة 'synced' أو 'pending' أو 'conflicting'. تجدر الإشارة إلى أنّ حالة 'conflicting' لا تحدث إلا عند ضبط سياسة حل التعارضات في الخدمة على 'manual'.

المَعلمات

  • fileEntry

    تذكرة الدخول

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (status: FileStatus)=>void

المرتجعات

  • Promise<FileStatus>

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

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

getFileStatuses()

وعد 
chrome.syncFileSystem.getFileStatuses(
  fileEntries: object[],
  callback?: function,
)

تعرض كل FileStatus لمصفوفة fileEntry المحددة. عادةً ما يتم استدعائها بالنتيجة من dirReader.readEntries().

المَعلمات

  • fileEntries

    الكائن[]

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (status: FileStatusInfo[])=>void

المرتجعات

  • Promise<FileStatusInfo[]>

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

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

getServiceStatus()

وعد 
chrome.syncFileSystem.getServiceStatus(
  callback?: function,
)

عرض الحالة الحالية لخلفية المزامنة

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (status: ServiceStatus)=>void

المرتجعات

  • Promise<ServiceStatus>

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

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

getUsageAndQuota()

وعد 
chrome.syncFileSystem.getUsageAndQuota(
  fileSystem: DOMFileSystem,
  callback?: function,
)

عرض الاستخدام الحالي والحصة بالبايت من مساحة تخزين ملفات 'syncable' للتطبيق.

المَعلمات

  • fileSystem

    DOMFileSystem

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (info: StorageInfo)=>void

المرتجعات

  • Promise<StorageInfo>

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

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

requestFileSystem()

وعد 
chrome.syncFileSystem.requestFileSystem(
  callback?: function,
)

لعرض نظام ملفات قابل للمزامنة ومتوافق مع Google Drive. يمكن تشغيل مثيل DOMFileSystem الذي تم عرضه بالطريقة نفسها التي يتم بها تشغيل أنظمة الملفات المؤقتة والدائمة (يمكنك الاطّلاع على http://dev.w3.org/2009/dap/file-system/file-dir-sys.html).

سيؤدي طلب هذا العنوان عدة مرات من التطبيق نفسه إلى إرجاع الاسم المعرِّف نفسه إلى نظام الملفات نفسه.

لاحظ أن هذه المكالمة قد تفشل. على سبيل المثال، إذا لم يسجّل المستخدم الدخول إلى Chrome أو إذا لم تكن هناك عملية تشغيل على الشبكة. لمعالجة هذه الأخطاء، من المهم تحديد chrome.runtime.lastError في معاودة الاتصال.

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    (fileSystem: DOMFileSystem)=>void

    • fileSystem

      DOMFileSystem

المرتجعات

  • Promise<DOMFileSystem>

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

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

setConflictResolutionPolicy()

وعد 
chrome.syncFileSystem.setConflictResolutionPolicy(
  policy: ConflictResolutionPolicy,
  callback?: function,
)

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

المَعلمات

  • معاودة الاتصال

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

    تبدو معلَمة callback على النحو التالي: 

    ()=>void

المرتجعات

  • Promise<void>

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

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

فعاليات

onFileStatusChanged

chrome.syncFileSystem.onFileStatusChanged.addListener(
  callback: function,
)

يتم تنشيطها عند تعديل ملف من خلال خدمة المزامنة في الخلفية.

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (detail: FileInfo)=>void

onServiceStatusChanged

chrome.syncFileSystem.onServiceStatusChanged.addListener(
  callback: function,
)

يتم تنشيطها عند حدوث خطأ أو تغيير آخر في الحالة في الواجهة الخلفية للمزامنة (على سبيل المثال، عندما تكون المزامنة غير مفعّلة مؤقتًا بسبب خطأ في الشبكة أو في المصادقة).

المَعلمات

  • معاودة الاتصال

    الوظيفة

    تبدو معلَمة callback على النحو التالي: 

    (detail: ServiceInfo)=>void