chrome.syncFileSystem

ब्यौरा

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

अनुमतियां

syncFileSystem

टाइप

ConflictResolutionPolicy

Enum

"last_write_win"

FileInfo

प्रॉपर्टी

  • किसी खास रूटीन से जुड़ी कार्रवाई

    SyncAction ज़रूरी नहीं

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

  • direction

    SyncDirection ज़रूरी नहीं

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

  • fileEntry

    प्रवेश

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

  • स्थिति

    FileStatus

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

FileStatus

Enum

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

"pending"
इसमें एक या एक से ज़्यादा ऐसे स्थानीय बदलाव हैं जो सिंक नहीं हुए हैं.

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

FileStatusInfo

प्रॉपर्टी

  • गड़बड़ी

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

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

  • fileEntry

    प्रवेश

    getFileStatuses को मूल रूप से दिए गए एंट्री में से एक.

  • स्थिति

    FileStatus

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

ServiceInfo

प्रॉपर्टी

  • ब्यौरा

    स्ट्रिंग

ServiceStatus

Enum

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

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

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

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

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

StorageInfo

प्रॉपर्टी

  • quotaBytes

    नंबर

  • usageBytes

    नंबर

SyncAction

Enum

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 दिखाता है. आम तौर पर, directReader.readEntries() के नतीजे के साथ कॉल किया जाता है.

पैरामीटर

  • fileEntries

    ऑब्जेक्ट[]

  • कॉलबैक

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

    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