شرح
از chrome.syncFileSystem
API برای ذخیره و همگام سازی داده ها در Google Drive استفاده کنید. این API برای دسترسی به اسناد کاربر دلخواه ذخیره شده در Google Drive نیست. این برنامه فضای ذخیرهسازی همگامسازی خاص را برای استفاده آفلاین و حافظه پنهان فراهم میکند تا دادههای یکسانی در میان کلاینتهای مختلف در دسترس باشد. برای اطلاعات بیشتر در مورد استفاده از این API ، مدیریت داده را بخوانید.
مجوزها
syncFileSystem
انواع
ConflictResolutionPolicy
Enum
"آخرین_نوشتن_برد" "کتابچه راهنمای"
FileInfo
خواص
- عمل
SyncAction اختیاری است
همگام سازی اقدام انجام شده برای فعال کردن رویداد
onFileStatusChanged
. مقدار عمل را می توان'added'
،'updated'
یا'deleted'
کرد. فقط در صورتی اعمال می شود که وضعیت'synced'
باشد. - جهت
SyncDirection اختیاری است
جهت همگام سازی رویداد
onFileStatusChanged
. مقدار جهت همگامسازی میتواند'local_to_remote'
یا'remote_to_local'
باشد. فقط در صورتی اعمال می شود که وضعیت'synced'
باشد. - ورودی فایل
ورود
fileEntry
برای فایل مورد نظر که وضعیت آن تغییر کرده است. حاوی اطلاعات نام و مسیر فایل همگام شده است. در صورت حذف فایل، اطلاعاتfileEntry
همچنان در دسترس خواهد بود اما فایل دیگر وجود نخواهد داشت. - وضعیت
وضعیت فایل حاصل پس از رویداد
onFileStatusChanged
. مقدار وضعیت می تواند'synced'
،'pending'
یا'conflicting'
باشد.
FileStatus
Enum
"همگام سازی شده" "انتظار" "تضاد"
متناقض نیست و تغییرات محلی معلق ندارد.
یک یا چند تغییر محلی معلق دارد که همگامسازی نشدهاند.
فایل با نسخه راه دور تداخل دارد و باید به صورت دستی حل شود.
FileStatusInfo
خواص
- خطا
رشته اختیاری
خطای اختیاری که فقط در صورت بروز مشکل در بازیابی وضعیت FileStatus برای فایل داده شده برمی گردد.
- ورودی فایل
ورود
یکی از ورودی هایی که در اصل به getFileStatuses داده شده است.
- وضعیت
مقدار وضعیت می تواند
'synced'
،'pending'
یا'conflicting'
باشد.
ServiceInfo
خواص
- شرح
رشته
- حالت
ServiceStatus
Enum
"ابتدایی" "دویدن" "Authentication_required" "موقتی_غیرقابل دسترس" "معلول"
سرویس همگام سازی در حال تنظیم اولیه است (به عنوان مثال بازیابی داده ها از پایگاه داده، بررسی اتصال و احراز هویت به سرویس و غیره).
سرویس همگام سازی فعال است.
سرویس همگامسازی فایلها را همگامسازی نمیکند زیرا برای ادامه سرویس از راه دور باید توسط کاربر احراز هویت شود.
سرویس همگامسازی فایلها را همگامسازی نمیکند زیرا سرویس راه دور (به طور موقت) به دلیل برخی از خطاهای قابل بازیابی در دسترس نیست، به عنوان مثال شبکه آفلاین است، سرویس راه دور خاموش است یا قابل دسترسی نیست و غیره. جزئیات بیشتر باید با پارامتر description
در OnServiceInfoUpdated داده شود (که میتواند حاوی جزئیات خدمات خاص).
سرویس همگامسازی غیرفعال است و محتوا هرگز همگامسازی نمیشود. (به عنوان مثال، این ممکن است زمانی اتفاق بیفتد که کاربر هیچ حساب کاربری در سرویس راه دور نداشته باشد یا سرویس همگامسازی یک خطای غیرقابل جبران داشته باشد.)
StorageInfo
خواص
- quotaBytes
عدد
- usageBytes
عدد
SyncAction
Enum
"اضافه" "به روز شده" "حذف شده"
SyncDirection
Enum
"local_to_remote" "Remote_to_local"
مواد و روش ها
getConflictResolutionPolicy()
chrome.syncFileSystem.getConflictResolutionPolicy(
callback?: function,
)
خط مشی حل تعارض فعلی را دریافت می کند.
مولفه های
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(policy: ConflictResolutionPolicy) => void
- خط مشی
برمی گرداند
Promise< ConflictResolutionPolicy >
Chrome 117+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
getFileStatus()
chrome.syncFileSystem.getFileStatus(
fileEntry: Entry,
callback?: function,
)
FileStatus
را برای fileEntry
داده شده برمی گرداند. مقدار وضعیت می تواند 'synced'
، 'pending'
یا 'conflicting'
باشد. توجه داشته باشید که حالت 'conflicting'
تنها زمانی اتفاق میافتد که خطمشی حل تعارض سرویس روی 'manual'
تنظیم شود.
مولفه های
- ورودی فایل
ورود
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(status: FileStatus) => void
- وضعیت
برمی گرداند
Promise< FileStatus >
Chrome 117+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
getFileStatuses()
chrome.syncFileSystem.getFileStatuses(
fileEntries: object[],
callback?: function,
)
هر FileStatus
برای آرایه fileEntry
داده شده برمی گرداند. معمولاً با نتیجه () dirReader.readEntries فراخوانی می شود.
مولفه های
- ورودی های فایل
هدف - شی[]
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(status: FileStatusInfo[]) => void
- وضعیت
برمی گرداند
Promise< FileStatusInfo []>
Chrome 117+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
getServiceStatus()
chrome.syncFileSystem.getServiceStatus(
callback?: function,
)
وضعیت فعلی همگام سازی باطن را برمی گرداند.
مولفه های
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(status: ServiceStatus) => void
- وضعیت
برمی گرداند
Promise< وضعیت سرویس >
Chrome 117+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
getUsageAndQuota()
chrome.syncFileSystem.getUsageAndQuota(
fileSystem: DOMFileSystem,
callback?: function,
)
میزان مصرف فعلی و سهمیه ذخیرهسازی فایل 'syncable'
برنامه را بر حسب بایت برمیگرداند.
مولفه های
- فایل سیستم
DOMFileSystem
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:(info: StorageInfo) => void
- اطلاعات
برمی گرداند
Promise< StorageInfo >
Chrome 117+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
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
- فایل سیستم
DOMFileSystem
برمی گرداند
Promise<DOMFileSystem>
Chrome 117+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
setConflictResolutionPolicy()
chrome.syncFileSystem.setConflictResolutionPolicy(
policy: ConflictResolutionPolicy,
callback?: function,
)
خط مشی پیشفرض حل تعارض را برای ذخیرهسازی فایل 'syncable'
برای برنامه تنظیم میکند. به طور پیش فرض روی 'last_write_win'
تنظیم شده است. هنگامی که خط مشی حل تداخل روی 'last_write_win'
تنظیم می شود، تداخل فایل های موجود دفعه بعد که فایل به روز می شود به طور خودکار حل می شود. callback
می توان به صورت اختیاری برای دانستن اینکه آیا درخواست موفقیت آمیز بوده است یا خیر داده می شود.
مولفه های
- خط مشی
- پاسخ به تماس
عملکرد اختیاری
پارامتر
callback
به نظر می رسد:() => void
برمی گرداند
قول<باطل>
Chrome 117+Promises فقط برای Manifest V3 و نسخههای جدیدتر پشتیبانی میشود، پلتفرمهای دیگر باید از callback استفاده کنند.
مناسبت ها
onFileStatusChanged
chrome.syncFileSystem.onFileStatusChanged.addListener(
callback: function,
)
هنگامی که یک فایل توسط سرویس همگام سازی پس زمینه به روز شده است فعال می شود.
مولفه های
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(detail: FileInfo) => void
- جزئیات
onServiceStatusChanged
chrome.syncFileSystem.onServiceStatusChanged.addListener(
callback: function,
)
زمانی فعال می شود که یک خطا یا تغییر وضعیت دیگر در باطن همگام سازی اتفاق افتاده باشد (به عنوان مثال، زمانی که همگام سازی به طور موقت به دلیل شبکه یا خطای احراز هویت غیرفعال شود).
مولفه های
- پاسخ به تماس
تابع
پارامتر
callback
به نظر می رسد:(detail: ServiceInfo) => void
- جزئیات