chrome.syncFileSystem

ब्यौरा

Google Drive पर डेटा सेव करने और सिंक करने के लिए, chrome.syncFileSystem API का इस्तेमाल करें. यह एपीआई, Google Drive में सेव किए गए उपयोगकर्ता के किसी भी दस्तावेज़ को ऐक्सेस करने के लिए नहीं है. यह ऑफ़लाइन और कैश मेमोरी के इस्तेमाल के लिए, ऐप्लिकेशन के हिसाब से सिंक किया जा सकने वाला स्टोरेज उपलब्ध कराता है, ताकि एक ही डेटा अलग-अलग क्लाइंट पर उपलब्ध हो सके. इस एपीआई का इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, डेटा मैनेज करना लेख पढ़ें.

अनुमतियां

syncFileSystem

टाइप

ConflictResolutionPolicy

Enum

"last_write_win"

"manual"

FileInfo

प्रॉपर्टी

  • ऐक्शन गेम

    SyncAction ज़रूरी नहीं

    onFileStatusChanged इवेंट को ट्रिगर करने के लिए की गई सिंक कार्रवाई. कार्रवाई की वैल्यू 'added', 'updated' या 'deleted' हो सकती है. यह सिर्फ़ तब लागू होता है, जब स्टेटस 'synced' हो.

  • दिशा

    SyncDirection ज़रूरी नहीं

    onFileStatusChanged इवेंट के लिए सिंक करने का तरीका. सिंक डायरेक्शन की वैल्यू 'local_to_remote' या 'remote_to_local' हो सकती है. यह सिर्फ़ तब लागू होता है, जब स्टेटस 'synced' हो.

  • fileEntry

    प्रवेश

    fileEntry, उस टारगेट फ़ाइल के लिए जिसकी स्थिति बदली है. इसमें सिंक की गई फ़ाइल का नाम और पाथ की जानकारी होती है. फ़ाइल मिटाने के बाद भी, fileEntry की जानकारी उपलब्ध रहेगी. हालांकि, फ़ाइल अब मौजूद नहीं होगी.

  • स्थिति

    FileStatus

    onFileStatusChanged इवेंट के बाद, फ़ाइल का स्टेटस. स्थिति की वैल्यू 'synced', 'pending' या 'conflicting' हो सकती है.

FileStatus

Enum

"सिंक किया गया"
कोई विरोध नहीं है और इसमें कोई स्थानीय बदलाव बाकी नहीं है.

"पूरा नहीं हुआ"
एक या उससे ज़्यादा ऐसे स्थानीय बदलाव हैं जिन्हें सिंक नहीं किया गया है.

"कॉन्फ़लिक्ट"
फ़ाइल, रिमोट वर्शन से मेल नहीं खाती. इसे मैन्युअल तरीके से ठीक करना होगा.

FileStatusInfo

प्रॉपर्टी

  • गड़बड़ी

    स्ट्रिंग ज़रूरी नहीं है

    गड़बड़ी का यह मैसेज सिर्फ़ तब दिखता है, जब किसी फ़ाइल के लिए FileStatus को वापस पाने में समस्या आती है.

  • fileEntry

    प्रवेश

    getFileStatuses फ़ंक्शन में मूल रूप से दी गई एंट्री में से एक.

  • स्थिति

    FileStatus

    स्थिति की वैल्यू 'synced', 'pending' या 'conflicting' हो सकती है.

ServiceInfo

प्रॉपर्टी

  • ब्यौरा

    स्ट्रिंग

  • राज्य

    ServiceStatus

ServiceStatus

Enum

"शुरू हो रही है"
सिंक सेवा शुरू की जा रही है. जैसे, डेटाबेस से डेटा को वापस लाना, कनेक्टिविटी की जांच करना, और सेवा की पुष्टि करना वगैरह.

"चल रहा है"
सिंक सेवा चालू है.

"authentication_required"
सिंक सेवा, फ़ाइलों को सिंक नहीं कर रही है, क्योंकि आगे बढ़ने के लिए उपयोगकर्ता को रिमोट सेवा की पुष्टि करनी होगी.

"temporary_unavailable"
सिंक सेवा, फ़ाइलों को सिंक नहीं कर रही है, क्योंकि रिमोट सेवा कुछ गड़बड़ियों की वजह से (कुछ समय के लिए) उपलब्ध नहीं है.जैसे, नेटवर्क ऑफ़लाइन है, रिमोट सेवा बंद है या उस तक पहुंचा नहीं जा सकता. ज़्यादा जानकारी के लिए, OnServiceInfoUpdated में description पैरामीटर का इस्तेमाल करें. इसमें सेवा से जुड़ी जानकारी हो सकती है.

"बंद है"
सिंक करने की सेवा बंद है और कॉन्टेंट कभी सिंक नहीं होगा. (उदाहरण के लिए, ऐसा तब हो सकता है, जब उपयोगकर्ता के पास रिमोट सर्वर पर कोई खाता न हो या सिंक सेवा में कोई ऐसी गड़बड़ी हो जिसे ठीक न किया जा सके.)

StorageInfo

प्रॉपर्टी

  • quotaBytes

    संख्या

  • usageBytes

    संख्या

SyncAction

Enum

"added"

"updated"

"deleted"

SyncDirection

Enum

"local_to_remote"

"remote_to_local"

तरीके

getConflictResolutionPolicy()

वादा करना 
chrome.syncFileSystem.getConflictResolutionPolicy(
  callback?: function,
)

समस्या हल करने की मौजूदा नीति दिखाता है.

पैरामीटर

रिटर्न

  • Chrome 117 और उसके बाद के वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन के साथ काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

getFileStatus()

वादा करना 
chrome.syncFileSystem.getFileStatus(
  fileEntry: Entry,
  callback?: function,
)

दिए गए fileEntry के लिए FileStatus दिखाता है. स्थिति की वैल्यू 'synced', 'pending' या 'conflicting' हो सकती है. ध्यान दें कि 'conflicting' स्थिति सिर्फ़ तब दिखती है, जब सेवा की समस्या हल करने की नीति को 'manual' पर सेट किया गया हो.

पैरामीटर

  • fileEntry

    प्रवेश

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर इस तरह दिखता है: 

    (status: FileStatus) => void

रिटर्न

  • Promise<FileStatus>

    Chrome 117 और उसके बाद के वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन के साथ काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

getFileStatuses()

वादा करना 
chrome.syncFileSystem.getFileStatuses(
  fileEntries: object[],
  callback?: function,
)

दिए गए fileEntry ऐरे के लिए, हर FileStatus दिखाता है. आम तौर पर, dirReader.readEntries() के नतीजे के साथ कॉल किया जाता है.

पैरामीटर

  • fileEntries

    object[]

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर इस तरह दिखता है: 

    (status: FileStatusInfo[]) => void

रिटर्न

  • Promise<FileStatusInfo[]>

    Chrome 117 और उसके बाद के वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन के साथ काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

getServiceStatus()

वादा करना 
chrome.syncFileSystem.getServiceStatus(
  callback?: function,
)

सिंक करने के बैकएंड का मौजूदा स्टेटस दिखाता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर इस तरह दिखता है: 

    (status: ServiceStatus) => void

रिटर्न

  • Promise<ServiceStatus>

    Chrome 117 और उसके बाद के वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन के साथ काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

getUsageAndQuota()

वादा करना 
chrome.syncFileSystem.getUsageAndQuota(
  fileSystem: DOMFileSystem,
  callback?: function,
)

यह ऐप्लिकेशन के लिए, 'syncable' फ़ाइल स्टोरेज के मौजूदा इस्तेमाल और कोटा को बाइट में दिखाता है.

पैरामीटर

  • fileSystem

    DOMFileSystem

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर इस तरह दिखता है: 

    (info: StorageInfo) => void

रिटर्न

  • Promise<StorageInfo>

    Chrome 117 और उसके बाद के वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट 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 और उसके बाद के वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन के साथ काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

setConflictResolutionPolicy()

वादा करना 
chrome.syncFileSystem.setConflictResolutionPolicy(
  policy: ConflictResolutionPolicy,
  callback?: function,
)

ऐप्लिकेशन के लिए 'syncable' फ़ाइल स्टोरेज के लिए, समस्या हल करने की डिफ़ॉल्ट नीति सेट करता है. यह डिफ़ॉल्ट रूप से 'last_write_win' पर सेट होता है. जब फ़ाइलों के नामों में होने वाली गड़बड़ी को ठीक करने की नीति को 'last_write_win' पर सेट किया जाता है, तो अगली बार फ़ाइल अपडेट होने पर, मौजूदा फ़ाइलों के नामों में होने वाली गड़बड़ियां अपने-आप ठीक हो जाती हैं. callback को वैकल्पिक तौर पर दिया जा सकता है, ताकि यह पता चल सके कि अनुरोध पूरा हुआ है या नहीं.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन ज़रूरी नहीं

    callback पैरामीटर इस तरह दिखता है: 

    () => void

रिटर्न

  • Promise<void>

    Chrome 117 और उसके बाद के वर्शन

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन के साथ काम करते हैं. अन्य प्लैटफ़ॉर्म के लिए, कॉलबैक का इस्तेमाल करना ज़रूरी है.

इवेंट

onFileStatusChanged

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

बैकग्राउंड सिंक सेवा की मदद से फ़ाइल अपडेट होने पर ट्रिगर होता है.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर इस तरह दिखता है: 

    (detail: FileInfo) => void

onServiceStatusChanged

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

सिंक बैकएंड में गड़बड़ी या स्थिति में कोई बदलाव होने पर ट्रिगर होता है. उदाहरण के लिए, नेटवर्क या पुष्टि करने से जुड़ी गड़बड़ी की वजह से, सिंक कुछ समय के लिए बंद होने पर.

पैरामीटर

  • कॉलबैक

    फ़ंक्शन

    callback पैरामीटर इस तरह दिखता है: 

    (detail: ServiceInfo) => void