chrome.syncFileSystem

ब्यौरा

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

अनुमतियां

syncFileSystem

टाइप

ConflictResolutionPolicy

Enum

"last_write_win"

"मैन्युअल"

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

"जोड़ा गया"

"अपडेट किया गया"

""मिटाया गया"

SyncDirection

Enum

"local_to_remote"

"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 दिखाता है. आम तौर पर, DSAReader.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

रिटर्न

  • प्रॉमिस<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