chrome.alarms

বর্ণনা

অনুমতি

chrome.alarms API ব্যবহার করতে, ম্যানিফেস্টে "alarms" অনুমতি ঘোষণা করুন:

{   "name": "My extension",   ...   "permissions": [     "alarms"   ],   ... } 

ধারণা এবং ব্যবহার

নির্ভরযোগ্য আচরণ নিশ্চিত করতে, API কীভাবে আচরণ করে তা বোঝা সহায়ক।

ডিভাইস ঘুম

একটি ডিভাইস ঘুমন্ত অবস্থায় অ্যালার্ম চলতে থাকে। যাইহোক, একটি অ্যালার্ম একটি ডিভাইস জাগবে না। ডিভাইসটি জেগে উঠলে, কোনো মিস করা অ্যালার্ম ফায়ার হবে। পুনরাবৃত্তি করা অ্যালার্মগুলি সর্বাধিক একবারে ফায়ার হবে এবং তারপরে ডিভাইসটি জেগে ওঠার সময় থেকে শুরু করে নির্দিষ্ট সময়কাল ব্যবহার করে পুনঃনির্ধারণ করা হবে, অ্যালার্মটি মূলত চালানোর জন্য সেট করা থেকে ইতিমধ্যে অতিবাহিত হয়েছে এমন কোনও সময় বিবেচনা না করে৷

জেদ

একটি এক্সটেনশন আপডেট না হওয়া পর্যন্ত অ্যালার্মগুলি সাধারণত টিকে থাকে৷ যাইহোক, এটি নিশ্চিত নয়, এবং ব্রাউজারটি পুনরায় চালু হলে অ্যালার্মগুলি সাফ হয়ে যেতে পারে৷ ফলস্বরূপ, যখন একটি অ্যালার্ম তৈরি করা হয় তখন সঞ্চয়স্থানে একটি মান সেট করার কথা বিবেচনা করুন এবং তারপরে নিশ্চিত করুন যে আপনার পরিষেবা কর্মী প্রতিবার শুরু করার সময় এটি বিদ্যমান রয়েছে। যেমন:

const STORAGE_KEY = "user-preference-alarm-enabled";  async function checkAlarmState() {   const { alarmEnabled } = await chrome.storage.get(STORAGE_KEY);    if (alarmEnabled) {     const alarm = await chrome.alarms.get("my-alarm");      if (!alarm) {       await chrome.alarms.create({ periodInMinutes: 1 });     }   } }  checkAlarmState(); 

উদাহরণ

নিম্নলিখিত উদাহরণগুলি দেখায় কিভাবে একটি অ্যালার্ম ব্যবহার এবং প্রতিক্রিয়া জানাতে হয়। এই APIটি চেষ্টা করতে, chrome-extension-samples repository থেকে Alarm 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),   }); }); 

chrome.alarms.clear(
  name?: string,
): Promise<boolean>

chrome.alarms.clearAll(): Promise<boolean>

chrome.alarms.create(
  name?: string,
  alarmInfo: AlarmCreateInfo,
): Promise<void>

chrome.alarms.get(
  name?: string,
): Promise<Alarm | undefined>

chrome.alarms.getAll(): Promise<Alarm[]>

chrome.alarms.onAlarm.addListener(
  callback: function,
)