फ़ाइल मैनेज करने की सुविधा की मदद से, ChromeOS को कॉन्फ़िगर किया जा सकता है. इससे आपका एक्सटेंशन, फ़ाइल मेन्यू के 'खोलें' मेन्यू या संदर्भ मेन्यू के 'मेन्यू से खोलें' सुविधा का इस्तेमाल करके फ़ाइलें खोल सकता है. फ़ाइल खोलने के बाद, वेब प्लैटफ़ॉर्म के लॉन्च हैंडलर एपीआई का इस्तेमाल करके, फ़ाइल का डेटा प्रोसेस किया जाता है. इसके बाद, फ़ाइल को दिखाने या मैनेज करने के लिए, आपको स्टैंडर्ड वेब प्लैटफ़ॉर्म एपीआई इस्तेमाल करना होगा.
![ChromeOS के ओपन मेन्यू में एक फ़ाइल हैंडलर जोड़ा गया.](https://developer.chrome.com/static/docs/extensions/how-to/web-platform/file-handling-chromeos/image/a-file-handler-added-the-4899ab22819fc.png?authuser=6&hl=hi)
एक्सटेंशन में उपलब्धता
ChromeOS 120 या इसके बाद के वर्शन.
अनुमतियां
फ़ाइल मैनेज करने के लिए किसी अनुमति की ज़रूरत नहीं होती.
मेनिफ़ेस्ट
आपको Manifest.json फ़ाइल में "file_handlers"
कलेक्शन जोड़ना होगा.
कॉन्टेक्स्ट के साथ
इस एपीआई का इस्तेमाल एक्सटेंशन सर्विस वर्कर, पॉप-अप, साइड पैनल या कॉन्टेंट स्क्रिप्ट में किया जा सकता है.
फ़ाइल हैंडलर कॉन्फ़िगर करना
"file_handlers"
का हर सदस्य, यानी हर फ़ाइल हैंडलर—यह बताता है कि कोई फ़ाइल टाइप किस तरह का है, जिसे किसी एक्सटेंशन पेज पर मैनेज किया जाना चाहिए.
आपके चुने हुए हैंडलर, ChromeOS Files विंडो, 'खोलें' और 'खोलें' विकल्प के साथ खास तौर पर मेन्यू के साथ जोड़े जाएंगे. वे इन मेन्यू में तब ही दिखेंगे, जब उपयोगकर्ता किसी खास एक्सटेंशन वाली फ़ाइल को चुनेगा. उदाहरण के लिए, अगर कोई फ़ाइल हैंडलर .txt
को तय करता है, तो ChromeOS के मेन्यू में वह हैंडलर सिर्फ़ तब दिखेगा, जब उस एक्सटेंशन वाली कोई फ़ाइल चुनी गई होगी.
फ़ाइल प्रोसेस करना
फ़ाइल हैंडलर आपके एक्सटेंशन में मौजूद एक एचटीएमएल फ़ाइल है. जब कोई उपयोगकर्ता किसी मेन्यू से आपका हैंडलर चुनता है, तो एचटीएमएल फ़ाइल एक नए टैब में खुलती है. फ़ाइल को प्रोसेस करने की प्रोसेस, JavaScript के ज़रिए की जाती है, चाहे आप उसे दिखाएं या किसी दूसरे तरीके से इस्तेमाल करें. यह प्रोसेस, सही वेब प्लैटफ़ॉर्म एपीआई का इस्तेमाल करके, JavaScript की मदद से की जाती है. प्रोसेसिंग कोड किसी अलग JavaScript फ़ाइल में होना चाहिए और उसे <script>
टैग के ज़रिए शामिल किया जाना चाहिए. साथ ही, यह आपके एक्सटेंशन में भी होना चाहिए. FileSystemFileHandle
ऑब्जेक्ट पाने के लिए स्क्रिप्ट फ़ाइल, Launch Handler API के LaunchQueue
इंटरफ़ेस का इस्तेमाल करती है.
उदाहरण
इस उदाहरण में, LaunchQueue
इंटरफ़ेस का इस्तेमाल करके FileSystemFileHandle
ऑब्जेक्ट पाने का तरीका बताया गया है. फ़ाइल हैंडलिंग के काम करने का तरीका देखने के लिए, फ़ाइल हैंडलिंग का डेमो इंस्टॉल करें.
if ('launchQueue' in window) {
launchQueue.setConsumer(async launchParams => {
if (!launchParams.files || !launchParams.files.length) { return; }
const fileHandle = launchParams.files[0];
});
}
``````