বিবরণ
chrome.alarms API ব্যবহার করে কোডটি পর্যায়ক্রমে বা ভবিষ্যতে একটি নির্দিষ্ট সময়ে চালানোর জন্য সময়সূচী করুন।
অনুমতিসমূহ
alarmsম্যানিফেস্ট
chrome.alarms API ব্যবহার করতে, ম্যানিফেস্টে "alarms" অনুমতি ঘোষণা করুন:
{
"name": "My extension",
...
"permissions": [
"alarms"
],
...
}
উদাহরণ
নিম্নলিখিত উদাহরণগুলি দেখায় যে কীভাবে অ্যালার্ম ব্যবহার করতে হয় এবং প্রতিক্রিয়া জানাতে হয়। এই API ব্যবহার করে দেখতে, chrome-extension-samples সংগ্রহস্থল থেকে অ্যালার্ম API উদাহরণটি ইনস্টল করুন।
একটি অ্যালার্ম সেট করুন
এক্সটেনশনটি ইনস্টল করার সময় নিম্নলিখিত উদাহরণটি পরিষেবা কর্মীর মধ্যে একটি অ্যালার্ম সেট করে:
service-worker.js:
chrome.runtime.onInstalled.addListener(async ({ reason }) => {
if (reason !== 'install') {
return;
}
// Create an alarm so we have something to look at in the demo
await chrome.alarms.create('demo-default-alarm', {
delayInMinutes: 1,
periodInMinutes: 1
});
});
অ্যালার্মের উত্তর দিন
নিচের উদাহরণটি অ্যালার্মের নামের উপর ভিত্তি করে অ্যাকশন টুলবার আইকন সেট করে।
service-worker.js:
chrome.alarms.onAlarm.addListener((alarm) => {
chrome.action.setIcon({
path: getIconPath(alarm.name),
});
});
প্রকারভেদ
Alarm
বৈশিষ্ট্য
- নাম
স্ট্রিং
এই অ্যালার্মের নাম।
- মিনিটে সময়কাল
সংখ্যা ঐচ্ছিক
যদি null না হয়, তাহলে অ্যালার্মটি একটি পুনরাবৃত্তিমূলক অ্যালার্ম এবং
periodInMinutesমিনিটের মধ্যে আবার বাজবে। - নির্ধারিত সময়
সংখ্যা
এই অ্যালার্মটি যে সময়ে বাজতে নির্ধারিত ছিল, সেই সময়টি যুগের পরে মিলিসেকেন্ডে (যেমন
Date.now() + n)। পারফরম্যান্সের কারণে, অ্যালার্মটি এর চেয়ে অনেক বেশি বিলম্বিত হতে পারে।
AlarmCreateInfo
বৈশিষ্ট্য
- মিনিটে বিলম্ব করুন
সংখ্যা ঐচ্ছিক
onAlarmইভেন্টটি চালু হওয়ার সময়কাল মিনিটে। - মিনিটে সময়কাল
সংখ্যা ঐচ্ছিক
যদি সেট করা থাকে, তাহলে
whenবাdelayInMinutesদ্বারা নির্দিষ্ট প্রাথমিক ইভেন্টের প্রতিperiodInMinutesমিনিট পরে onAlarm ইভেন্টটি চালু হবে। যদি সেট না করা থাকে, তাহলে অ্যালার্মটি কেবল একবারই চালু হবে। - কখন
সংখ্যা ঐচ্ছিক
যে সময়ে অ্যালার্ম বাজবে, সেই সময়কাল, যুগের পরে মিলিসেকেন্ডে (যেমন
Date.now() + n)।
পদ্ধতি
clear()
chrome.alarms.clear(
name?: string,
callback?: function,
): Promise<boolean>
প্রদত্ত নাম দিয়ে অ্যালার্ম সাফ করে।
পরামিতি
- নাম
স্ট্রিং ঐচ্ছিক
পরিষ্কার করার জন্য অ্যালার্মের নাম। ডিফল্টভাবে খালি স্ট্রিং ব্যবহার করা হয়।
- কলব্যাক
ঐচ্ছিক ফাংশন
callbackপ্যারামিটারটি দেখতে এরকম:(wasCleared: boolean) => void
- পরিষ্কার করা হয়েছে
বুলিয়ান
রিটার্নস
প্রতিশ্রুতি<বুলিয়ান>
ক্রোম ৯১+প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
clearAll()
chrome.alarms.clearAll(
callback?: function,
): Promise<boolean>
সমস্ত অ্যালার্ম সাফ করে।
পরামিতি
- কলব্যাক
ঐচ্ছিক ফাংশন
callbackপ্যারামিটারটি দেখতে এরকম:(wasCleared: boolean) => void
- পরিষ্কার করা হয়েছে
বুলিয়ান
রিটার্নস
প্রতিশ্রুতি<বুলিয়ান>
ক্রোম ৯১+প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
create()
chrome.alarms.create(
name?: string,
alarmInfo: AlarmCreateInfo,
callback?: function,
): Promise<void>
একটি অ্যালার্ম তৈরি করে। alarmInfo দ্বারা নির্দিষ্ট সময়ের কাছাকাছি, onAlarm ইভেন্টটি চালু হয়। যদি একই নামের আরেকটি অ্যালার্ম থাকে (অথবা যদি কোনও নাম উল্লেখ না করা থাকে তবে কোনও নাম থাকে না), তবে এটি বাতিল করা হবে এবং এই অ্যালার্ম দ্বারা প্রতিস্থাপিত হবে।
ব্যবহারকারীর মেশিনের উপর চাপ কমাতে, Chrome সর্বোচ্চ ৩০ সেকেন্ড অন্তর অ্যালার্ম বাজানোর সীমাবদ্ধতা রাখে, কিন্তু নির্দিষ্ট পরিমাণে বিলম্ব করতে পারে। অর্থাৎ, delayInMinutes বা periodInMinutes কে 0.5 এর কম সেট করলে তা মেনে নেওয়া হবে না এবং একটি সতর্কতা জারি করবে। "এখন" এর পরে ৩০ সেকেন্ডের কম সময়ে when কোনও সতর্কতা ছাড়াই সেট করা যেতে পারে তবে প্রকৃতপক্ষে কমপক্ষে ৩০ সেকেন্ডের জন্য অ্যালার্ম বাজবে না।
আপনার অ্যাপ বা এক্সটেনশন ডিবাগ করতে সাহায্য করার জন্য, যখন আপনি এটি আনপ্যাকড লোড করেন, তখন অ্যালার্ম কতবার বাজতে পারে তার কোনও সীমা নেই।
পরামিতি
- নাম
স্ট্রিং ঐচ্ছিক
এই অ্যালার্মটি সনাক্ত করার জন্য ঐচ্ছিক নাম। ডিফল্টভাবে খালি স্ট্রিং ব্যবহার করা হয়।
- অ্যালার্ম তথ্য
অ্যালার্ম কখন বাজবে তা বর্ণনা করে। প্রাথমিক সময়
whenঅথবাdelayInMinutes(কিন্তু উভয়ই নয়) দ্বারা নির্দিষ্ট করতে হবে। যদিperiodInMinutesসেট করা থাকে, তাহলে প্রাথমিক ইভেন্টের প্রতিটিperiodInMinutesমিনিট পরে অ্যালার্মটি পুনরাবৃত্তি হবে। যদিwhenঅথবাdelayInMinutesপুনরাবৃত্তিমূলক অ্যালার্মের জন্য সেট করা না থাকে,periodInMinutesdelayInMinutesএর জন্য ডিফল্ট হিসাবে ব্যবহৃত হয়। - কলব্যাক
ঐচ্ছিক ফাংশন
ক্রোম ১১১+callbackপ্যারামিটারটি দেখতে এরকম:() => void
রিটার্নস
প্রতিশ্রুতি<অকার্যকর>
ক্রোম ১১১+অ্যালার্ম তৈরি হওয়ার পরে সমাধান হয় এমন প্রতিশ্রুতি।
প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
get()
chrome.alarms.get(
name?: string,
callback?: function,
): Promise<Alarm | undefined>
নির্দিষ্ট অ্যালার্ম সম্পর্কে বিশদ তথ্য সংগ্রহ করে।
পরামিতি
রিটার্নস
প্রতিশ্রুতি< অ্যালার্ম | অনির্ধারিত>
ক্রোম ৯১+প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।
getAll()
chrome.alarms.getAll(
callback?: function,
): Promise<Alarm[]>
সমস্ত অ্যালার্মের একটি অ্যারে পায়।
পরামিতি
রিটার্নস
প্রতিশ্রুতি< অ্যালার্ম []>
ক্রোম ৯১+প্রতিশ্রুতিগুলি কেবল ম্যানিফেস্ট V3 এবং পরবর্তী সংস্করণগুলির জন্য সমর্থিত, অন্যান্য প্ল্যাটফর্মগুলিকে কলব্যাক ব্যবহার করতে হবে।