ফাইল হ্যান্ডলিং আপনাকে ChromeOS কনফিগার করার সুযোগ দেয়, যাতে আপনার এক্সটেনশনটি ফাইল মেনুর 'ওপেন' মেনু অথবা কনটেক্সট মেনুর 'ওপেন উইথ' মেনু ব্যবহার করে ফাইল খুলতে পারে। ফাইলটি খোলা হয়ে গেলে, আপনি ওয়েব প্ল্যাটফর্মের ' লঞ্চ হ্যান্ডলার এপিআই' (Launch Handler API) ব্যবহার করে এর ডেটা প্রসেস করেন। এরপর আপনি ফাইলটি প্রদর্শন বা হ্যান্ডেল করার জন্য স্ট্যান্ডার্ড ওয়েব প্ল্যাটফর্ম এপিআই ব্যবহার করবেন।
এক্সটেনশনে উপলব্ধতা
ChromeOS 120 বা তার পরবর্তী সংস্করণ।
অনুমতি
ফাইল পরিচালনার জন্য কোনো অনুমতির প্রয়োজন নেই।
প্রকাশ
আপনাকে manifest.json ফাইলে "file_handlers" অ্যারেটি যোগ করতে হবে।
সহায়ক প্রেক্ষাপট
এই এপিআইটি এক্সটেনশন সার্ভিস ওয়ার্কার, পপআপ, সাইড প্যানেল বা কন্টেন্ট স্ক্রিপ্টে ব্যবহার করা যেতে পারে।
একটি ফাইল হ্যান্ডলার কনফিগার করুন
"file_handlers" -এর প্রতিটি সদস্য—অর্থাৎ প্রতিটি ফাইল হ্যান্ডলার —একটি নির্দিষ্ট এক্সটেনশন পেজ দ্বারা হ্যান্ডেল করার জন্য এক বা একাধিক ফাইলের ধরন নির্দিষ্ট করে।
আপনার নির্দিষ্ট করা হ্যান্ডলারগুলো ChromeOS-এর ফাইলস উইন্ডোতে, বিশেষ করে ‘ওপেন’ এবং ‘ওপেন উইথ’ মেনুতে যুক্ত করা হবে। ব্যবহারকারী যখন নির্দিষ্ট এক্সটেনশনযুক্ত কোনো ফাইল নির্বাচন করবেন, কেবল তখনই এগুলো এই মেনুগুলোতে প্রদর্শিত হবে। উদাহরণস্বরূপ, যদি কোনো ফাইল হ্যান্ডলারে .txt নির্দিষ্ট করা থাকে, তাহলে ChromeOS মেনুগুলো কেবল তখনই সেই হ্যান্ডলারটি দেখাবে যখন ওই এক্সটেনশনযুক্ত কোনো ফাইল নির্বাচন করা হবে।
একটি ফাইল প্রক্রিয়া করুন
ফাইল হ্যান্ডলার হলো আপনার এক্সটেনশনের মধ্যে থাকা একটি HTML ফাইল। যখন ব্যবহারকারী একটি মেনু থেকে আপনার হ্যান্ডলারটি নির্বাচন করেন, তখন HTML ফাইলটি একটি নতুন ট্যাবে খোলে। ফাইলটির প্রসেসিং, তা প্রদর্শন করা হোক বা অন্য কোনোভাবে ব্যবহার করা হোক, উপযুক্ত ওয়েব প্ল্যাটফর্ম API ব্যবহার করে জাভাস্ক্রিপ্টের মাধ্যমে করা হয়। প্রসেসিং কোড অবশ্যই একটি পৃথক জাভাস্ক্রিপ্ট ফাইলে থাকতে হবে এবং একটি <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];
});
}
``````