chrome.types

রিফ্রেশ তারিখ: ২০২৬-০৯-২৫ রোবটস: নোইনডেক্স

বর্ণনা

chrome.types API-তে ক্রোমের জন্য টাইপ ডিক্লারেশনগুলো রয়েছে।

ক্রোম সেটিংস

ChromeSetting প্রোটোটাইপটি Chrome ব্রাউজারের সেটিংসের জন্য কিছু সাধারণ ফাংশন ( get() , set() , এবং clear() ) এবং একটি ইভেন্ট পাবলিশার ( onChange ) প্রদান করে। প্রক্সি সেটিংসের উদাহরণগুলোতে দেখানো হয়েছে যে এই ফাংশনগুলো কীভাবে ব্যবহার করার জন্য তৈরি করা হয়েছে।

পরিধি এবং জীবনচক্র

ক্রোম ব্রাউজার সেটিংসের তিনটি ভিন্ন পরিধির মধ্যে পার্থক্য করে:

regular
regular পরিসরে সেট করা সেটিংস সাধারণ ব্রাউজার উইন্ডোতে প্রযোজ্য হয় এবং যদি সেগুলি ওভাররাইট করা না হয়, তবে ইনকগনিটো উইন্ডোতেও তা বহাল থাকে। এই সেটিংস ডিস্কে সংরক্ষিত হয় এবং নিয়ন্ত্রক এক্সটেনশন দ্বারা মুছে ফেলা না হওয়া পর্যন্ত, অথবা নিয়ন্ত্রক এক্সটেনশনটি নিষ্ক্রিয় বা আনইনস্টল না করা পর্যন্ত অপরিবর্তিত থাকে।
incognito_persistent
incognito_persistent স্কোপে সেট করা সেটিংস শুধুমাত্র ইনকগনিটো উইন্ডোগুলোর জন্য প্রযোজ্য। এগুলোর ক্ষেত্রে, এই সেটিংসগুলো regular সেটিংসকে ওভাররাইড করে। এই সেটিংসগুলো ডিস্কে সংরক্ষিত থাকে এবং নিয়ন্ত্রক এক্সটেনশন দ্বারা মুছে ফেলা না হওয়া পর্যন্ত, অথবা নিয়ন্ত্রক এক্সটেনশনটি নিষ্ক্রিয় বা আনইনস্টল না করা পর্যন্ত অপরিবর্তিত থাকে।
incognito_session_only
incognito_session_only স্কোপে সেট করা সেটিংস শুধুমাত্র ইনকগনিটো উইন্ডোগুলোর ক্ষেত্রেই প্রযোজ্য। এগুলোর জন্য, এই সেটিংসগুলো regular এবং incognito_persistent সেটিংসকে ওভাররাইড করে। এই সেটিংসগুলো ডিস্কে সংরক্ষিত হয় না এবং সর্বশেষ ইনকগনিটো উইন্ডোটি বন্ধ করা হলে মুছে যায়। এগুলো শুধুমাত্র তখনই সেট করা যায় যখন অন্তত একটি ইনকগনিটো উইন্ডো খোলা থাকে।

অগ্রাধিকার

ক্রোম বিভিন্ন স্তরে সেটিংস পরিচালনা করে। নিম্নলিখিত তালিকাটি ক্রমবর্ধমান অগ্রাধিকারের ক্রমে সেই স্তরগুলিকে বর্ণনা করে যা কার্যকর সেটিংসকে প্রভাবিত করতে পারে।

  1. অপারেটিং সিস্টেম দ্বারা প্রদত্ত সিস্টেম সেটিংস
  2. কমান্ড-লাইন প্যারামিটার
  3. এক্সটেনশন দ্বারা প্রদত্ত সেটিংস
  4. নীতিমালা

তালিকাটি থেকে যেমনটা বোঝা যায়, আপনার এক্সটেনশনের মাধ্যমে নির্দিষ্ট করা যেকোনো পরিবর্তন পলিসি দ্বারা বাতিল হয়ে যেতে পারে। আপনার এক্সটেনশনটি কোনো সেটিং প্রদান করতে সক্ষম কিনা অথবা এই সেটিংটি বাতিল হয়ে যাবে কিনা, তা নির্ধারণ করতে আপনি get() ফাংশনটি ব্যবহার করতে পারেন।

উপরে যেমন আলোচনা করা হয়েছে, ক্রোম সাধারণ উইন্ডো এবং ইনকগনিটো উইন্ডোর জন্য আলাদা সেটিংস ব্যবহারের সুযোগ দেয়। নিম্নলিখিত উদাহরণটি এই আচরণটি তুলে ধরে। ধরে নিন যে কোনো পলিসি এই সেটিংসগুলোকে ওভাররাইড করে না এবং একটি এক্সটেনশন সাধারণ উইন্ডোর (R) জন্য সেটিংস এবং ইনকগনিটো উইন্ডোর (I) জন্য সেটিংস নির্ধারণ করতে পারে।

  • যদি শুধু (R) সেট করা থাকে, তাহলে এই সেটিংসগুলো সাধারণ এবং ইনকগনিটো উভয় উইন্ডোর জন্যই কার্যকর হবে।
  • যদি শুধুমাত্র (I) সেট করা থাকে, তবে এই সেটিংসগুলো কেবল ইনকগনিটো উইন্ডোগুলোর জন্য কার্যকর হবে। সাধারণ উইন্ডোগুলো নিম্নস্তর (কমান্ড-লাইন অপশন এবং সিস্টেম সেটিংস) দ্বারা নির্ধারিত সেটিংস ব্যবহার করবে।
  • যদি (R) এবং (I) উভয়ই সেট করা থাকে, তাহলে সাধারণ এবং ইনকগনিটো উইন্ডোর জন্য যথাক্রমে সেই সেটিংসগুলো ব্যবহৃত হয়।

যদি দুই বা ততোধিক এক্সটেনশন একই সেটিংকে ভিন্ন ভিন্ন মানে সেট করতে চায়, তবে সবচেয়ে সম্প্রতি ইনস্টল করা এক্সটেনশনটি অন্য এক্সটেনশনগুলোর উপর অগ্রাধিকার পাবে। যদি সবচেয়ে সম্প্রতি ইনস্টল করা এক্সটেনশনটি শুধুমাত্র (I) সেট করে, তবে সাধারণ উইন্ডোগুলোর সেটিং পূর্বে ইনস্টল করা এক্সটেনশনগুলো দ্বারা নির্ধারণ করা যেতে পারে।

কোনো সেটিংয়ের কার্যকর মান হলো অগ্রাধিকারের নিয়মগুলো বিবেচনা করার ফলে প্রাপ্ত মান। এটি ক্রোম ব্যবহার করে।

প্রকারভেদ

ChromeSetting

একটি ইন্টারফেস যা ক্রোম ব্রাউজারের কোনো সেটিং অ্যাক্সেস করার সুযোগ দেয়। একটি উদাহরণের জন্য accessibilityFeatures দেখুন।

বৈশিষ্ট্য

  • পরিবর্তনে

    ইভেন্ট<ফাংশনভয়েডভয়েড>

    সেটিং পরিবর্তনের পর চালু হয়।

    onChange.addListener ফাংশনটি দেখতে এইরকম:

    (callback: function) => {...}

    • কলব্যাক

      ফাংশন

      callback প্যারামিটারটি দেখতে এইরকম:

      (details: object) => void

      • বিস্তারিত

        বস্তু

        • ছদ্মবেশী নির্দিষ্ট

          বুলিয়ান ঐচ্ছিক

          পরিবর্তিত মানটি ইনকগনিটো সেশনের জন্য নির্দিষ্ট কিনা। এই বৈশিষ্ট্যটি কেবল তখনই উপস্থিত থাকবে, যদি ব্যবহারকারী ইনকগনিটো মোডে এক্সটেনশনটি সক্রিয় করে থাকেন।

        • নিয়ন্ত্রণের স্তর

          সেটিং নিয়ন্ত্রণের মাত্রা।

        • মূল্য

          টি

          পরিবর্তনের পর সেটিংটির মান।

  • পরিষ্কার

    শূন্যতা

    প্রতিশ্রুতি

    সেটিংটি মুছে দেয় এবং ডিফল্ট মান পুনরুদ্ধার করে।

    clear ফাংশনটি দেখতে এইরকম:

    (details: object, callback?: function) => {...}

    • বিস্তারিত

      বস্তু

      কোন সেটিংটি মুছে ফেলতে হবে।

      • পরিধি

        ChromeSettingScope ঐচ্ছিক

        সেটিংটি কোথায় মুছে ফেলতে হবে (ডিফল্ট: সাধারণ)।

    • কলব্যাক

      ফাংশন ঐচ্ছিক

      callback প্যারামিটারটি দেখতে এইরকম:

      () => void

    • ফেরত

      প্রতিশ্রুতি<শূন্য>

      ক্রোম ৯৬+

      পরিষ্কারকরণ কার্যক্রম সমাপ্ত হলে ডাকা হয়েছিল।

      প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

  • পেতে

    শূন্যতা

    প্রতিশ্রুতি

    কোনো সেটিংয়ের মান পায়।

    get ফাংশনটি দেখতে এইরকম:

    (details: object, callback?: function) => {...}

    • বিস্তারিত

      বস্তু

      কোন সেটিংটি বিবেচনা করতে হবে।

      • ছদ্মবেশে

        বুলিয়ান ঐচ্ছিক

        ইনকগনিটো সেশনের জন্য প্রযোজ্য মানটি ফেরত দেওয়া হবে কিনা (ডিফল্ট ফলস)।

    • কলব্যাক

      ফাংশন ঐচ্ছিক

      callback প্যারামিটারটি দেখতে এইরকম:

      (details: object) => void

      • বিস্তারিত

        বস্তু

        বর্তমান কার্যকর মূল্যের বিবরণ।

        • ছদ্মবেশী নির্দিষ্ট

          বুলিয়ান ঐচ্ছিক

          কার্যকরী মানটি ইনকগনিটো সেশনের জন্য নির্দিষ্ট কিনা। এই প্রপার্টিটি কেবল তখনই উপস্থিত থাকবে, যদি get() ফাংশনের details প্যারামিটারে থাকা incognito প্রপার্টিটির মান true হয়।

        • নিয়ন্ত্রণের স্তর

          সেটিং নিয়ন্ত্রণের মাত্রা।

        • মূল্য

          টি

          সেটিংটির মান।

    • ফেরত

      প্রতিশ্রুতি<object>

      ক্রোম ৯৬+

      প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

  • সেট

    শূন্যতা

    প্রতিশ্রুতি

    কোনো সেটিংয়ের মান নির্ধারণ করে।

    set ফাংশনটি দেখতে এইরকম:

    (details: object, callback?: function) => {...}

    • বিস্তারিত

      বস্তু

      কোন সেটিংটি পরিবর্তন করতে হবে।

      • পরিধি

        ChromeSettingScope ঐচ্ছিক

        সেটিংটি কোথায় সেট করতে হবে (ডিফল্ট: সাধারণ)।

      • মূল্য

        টি

        সেটিংটির মান। মনে রাখবেন যে প্রতিটি সেটিং-এর একটি নির্দিষ্ট মানের ধরণ থাকে, যা সেটিংটির সাথেই বর্ণনা করা হয়। কোনো এক্সটেনশনের ভিন্ন ধরনের মান নির্ধারণ করা উচিত নয় ।

    • কলব্যাক

      ফাংশন ঐচ্ছিক

      callback প্যারামিটারটি দেখতে এইরকম:

      () => void

    • ফেরত

      প্রতিশ্রুতি<শূন্য>

      ক্রোম ৯৬+

      নির্ধারিত কার্যক্রম সম্পন্ন হলে ডাকা হয়।

      প্রমিস শুধুমাত্র ম্যানিফেস্ট ভি৩ এবং এর পরবর্তী সংস্করণগুলোতে সমর্থিত, অন্যান্য প্ল্যাটফর্মে কলব্যাক ব্যবহার করতে হবে।

ChromeSettingScope

ক্রোম ৪৪+

ক্রোমসেটিং-এর পরিধি। অন্যতম একটি।

  • regular : রেগুলার প্রোফাইলের জন্য সেটিং (যা অন্য কোথাও ওভাররাইড করা না হলে ইনকগনিটো প্রোফাইলে স্থানান্তরিত হয়),
  • regular\_only : শুধুমাত্র সাধারণ প্রোফাইলের জন্য সেটিং (ইনকগনিটো প্রোফাইলে এটি প্রযোজ্য নয়),
  • incognito\_persistent : ইনকগনিটো প্রোফাইলের জন্য একটি সেটিং যা ব্রাউজার রিস্টার্টের পরেও টিকে থাকে (সাধারণ প্রেফারেন্সকে ওভাররাইড করে),
  • incognito\_session\_only : ইনকগনিটো প্রোফাইলের জন্য একটি সেটিং যা শুধুমাত্র একটি ইনকগনিটো সেশন চলাকালীন সেট করা যায় এবং ইনকগনিটো সেশন শেষ হলে মুছে যায় (এটি সাধারণ এবং incognito_persistent প্রেফারেন্সগুলোকে ওভাররাইড করে)।

এনাম

'নিয়মিত'

'শুধুমাত্র নিয়মিত'

"অজ্ঞাত_স্থায়ী"

"শুধুমাত্র ছদ্মবেশী সেশন"

LevelOfControl

ক্রোম ৪৪+

অন্যতম

  • not\_controllable : কোনো এক্সটেনশন দ্বারা নিয়ন্ত্রণ করা যায় না
  • controlled\_by\_other\_extensions : উচ্চতর অগ্রাধিকার সম্পন্ন এক্সটেনশন দ্বারা নিয়ন্ত্রিত
  • controllable\_by\_this\_extension : এই এক্সটেনশন দ্বারা নিয়ন্ত্রণ করা যায়
  • controlled\_by\_this\_extension : এই এক্সটেনশন দ্বারা নিয়ন্ত্রিত

এনাম

"অনিয়ন্ত্রণযোগ্য"

"অন্যান্য এক্সটেনশন দ্বারা নিয়ন্ত্রিত"

"এই এক্সটেনশন দ্বারা নিয়ন্ত্রণযোগ্য"

"এই এক্সটেনশন দ্বারা নিয়ন্ত্রিত"