chrome.extension

বিবরণ

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

প্রকারভেদ

ViewType

ক্রোম ৪৪+

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

এনাম

"ট্যাব"

"পপআপ"

বৈশিষ্ট্য

inIncognitoContext

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

আদর্শ

বুলিয়ান

lastError

≤ MV2 Chrome 58 থেকে বন্ধ করা হয়েছে

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

যদি কোনও অ্যানসাইক্রোনাস এক্সটেনশন এপিআই-এর ফলে কোনও ত্রুটি দেখা দেয়, তাহলে কলব্যাকের জীবনকাল নির্ধারণ করুন। যদি কোনও ত্রুটি না ঘটে, তাহলে lastError undefined হবে।

আদর্শ

বস্তু

বৈশিষ্ট্য

  • বার্তা

    স্ট্রিং

    সংঘটিত ত্রুটির বর্ণনা।

পদ্ধতি

getBackgroundPage()

শুধুমাত্র ফোরগ্রাউন্ড
chrome.extension.getBackgroundPage(): Window | undefined

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

রিটার্নস

  • উইন্ডো | অনির্ধারিত

getExtensionTabs()

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

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

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

পরামিতি

  • উইন্ডো আইডি

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

রিটার্নস

  • জানালা[]

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

getURL()

≤ MV2 Chrome 58 থেকে বন্ধ করা হয়েছে
 
chrome.extension.getURL(
  path: string,
): string

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

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

পরামিতি

  • পথ

    স্ট্রিং

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

রিটার্নস

  • স্ট্রিং

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

getViews()

শুধুমাত্র ফোরগ্রাউন্ড
chrome.extension.getViews(
  fetchProperties?: object,
): Window[]

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

পরামিতি

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

    ঐচ্ছিক বস্তু

    • ট্যাবআইডি

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

      ক্রোম ৫৪+

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

    • আদর্শ

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

      যে ধরণের ভিউ পেতে হবে। বাদ দিলে, সমস্ত ভিউ (ব্যাকগ্রাউন্ড পৃষ্ঠা এবং ট্যাব সহ) ফেরত পাঠায়।

    • উইন্ডো আইডি

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

      যে উইন্ডোতে অনুসন্ধান সীমাবদ্ধ রাখতে হবে। বাদ দিলে, সমস্ত ভিউ ফেরত দেয়।

রিটার্নস

  • জানালা[]

    বিশ্বব্যাপী বস্তুর বিন্যাস

isAllowedFileSchemeAccess()

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

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

পরামিতি

  • কলব্যাক

    ঐচ্ছিক ফাংশন

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

    (isAllowedAccess: boolean) => void

    • অনুমোদিত অ্যাক্সেস

      বুলিয়ান

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

রিটার্নস

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

    ক্রোম ৯৯+

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

isAllowedIncognitoAccess()

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

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

পরামিতি

  • কলব্যাক

    ঐচ্ছিক ফাংশন

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

    (isAllowedAccess: boolean) => void

    • অনুমোদিত অ্যাক্সেস

      বুলিয়ান

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

রিটার্নস

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

    ক্রোম ৯৯+

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

sendRequest()

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

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

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

পরামিতি

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

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

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

  • অনুরোধ

    যেকোনো

  • কলব্যাক

    ঐচ্ছিক ফাংশন

    ক্রোম ৯৯+

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

    (response: any) => void

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

      যেকোনো

      অনুরোধের হ্যান্ডলার কর্তৃক প্রেরিত JSON প্রতিক্রিয়া বস্তু। এক্সটেনশনের সাথে সংযোগ করার সময় যদি কোনও ত্রুটি ঘটে, তাহলে প্রতিশ্রুতি প্রত্যাখ্যান করা হবে।

রিটার্নস

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

    ক্রোম ৯৯+

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

setUpdateUrlData()

chrome.extension.setUpdateUrlData(
  data: string,
): void

এক্সটেনশনের আপডেট 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