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"
फ़ाइलें सिंक करने की सेवा सिंक नहीं की जा रही है, क्योंकि ठीक की जा सकने वाली कुछ गड़बड़ियों की वजह से, रिमोट सेवा (कुछ समय के लिए) उपलब्ध नहीं है. उदाहरण के लिए, नेटवर्क ऑफ़लाइन है, रिमोट सेवा काम नहीं कर रही है या पहुंच नहीं पा रही है वगैरह. ज़्यादा जानकारी के लिए, OnServiceInfoUpdate में description पैरामीटर को शामिल किया जाना चाहिए (इसमें सेवा से जुड़ी खास जानकारी शामिल हो सकती है).

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

StorageInfo

प्रॉपर्टी

  • quotaBytes

    संख्या

  • usageBytes

    संख्या

SyncAction

Enum

"updated"

SyncDirection

Enum

"remote_to_local"

तरीके

getConflictResolutionPolicy()

प्रॉमिस 
chrome.syncFileSystem.getConflictResolutionPolicy(
  callback?: function,
)

विवाद सुलझाने की मौजूदा नीति की जानकारी देता है.

पैरामीटर

रिटर्न

  • Promise<ConflictResolutionPolicy>

    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

    ऑब्जेक्ट[]

  • कॉलबैक

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

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

    (status: FileStatusInfo[]) => void

रिटर्न

  • Promise<FileStatusInfo[]>

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

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

getServiceStatus()

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

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

पैरामीटर

  • कॉलबैक

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

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

    (status: ServiceStatus) => void

रिटर्न

  • Promise&lt;ServiceStatus&gt;

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

    प्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. दूसरे प्लैटफ़ॉर्म को कॉलबैक इस्तेमाल करने होते हैं.

getUsageAndQuota()

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

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

पैरामीटर

  • fileSystem

    DOMFileSystem

  • कॉलबैक

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

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

    (info: StorageInfo) => void

रिटर्न

  • Promise&lt;StorageInfo&gt;

    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