chrome.extension

বর্ণনা

chrome.extension API-এর ইউটিলিটি রয়েছে যা যেকোনো এক্সটেনশন পৃষ্ঠা ব্যবহার করতে পারে। এটি একটি এক্সটেনশন এবং এর বিষয়বস্তু স্ক্রিপ্টের মধ্যে বা এক্সটেনশনগুলির মধ্যে বার্তা আদান-প্রদানের জন্য সমর্থন অন্তর্ভুক্ত করে, যেমনটি মেসেজ পাসিং -এ বিশদভাবে বর্ণিত হয়েছে।

প্রকারভেদ

ViewType

Chrome 44+

এক্সটেনশন ভিউ এর ধরন।

এনাম

"ট্যাব"

"পপআপ"

বৈশিষ্ট্য

inIncognitoContext

ছদ্মবেশী ট্যাবের ভিতরে চলমান বিষয়বস্তু স্ক্রিপ্টগুলির জন্য এবং একটি ছদ্মবেশী প্রক্রিয়ার মধ্যে চলমান এক্সটেনশন পৃষ্ঠাগুলির জন্য সত্য৷ পরেরটি শুধুমাত্র 'বিভক্ত' ছদ্মবেশী_আচরণ সহ এক্সটেনশনগুলিতে প্রযোজ্য।

টাইপ

বুলিয়ান

lastError

≤ MV2 ক্রোম 58 থেকে অবরুদ্ধ

অনুগ্রহ করে runtime.lastError ব্যবহার করুন।

একটি কলব্যাকের আজীবনের জন্য সেট করুন যদি একটি অ্যানসিক্রোনাস এক্সটেনশন এপিআই একটি ত্রুটির ফলে হয়৷ যদি কোনো ত্রুটি না ঘটে থাকে তাহলে সর্বশেষ ত্রুটি undefined হবে।

টাইপ

বস্তু

বৈশিষ্ট্য

  • বার্তা

    স্ট্রিং

    যে ত্রুটি ঘটেছে তার বর্ণনা।

পদ্ধতি

getBackgroundPage()

শুধুমাত্র অগ্রভাগ
chrome.extension.getBackgroundPage()

বর্তমান এক্সটেনশনের ভিতরে চলমান পটভূমি পৃষ্ঠার জন্য জাভাস্ক্রিপ্ট 'উইন্ডো' অবজেক্ট ফেরত দেয়। এক্সটেনশনের কোনো ব্যাকগ্রাউন্ড পৃষ্ঠা না থাকলে শূন্য দেখায়।

রিটার্নস

  • জানালা | অনির্ধারিত

getExtensionTabs()

≤ MV2 ফোরগ্রাউন্ড শুধুমাত্র অপ্রচলিত
 
chrome.extension.getExtensionTabs(
  windowId?: number,
)

অনুগ্রহ করে extension.getViews {type: "tab"} ব্যবহার করুন।

বর্তমান এক্সটেনশনের ভিতরে চলমান প্রতিটি ট্যাবের জন্য জাভাস্ক্রিপ্ট 'উইন্ডো' অবজেক্টের একটি অ্যারে প্রদান করে। যদি windowId নির্দিষ্ট করা থাকে, তবে নির্দিষ্ট উইন্ডোর সাথে সংযুক্ত ট্যাবগুলির শুধুমাত্র 'উইন্ডো' অবজেক্টগুলি প্রদান করে।

পরামিতি

  • উইন্ডো আইডি

    সংখ্যা ঐচ্ছিক

রিটার্নস

  • জানালা[]

    গ্লোবাল উইন্ডো অবজেক্টের অ্যারে

getURL()

≤ MV2 ক্রোম 58 থেকে অবরুদ্ধ
 
chrome.extension.getURL(
  path: string,
)

অনুগ্রহ করে runtime.getURL ব্যবহার করুন।

একটি এক্সটেনশন ইনস্টল ডিরেক্টরির মধ্যে একটি আপেক্ষিক পথকে একটি সম্পূর্ণ-যোগ্য URL-এ রূপান্তর করে৷

পরামিতি

  • পথ

    স্ট্রিং

    একটি এক্সটেনশনের মধ্যে একটি সংস্থানের একটি পথ যা তার ইনস্টল ডিরেক্টরির সাথে সম্পর্কিত।

রিটার্নস

  • স্ট্রিং

    সম্পদের সম্পূর্ণরূপে-যোগ্য URL।

getViews()

শুধুমাত্র অগ্রভাগ
chrome.extension.getViews(
  fetchProperties?: object,
)

বর্তমান এক্সটেনশনের ভিতরে চলমান প্রতিটি পৃষ্ঠার জন্য JavaScript 'উইন্ডো' অবজেক্টের একটি অ্যারে প্রদান করে।

পরামিতি

  • বৈশিষ্ট্যগুলি আনুন

    বস্তু ঐচ্ছিক

    • ট্যাবআইডি

      সংখ্যা ঐচ্ছিক

      Chrome 54+

      একটি ট্যাব আইডি অনুযায়ী একটি ভিউ খুঁজুন। যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তাহলে সমস্ত দর্শন ফেরত দেয়।

    • টাইপ

      ভিউ টাইপ ঐচ্ছিক

      ভিউ পাওয়ার ধরন। যদি বাদ দেওয়া হয়, তবে সমস্ত দর্শন (পটভূমি পৃষ্ঠা এবং ট্যাব সহ) প্রদান করে।

    • উইন্ডো আইডি

      সংখ্যা ঐচ্ছিক

      অনুসন্ধান সীমাবদ্ধ করার উইন্ডো। যদি বাদ দেওয়া হয়, সব ভিউ রিটার্ন করে।

রিটার্নস

  • জানালা[]

    গ্লোবাল অবজেক্টের অ্যারে

isAllowedFileSchemeAccess()

প্রতিশ্রুতি
chrome.extension.isAllowedFileSchemeAccess(
  callback?: function,
)

'file://' স্কিমে এক্সটেনশনের অ্যাক্সেসের অবস্থা পুনরুদ্ধার করে। এটি chrome://extensions পৃষ্ঠার মাধ্যমে অ্যাক্সেসযোগ্য ব্যবহারকারী-নিয়ন্ত্রিত প্রতি-এক্সটেনশন 'ফাইল URL-এ অ্যাক্সেসের অনুমতি দিন' সেটিং-এর সাথে মিলে যায়।

পরামিতি

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (isAllowedAccess: boolean) => void

    • অনুমতিপ্রাপ্ত অ্যাক্সেস

      বুলিয়ান

      যদি এক্সটেনশনটি 'file://' স্কিম অ্যাক্সেস করতে পারে তবে সত্য, অন্যথায় মিথ্যা।

রিটার্নস

  • প্রতিশ্রুতি<বুলিয়ান>

    Chrome 99+

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

isAllowedIncognitoAccess()

প্রতিশ্রুতি
chrome.extension.isAllowedIncognitoAccess(
  callback?: function,
)

ছদ্মবেশী-মোডে এক্সটেনশনের অ্যাক্সেসের অবস্থা পুনরুদ্ধার করে। এটি chrome://extensions পৃষ্ঠার মাধ্যমে অ্যাক্সেসযোগ্য ব্যবহারকারী-নিয়ন্ত্রিত প্রতি-এক্সটেনশন 'ছদ্মবেশে মঞ্জুরিপ্রাপ্ত' সেটিং এর সাথে মিলে যায়।

পরামিতি

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (isAllowedAccess: boolean) => void

    • অনুমতিপ্রাপ্ত অ্যাক্সেস

      বুলিয়ান

      এক্সটেনশনের ছদ্মবেশী মোডে অ্যাক্সেস থাকলে সত্য, অন্যথায় মিথ্যা।

রিটার্নস

  • প্রতিশ্রুতি<বুলিয়ান>

    Chrome 99+

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

sendRequest()

প্রতিশ্রুতি ≤ MV2 অবচয়
 
chrome.extension.sendRequest(
  extensionId?: string,
  request: any,
  callback?: function,
)

অনুগ্রহ করে runtime.sendMessage ব্যবহার করুন।

এক্সটেনশনের মধ্যে অন্যান্য শ্রোতাদের কাছে একটি একক অনুরোধ পাঠায়। runtime.connect এর অনুরূপ, কিন্তু শুধুমাত্র একটি ঐচ্ছিক প্রতিক্রিয়া সহ একটি অনুরোধ পাঠায়। এক্সটেনশনের প্রতিটি পৃষ্ঠায় extension.onRequest ইভেন্টটি চালু করা হয়েছে৷

পরামিতি

  • এক্সটেনশন আইডি

    স্ট্রিং ঐচ্ছিক

    আপনি যে এক্সটেনশনটির সাথে সংযোগ করতে চান তার এক্সটেনশন আইডি। যদি বাদ দেওয়া হয়, ডিফল্ট আপনার নিজস্ব এক্সটেনশন।

  • অনুরোধ

    যেকোনো

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    Chrome 99+

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (response: any) => void

    • প্রতিক্রিয়া

      যেকোনো

      অনুরোধের হ্যান্ডলার দ্বারা পাঠানো JSON প্রতিক্রিয়া অবজেক্ট। যদি এক্সটেনশনের সাথে সংযোগ করার সময় একটি ত্রুটি ঘটে, কলব্যাকটি কোন আর্গুমেন্ট ছাড়াই কল করা হবে এবং runtime.lastError ত্রুটি বার্তায় সেট করা হবে৷

রিটার্নস

  • প্রতিশ্রুতি <কোনও>

    Chrome 99+

    প্রতিশ্রুতিগুলি ম্যানিফেস্ট V3 এবং পরবর্তীতে সমর্থিত, তবে পশ্চাদগামী সামঞ্জস্যের জন্য কলব্যাক প্রদান করা হয়। আপনি একই ফাংশন কলে উভয় ব্যবহার করতে পারবেন না। প্রতিশ্রুতিটি একই ধরণের সাথে সমাধান করে যা কলব্যাকে পাস করা হয়।

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
)

এক্সটেনশনের আপডেট URL-এ ব্যবহৃত ap CGI প্যারামিটারের মান সেট করে। এই মানটি Chrome এক্সটেনশন গ্যালারিতে হোস্ট করা এক্সটেনশনগুলির জন্য উপেক্ষা করা হয়৷

পরামিতি

  • তথ্য

    স্ট্রিং

ঘটনা

onRequest

≤ MV2 বাতিল করা হয়েছে
 
chrome.extension.onRequest.addListener(
  callback: function,
)

অনুগ্রহ করে runtime.onMessage ব্যবহার করুন।

একটি এক্সটেনশন প্রক্রিয়া বা একটি বিষয়বস্তু স্ক্রিপ্ট থেকে একটি অনুরোধ পাঠানো হলে বহিস্কার করা হয়৷

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void

onRequestExternal

≤ MV2 বাতিল করা হয়েছে
 
chrome.extension.onRequestExternal.addListener(
  callback: function,
)

অনুগ্রহ করে runtime.onMessageExternal ব্যবহার করুন।

অন্য এক্সটেনশন থেকে একটি অনুরোধ পাঠানো হলে বহিস্কার করা হয়।

পরামিতি

  • কলব্যাক

    ফাংশন

    callback প্যারামিটারটি এর মতো দেখাচ্ছে: 

    (request: any, sender: runtime.MessageSender, sendResponse: function) => void