chrome.tabs

বর্ণনা

ব্রাউজারের ট্যাব সিস্টেমের সাথে সংযোগ স্থাপনের জন্য chrome.tabs API ব্যবহার করুন। এই API ব্যবহার করে আপনি ব্রাউজারে ট্যাব তৈরি, পরিবর্তন এবং পুনর্বিন্যাস করতে পারেন।

সংক্ষিপ্ত বিবরণ

ট্যাবস এপিআই শুধু ট্যাব পরিচালনা ও নিয়ন্ত্রণের সুবিধাই দেয় না, বরং এটি ট্যাবের ভাষা শনাক্ত করতে, স্ক্রিনশট নিতে এবং ট্যাবের কন্টেন্ট স্ক্রিপ্টের সাথে যোগাযোগ করতেও পারে।

অনুমতি

বেশিরভাগ ফিচার ব্যবহার করার জন্য কোনো অনুমতির প্রয়োজন হয় না। উদাহরণস্বরূপ: নতুন ট্যাব তৈরি করা , ট্যাব রিলোড করা , অন্য কোনো ইউআরএল-এ যাওয়া , ইত্যাদি।

ট্যাবস এপিআই নিয়ে কাজ করার সময় ডেভেলপারদের তিনটি পারমিশন সম্পর্কে সচেতন থাকা উচিত।

"ট্যাবস" অনুমতি
এই অনুমতিটি chrome.tabs নেমস্পেসে অ্যাক্সেস দেয় না। পরিবর্তে, এটি একটি এক্সটেনশনকে tabs.Tab ইনস্ট্যান্সের চারটি সংবেদনশীল প্রপার্টি— url , pendingUrl , title , এবং favIconUrl এর উপর tabs.query() কল করার ক্ষমতা প্রদান করে।
হোস্টের অনুমতি
হোস্ট পারমিশন একটি এক্সটেনশনকে সংশ্লিষ্ট ট্যাবের চারটি সংবেদনশীল tabs.Tab প্রোপার্টি পড়তে এবং কোয়েরি করতে দেয়। এছাড়াও, তারা tabs.captureVisibleTab() , tabs.executeScript() , tabs.insertCSS() , এবং tabs.removeCSS() এর মতো মেথড ব্যবহার করে সংশ্লিষ্ট ট্যাবগুলোর সাথে সরাসরি ইন্টারঅ্যাক্ট করতে পারে।
"activeTab" অনুমতি
ব্যবহারকারীর আহ্বানের প্রতিক্রিয়ায় activeTab একটি এক্সটেনশনকে বর্তমান ট্যাবের জন্য অস্থায়ী হোস্ট পারমিশন প্রদান করে। হোস্ট পারমিশনের মতো নয়, activeTab কোনো সতর্কবার্তা প্রদর্শন করে না।

প্রকাশ

ম্যানিফেস্টে প্রতিটি পারমিশন কীভাবে ঘোষণা করতে হয় তার উদাহরণ নিচে দেওয়া হলো:

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

  {
    "name": "My extension",
    ...
    "host_permissions": [
      "http://*/*",
      "https://*/*"
    ],
    ...
  }

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

ব্যবহারের ক্ষেত্র

নিম্নলিখিত বিভাগগুলিতে কিছু সাধারণ ব্যবহারের উদাহরণ দেখানো হয়েছে।

নতুন ট্যাবে একটি এক্সটেনশন পৃষ্ঠা খোলা

এক্সটেনশন ইনস্টল করার পর একটি নতুন ট্যাবে অনবোর্ডিং পেজ খোলাটা এক্সটেনশনের একটি সাধারণ রীতি। নিচের উদাহরণটিতে দেখানো হয়েছে কীভাবে এটি করতে হয়।

background.js:

chrome.runtime.onInstalled.addListener(({reason}) => {
  if (reason === 'install') {
    chrome.tabs.create({
      url: "onboarding.html"
    });
  }
});

বর্তমান ট্যাবটি পান

এই উদাহরণটি দেখায় যে কীভাবে একটি এক্সটেনশনের সার্ভিস ওয়ার্কার বর্তমানে ফোকাস করা উইন্ডো থেকে (অথবা কোনো ক্রোম উইন্ডো ফোকাস করা না থাকলে, সবচেয়ে সম্প্রতি ফোকাস করা উইন্ডো থেকে) সক্রিয় ট্যাবটি খুঁজে বের করতে পারে। এটিকে সাধারণত ব্যবহারকারীর বর্তমান ট্যাব হিসেবে গণ্য করা যেতে পারে।

  async function getCurrentTab() {
    let queryOptions = { active: true, lastFocusedWindow: true };
    // `tab` will either be a `tabs.Tab` instance or `undefined`.
    let [tab] = await chrome.tabs.query(queryOptions);
    return tab;
  }

  function getCurrentTab(callback) {
    let queryOptions = { active: true, lastFocusedWindow: true };
    chrome.tabs.query(queryOptions, ([tab]) => {
      if (chrome.runtime.lastError)
      console.error(chrome.runtime.lastError);
      // `tab` will either be a `tabs.Tab` instance or `undefined`.
      callback(tab);
    });
  }

নির্দিষ্ট ট্যাবটি নিঃশব্দ করুন

এই উদাহরণটি দেখায় কিভাবে একটি এক্সটেনশন কোনো নির্দিষ্ট ট্যাবের মিউট অবস্থা টগল করতে পারে।

  async function toggleMuteState(tabId) {
    const tab = await chrome.tabs.get(tabId);
    const muted = !tab.mutedInfo.muted;
    await chrome.tabs.update(tabId, {muted});
    console.log(`Tab ${tab.id} is ${muted ? "muted" : "unmuted"}`);
  }

  function toggleMuteState(tabId) {
    chrome.tabs.get(tabId, async (tab) => {
      let muted = !tab.mutedInfo.muted;
      await chrome.tabs.update(tabId, { muted });
      console.log(`Tab ${tab.id} is ${ muted ? "muted" : "unmuted" }`);
    });
  }

ক্লিক করা হলে বর্তমান ট্যাবটি প্রথম অবস্থানে চলে যাবে।

এই উদাহরণটি দেখায় যে ড্র্যাগ চলাকালীন বা না চলাকালীন কীভাবে একটি ট্যাব সরানো যায়। যদিও এই উদাহরণে chrome.tabs.move ব্যবহার করা হয়েছে, ড্র্যাগ চলাকালীন ট্যাব পরিবর্তনকারী অন্যান্য কলগুলোর জন্যও আপনি একই অপেক্ষার ধরণ ব্যবহার করতে পারেন।

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

  async function moveToFirstPosition(activeInfo) {
    try {
      await chrome.tabs.move(activeInfo.tabId, {index: 0});
      console.log("Success.");
    } catch (error) {
      if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
        setTimeout(() => moveToFirstPosition(activeInfo), 50);
      } else {
        console.error(error);
      }
    }
  }

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

  function moveToFirstPositionMV2(activeInfo) {
    chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {
      if (chrome.runtime.lastError) {
        const error = chrome.runtime.lastError;
        if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
          setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);
        } else {
          console.error(error);
        }
      } else {
        console.log("Success.");
      }
    });
  }

নির্বাচিত ট্যাবের কন্টেন্ট স্ক্রিপ্টে একটি বার্তা পাঠান

এই উদাহরণটি দেখায় কিভাবে একটি এক্সটেনশনের সার্ভিস ওয়ার্কার tabs.sendMessage() ব্যবহার করে নির্দিষ্ট ব্রাউজার ট্যাবের কন্টেন্ট স্ক্রিপ্টগুলির সাথে যোগাযোগ করতে পারে।

function sendMessageToActiveTab(message) {
  const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
  const response = await chrome.tabs.sendMessage(tab.id, message);
  // TODO: Do something with the response.
}

সম্প্রসারণের উদাহরণ

ট্যাব এপিআই এক্সটেনশনের আরও ডেমো দেখতে নিচের যেকোনো একটি অন্বেষণ করুন:

প্রকারভেদ

MutedInfo

ক্রোম ৪৬+

ট্যাবটির মিউট অবস্থা এবং সর্বশেষ অবস্থা পরিবর্তনের কারণ।

বৈশিষ্ট্য

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

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

    যে এক্সটেনশনটি মিউট অবস্থা পরিবর্তন করেছে তার আইডি। যদি শেষবার মিউট অবস্থা পরিবর্তনের কারণ কোনো এক্সটেনশন না হয়ে থাকে, তবে এটি সেট করা হয় না।

  • নিঃশব্দ

    বুলিয়ান

    ট্যাবটি মিউট করা আছে কিনা (অর্থাৎ শব্দ বাজছে না)। ট্যাবটি প্লে না হলেও বা বর্তমানে শব্দ না বাজলেও মিউট করা থাকতে পারে। এটি 'মিউটেড' অডিও ইন্ডিকেটরটি দেখা যাচ্ছে কিনা তার সমতুল্য।

  • কারণ

    MutedInfoReason ঐচ্ছিক

    ট্যাবটি মিউট বা আনমিউট করার কারণ। যদি ট্যাবটির মিউট অবস্থা কখনও পরিবর্তন করা না হয়ে থাকে, তবে এটি সেট করা নেই।

MutedInfoReason

ক্রোম ৪৬+

এমন একটি ঘটনা যা একটি মৃদু অবস্থা পরিবর্তন ঘটিয়েছে।

এনাম

"ব্যবহারকারী"
ব্যবহারকারীর একটি ইনপুট অ্যাকশন মিউট অবস্থাটি সেট করেছে।

"ক্যাপচার"
ট্যাব ক্যাপচার শুরু হওয়ায় মিউট অবস্থা পরিবর্তিত হয়েছে।

"সম্প্রসারণ"
extensionId ফিল্ড দ্বারা চিহ্নিত একটি এক্সটেনশন মিউট অবস্থাটি সেট করে।

Tab

বৈশিষ্ট্য

  • সক্রিয়

    বুলিয়ান

    ট্যাবটি তার উইন্ডোতে সক্রিয় আছে কি না। এর মানে এই নয় যে উইন্ডোটি ফোকাস করা আছে।

  • শ্রবণযোগ্য

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

    ক্রোম ৪৫+

    গত কয়েক সেকেন্ডে ট্যাবটি থেকে কোনো শব্দ উৎপন্ন হয়েছে কিনা (তবে মিউট করা থাকলে তা শোনা নাও যেতে পারে)। এটি 'স্পিকার অডিও' ইন্ডিকেটরটি দেখাচ্ছে কিনা, তার সমতুল্য।

  • স্বয়ংক্রিয়ভাবে বাতিলযোগ্য

    বুলিয়ান

    ক্রোম ৫৪+

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

  • বাতিল করা

    বুলিয়ান

    ক্রোম ৫৪+

    ট্যাবটি বাতিল করা হয়েছে কিনা। বাতিল করা ট্যাব হলো এমন একটি ট্যাব যার বিষয়বস্তু মেমরি থেকে আনলোড করা হয়েছে, কিন্তু সেটি ট্যাব স্ট্রিপে তখনও দৃশ্যমান থাকে। পরবর্তীবার সক্রিয় করার সময় এর বিষয়বস্তু পুনরায় লোড হয়।

  • প্রিয় আইকন ইউআরএল

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

    ট্যাবের ফেভিকনের ইউআরএল। এই প্রপার্টিটি কেবল তখনই উপস্থিত থাকে যখন এক্সটেনশনটির "tabs" পারমিশন অথবা পেজটির জন্য হোস্ট পারমিশন থাকে। ট্যাবটি লোড হওয়ার সময় এটি একটি খালি স্ট্রিংও হতে পারে।

  • হিমায়িত

    বুলিয়ান

    ক্রোম ১৩২+

    ট্যাবটি ফ্রোজেন বা স্থির আছে কিনা। একটি ফ্রোজেন ট্যাব ইভেন্ট হ্যান্ডলার বা টাইমার সহ কোনো কাজ সম্পাদন করতে পারে না। এটি ট্যাব স্ট্রিপে দৃশ্যমান থাকে এবং এর বিষয়বস্তু মেমরিতে লোড হয়। সক্রিয় করলে এটি আনফ্রোজেন হয়ে যায়।

  • গ্রুপ আইডি

    সংখ্যা

    ক্রোম ৮৮+

    ট্যাবটি যে গ্রুপের অন্তর্গত, সেই গ্রুপের আইডি।

  • উচ্চতা

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

    ট্যাবটির উচ্চতা পিক্সেলে।

  • হাইলাইট করা হয়েছে

    বুলিয়ান

    ট্যাবটি হাইলাইট করা আছে কিনা।

  • আইডি

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

    ট্যাবের আইডি। একটি ব্রাউজার সেশনের মধ্যে ট্যাব আইডিগুলো অনন্য হয়। কিছু পরিস্থিতিতে একটি ট্যাবকে আইডি দেওয়া নাও হতে পারে; উদাহরণস্বরূপ, sessions API) ব্যবহার করে অন্য ট্যাবগুলো কোয়েরি করার সময়, সেক্ষেত্রে একটি সেশন আইডি থাকতে পারে। অ্যাপস এবং ডেভটুলস উইন্ডোগুলোর জন্য ট্যাব আইডি chrome.tabs.TAB_ID_NONE এ সেট করা যেতে পারে।

  • ছদ্মবেশে

    বুলিয়ান

    ট্যাবটি ইনকগনিটো উইন্ডোতে আছে কি না।

  • সূচক

    সংখ্যা

    উইন্ডোর মধ্যে ট্যাবটির শূন্য-ভিত্তিক সূচক।

  • সর্বশেষ অ্যাক্সেস করা হয়েছে

    সংখ্যা

    ক্রোম ১২১+

    ট্যাবটি তার উইন্ডোতে শেষবার সক্রিয় হওয়ার সময়টি হলো ইপক থেকে অতিবাহিত মিলিসেকেন্ডের সংখ্যা।

  • মিউটইনফো

    MutedInfo ঐচ্ছিক

    ক্রোম ৪৬+

    ট্যাবটির মিউট অবস্থা এবং সর্বশেষ অবস্থা পরিবর্তনের কারণ।

  • ওপেনারট্যাবআইডি

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

    যে ট্যাবটি এই ট্যাবটি খুলেছে তার আইডি, যদি থাকে। এই প্রপার্টিটি কেবল তখনই উপস্থিত থাকে যখন ওপেনার ট্যাবটি তখনও বিদ্যমান থাকে।

  • pendingUrl

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

    ক্রোম ৭৯+

    ট্যাবটি যে URL-এ নেভিগেট করছে, সেটি চূড়ান্ত হওয়ার আগে। এই প্রপার্টিটি কেবল তখনই উপস্থিত থাকে, যদি এক্সটেনশনটির "tabs" পারমিশন অথবা পেজটির জন্য হোস্ট পারমিশন থাকে এবং একটি পেন্ডিং নেভিগেশন থাকে।

  • পিন করা

    বুলিয়ান

    ট্যাবটি পিন করা আছে কিনা।

  • নির্বাচিত

    বুলিয়ান

    অপ্রচলিত

    অনুগ্রহ করে tabs.Tab.highlighted ব্যবহার করুন।

    ট্যাবটি নির্বাচিত আছে কি না।

  • সেশনআইডি

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

    একটি ট্যাবকে স্বতন্ত্রভাবে শনাক্ত করতে ব্যবহৃত সেশন আইডিটি sessions এপিআই থেকে প্রাপ্ত হয়।

  • splitViewId

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

    ক্রোম ১৪০+

    ট্যাবটি যে স্প্লিট ভিউয়ের অন্তর্গত, তার আইডি।

  • অবস্থা

    ট্যাবটির লোডিং অবস্থা।

  • শিরোনাম

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

    ট্যাবের শিরোনাম। এই প্রপার্টিটি কেবল তখনই উপস্থিত থাকে, যদি এক্সটেনশনটির "tabs" পারমিশন অথবা পেজটির জন্য হোস্ট পারমিশন থাকে।

  • ইউআরএল

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

    ট্যাবের প্রধান ফ্রেমের সর্বশেষ কমিট করা URL। এই প্রপার্টিটি কেবল তখনই উপস্থিত থাকে যখন এক্সটেনশনটির "tabs" পারমিশন অথবা পেজটির জন্য হোস্ট পারমিশন থাকে। ট্যাবটি এখনো কমিট করা না হয়ে থাকলে এটি একটি খালি স্ট্রিং হতে পারে। Tab.pendingUrl ও দেখুন।

  • প্রস্থ

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

    ট্যাবটির প্রস্থ পিক্সেলে।

  • উইন্ডোআইডি

    সংখ্যা

    যে উইন্ডোতে ট্যাবটি রয়েছে, তার আইডি।

TabStatus

ক্রোম ৪৪+

ট্যাবটির লোডিং অবস্থা।

এনাম

"আনলোড করা"

"লোডিং"

"সম্পূর্ণ"

WindowType

ক্রোম ৪৪+

জানালার ধরণ।

এনাম

"স্বাভাবিক"

"পপআপ"

"প্যানেল"

'অ্যাপ'

"ডেভটুলস"

ZoomSettings

একটি ট্যাবের মধ্যে জুম পরিবর্তন কীভাবে এবং কোন পরিসরে পরিচালিত হবে তা নির্ধারণ করে।

বৈশিষ্ট্য

  • ডিফল্ট জুম ফ্যাক্টর

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

    ক্রোম ৪৩+

    tabs.getZoomSettings কল করার সময় বর্তমান ট্যাবের জন্য ডিফল্ট জুম লেভেল ফেরত দিতে এটি ব্যবহৃত হয়।

  • মোড

    জুম পরিবর্তন কীভাবে পরিচালিত হবে, অর্থাৎ পৃষ্ঠার প্রকৃত স্কেলিংয়ের জন্য কোন সত্তা দায়ী, তা নির্ধারণ করে; ডিফল্ট হিসেবে এটি automatic

  • পরিধি

    জুমের পরিবর্তনগুলো পেজের অরিজিনের জন্য স্থায়ী হবে, নাকি শুধু এই ট্যাবেই কার্যকর হবে, তা নির্ধারণ করে; automatic মোডে এটি ডিফল্টভাবে per-origin অনুযায়ী এবং অন্যথায় per-tab কাজ করে।

ZoomSettingsMode

ক্রোম ৪৪+

জুম পরিবর্তন কীভাবে পরিচালিত হবে, অর্থাৎ পৃষ্ঠার প্রকৃত স্কেলিংয়ের জন্য কোন সত্তা দায়ী, তা নির্ধারণ করে; ডিফল্ট হিসেবে এটি automatic

এনাম

"স্বয়ংক্রিয়"
জুম পরিবর্তনগুলো ব্রাউজার দ্বারা স্বয়ংক্রিয়ভাবে সম্পন্ন হয়।

"ম্যানুয়াল"
জুম পরিবর্তনের স্বয়ংক্রিয় পরিচালনাকে ওভাররাইড করে। onZoomChange ইভেন্টটি তখনও ডিসপ্যাচ করা হবে, এবং এই ইভেন্টটি লিসেন করা ও ম্যানুয়ালি পেজটি স্কেল করা এক্সটেনশনের দায়িত্ব। এই মোডটি per-origin জুমিং সমর্থন করে না, এবং তাই scope জুম সেটিং উপেক্ষা করে per-tab জুমিং ধরে নেয়।

"প্রতিবন্ধী"
ট্যাবে সমস্ত জুমিং নিষ্ক্রিয় করে। ট্যাবটি ডিফল্ট জুম স্তরে ফিরে আসে এবং জুম পরিবর্তনের সমস্ত প্রচেষ্টা উপেক্ষা করা হয়।

ZoomSettingsScope

ক্রোম ৪৪+

জুমের পরিবর্তনগুলো পেজের অরিজিনের জন্য স্থায়ী হবে, নাকি শুধু এই ট্যাবেই কার্যকর হবে, তা নির্ধারণ করে; automatic মোডে এটি ডিফল্টভাবে per-origin অনুযায়ী এবং অন্যথায় per-tab কাজ করে।

এনাম

"উৎস-ভিত্তিক"
জুম করা পেজের অরিজিনে জুমের পরিবর্তনগুলো স্থায়ী থাকে, অর্থাৎ, সেই একই অরিজিনে নেভিগেট করা অন্য সব ট্যাবও জুম হয়ে যায়। এছাড়াও, per-origin জুমের পরিবর্তনগুলো অরিজিনের সাথেই সংরক্ষিত থাকে, যার মানে হলো, একই অরিজিনের অন্য পেজগুলোতে নেভিগেট করার সময়, সেগুলোর সবগুলোই একই জুম ফ্যাক্টরে জুম হয়ে যায়। এই per-origin সুবিধাটি শুধুমাত্র automatic মোডে পাওয়া যায়।

"প্রতি-ট্যাব"
জুম পরিবর্তন শুধুমাত্র এই ট্যাবেই কার্যকর হয়, এবং অন্য ট্যাবের জুম পরিবর্তন এই ট্যাবের জুমকে প্রভাবিত করে না। এছাড়াও, ট্যাব পরিবর্তনের সময় per-tab জুম পরিবর্তন রিসেট হয়ে যায়; কোনো ট্যাব পরিবর্তন করলে পৃষ্ঠাগুলো সর্বদা তাদের per-origin জুম ফ্যাক্টর সহ লোড হয়।

বৈশিষ্ট্য

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

ক্রোম ৯২+

প্রতি সেকেন্ডে সর্বোচ্চ যতবার captureVisibleTab কল করা যাবে। captureVisibleTab একটি ব্যয়বহুল প্রক্রিয়া এবং এটি খুব ঘন ঘন কল করা উচিত নয়।

মূল্য


SPLIT_VIEW_ID_NONE

ক্রোম ১৪০+

একটি আইডি যা স্প্লিট ট্যাবের অনুপস্থিতি নির্দেশ করে।

মূল্য

-১

TAB_ID_NONE

ক্রোম ৪৬+

একটি আইডি যা ব্রাউজার ট্যাবের অনুপস্থিতি নির্দেশ করে।

মূল্য

-১

TAB_INDEX_NONE

ক্রোম ১২৩+

একটি সূচক যা একটি ট্যাব_স্ট্রিপে ট্যাব সূচকের অনুপস্থিতি নির্দেশ করে।

মূল্য

-১

পদ্ধতি

captureVisibleTab()

প্রতিশ্রুতি
chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)
: Promise<string>

নির্দিষ্ট উইন্ডোতে বর্তমানে সক্রিয় ট্যাবের দৃশ্যমান অংশ ক্যাপচার করে। এই মেথডটি কল করার জন্য, এক্সটেনশনটির অবশ্যই <all_urls> পারমিশন অথবা activeTab পারমিশন থাকতে হবে। যেসব সাইট এক্সটেনশনগুলো সাধারণত অ্যাক্সেস করতে পারে, সেগুলো ছাড়াও এই মেথডটি এক্সটেনশনগুলোকে সংবেদনশীল সাইট ক্যাপচার করার সুযোগ দেয় যা অন্যথায় সীমাবদ্ধ থাকে; এর মধ্যে রয়েছে chrome:-scheme পেজ, অন্যান্য এক্সটেনশনের পেজ এবং data: URL। এই সংবেদনশীল সাইটগুলো শুধুমাত্র activeTab পারমিশন থাকলেই ক্যাপচার করা যায়। ফাইল URL শুধুমাত্র তখনই ক্যাপচার করা যেতে পারে যদি এক্সটেনশনটিকে ফাইল অ্যাক্সেসের অনুমতি দেওয়া হয়।

প্যারামিটার

  • উইন্ডোআইডি

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

    লক্ষ্য উইন্ডো। ডিফল্টরূপে এটি বর্তমান উইন্ডো হয়।

  • বিকল্পগুলি

    ছবির বিবরণ ( ঐচ্ছিক)

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (dataUrl: string) => void

    • ডেটা ইউআরএল

      স্ট্রিং

      একটি ডেটা ইউআরএল যা ক্যাপচার করা ট্যাবের দৃশ্যমান অংশের একটি ছবি এনকোড করে। প্রদর্শনের জন্য এটি একটি HTML img এলিমেন্টের 'src' প্রপার্টিতে অ্যাসাইন করা যেতে পারে।

ফেরত

  • প্রতিশ্রুতি<string>

    ক্রোম ৮৮+

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

connect()

chrome.tabs.connect(
  tabId: number,
  connectInfo?: object,
)
: runtime.Port

নির্দিষ্ট ট্যাবে থাকা কন্টেন্ট স্ক্রিপ্ট(গুলি)-এর সাথে সংযোগ স্থাপন করে। বর্তমান এক্সটেনশনের জন্য নির্দিষ্ট ট্যাবে চলমান প্রতিটি কন্টেন্ট স্ক্রিপ্টে ` runtime.onConnect ইভেন্টটি ফায়ার হয়। আরও বিস্তারিত জানতে, `Content Script Messaging` দেখুন।

প্যারামিটার

  • ট্যাবআইডি

    সংখ্যা

  • সংযোগ তথ্য

    বস্তু ঐচ্ছিক

    • ডকুমেন্ট আইডি

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

      ক্রোম ১০৬+

      ট্যাবের সমস্ত ফ্রেমের পরিবর্তে documentId দ্বারা চিহ্নিত একটি নির্দিষ্ট ডকুমেন্টে পোর্ট খুলুন।

    • ফ্রেমআইডি

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

      ট্যাবের সমস্ত ফ্রেমের পরিবর্তে frameId দ্বারা চিহ্নিত একটি নির্দিষ্ট ফ্রেমে পোর্ট খুলুন।

    • নাম

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

      যেসব কন্টেন্ট স্ক্রিপ্ট কানেকশন ইভেন্টের জন্য লিসেন করছে, তাদের ক্ষেত্রে এটি onConnect-এ পাস করা হয়।

ফেরত

  • একটি পোর্ট যা নির্দিষ্ট ট্যাবে চলমান কন্টেন্ট স্ক্রিপ্টগুলির সাথে যোগাযোগের জন্য ব্যবহার করা যেতে পারে। ট্যাবটি বন্ধ হয়ে গেলে বা বিদ্যমান না থাকলে পোর্টটির runtime.Port ইভেন্টটি ফায়ার হয়।

create()

প্রতিশ্রুতি
chrome.tabs.create(
  createProperties: object,
  callback?: function,
)
: Promise<Tab>

একটি নতুন ট্যাব তৈরি করে।

প্যারামিটার

  • বৈশিষ্ট্য তৈরি করুন

    বস্তু

    • সক্রিয়

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

      ট্যাবটি উইন্ডোর সক্রিয় ট্যাব হবে কিনা। এটি উইন্ডোটি ফোকাসড আছে কিনা তা প্রভাবিত করে না ( windows.update দেখুন)। ডিফল্ট মান হলো true

    • সূচক

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

      উইন্ডোতে ট্যাবটির অবস্থান। প্রদত্ত মানটি শূন্য এবং উইন্ডোতে থাকা ট্যাবের সংখ্যার মধ্যে সীমাবদ্ধ থাকবে।

    • ওপেনারট্যাবআইডি

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

      যে ট্যাবটি এই ট্যাবটি খুলেছে তার আইডি। যদি নির্দিষ্ট করা থাকে, তবে যে ট্যাবটি খুলবে সেটি অবশ্যই নতুন তৈরি হওয়া ট্যাবটির সাথে একই উইন্ডোতে থাকতে হবে।

    • পিন করা

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

      ট্যাবটি পিন করা হবে কিনা। ডিফল্ট মান হলো false

    • নির্বাচিত

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

      অপ্রচলিত

      অনুগ্রহ করে সক্রিয় ব্যবহার করুন।

      ট্যাবটি উইন্ডোর নির্বাচিত ট্যাব হবে কিনা। ডিফল্ট মান হলো true

    • splitWithTabId

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

      বিচারাধীন

      যে বিদ্যমান ট্যাবটি দিয়ে স্প্লিট ভিউ তৈরি করা হবে, তার আইডি। যদি নির্দিষ্ট করা হয়, তবে যে ট্যাবটি দিয়ে স্প্লিট করা হবে, তাকে অবশ্যই নিম্নলিখিত শর্তগুলো পূরণ করতে হবে:

      • এটি অবশ্যই আগে থেকে বিভক্ত ট্যাব হওয়া যাবে না।
      • এটি অবশ্যই নতুন তৈরি করা ট্যাবটির মতো একই উইন্ডোতে থাকতে হবে।
      • যদি windowId নির্দিষ্ট করা থাকে, তবে সেটি অবশ্যই split-with ট্যাবের window ID-এর সমান হতে হবে।
      • যদি index নির্দিষ্ট করা থাকে, তবে সেটি অবশ্যই স্প্লিট-উইথ ট্যাবের সংলগ্ন একটি ইনডেক্স হতে হবে এবং এটি নতুন তৈরি হওয়া ট্যাবের আপেক্ষিক অবস্থানকে প্রভাবিত করবে।
    • ইউআরএল

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

      প্রাথমিকভাবে ট্যাবে যাওয়ার জন্য ইউআরএল। সম্পূর্ণ ইউআরএল-এ অবশ্যই একটি স্কিম অন্তর্ভুক্ত থাকতে হবে (যেমন, 'http://www.google.com', শুধু 'www.google.com' নয়)। রিলেটিভ ইউআরএল এক্সটেনশনের বর্তমান পৃষ্ঠার সাপেক্ষে কাজ করে। ডিফল্ট হিসেবে নতুন ট্যাব পৃষ্ঠাটি ব্যবহৃত হয়।

    • উইন্ডোআইডি

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

      যে উইন্ডোতে নতুন ট্যাব তৈরি করা হবে। ডিফল্ট হিসেবে এটি বর্তমান উইন্ডো ব্যবহৃত হয়।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (tab: Tab) => void

    • ট্যাব

      তৈরি করা ট্যাবটি।

ফেরত

  • প্রতিশ্রুতি< ট্যাব >

    ক্রোম ৮৮+

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

createSplit()

প্রতিশ্রুতি বিচারাধীন
chrome.tabs.createSplit(
  tabIds: [number, number],
  callback?: function,
)
: Promise<number>

বিদ্যমান দুটি ট্যাবকে বিভক্ত করে একটি স্প্লিট ভিউ তৈরি করে।

প্যারামিটার

  • ট্যাবআইডি

    [সংখ্যা, সংখ্যা]

    একটি স্প্লিট ভিউতে জোড়া লাগানোর জন্য ঠিক দুটি ট্যাব আইডির একটি অ্যারে। সমস্ত ট্যাবকে অবশ্যই নিম্নলিখিত শর্তগুলো পূরণ করতে হবে:

    সেগুলো অবশ্যই পাশাপাশি থাকতে হবে। সেগুলো আগে থেকেই স্প্লিট ভিউতে থাকা যাবে না। সেগুলোর windowId , pinned এবং groupId স্টেট অবশ্যই এক হতে হবে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (splitViewId: number) => void

    • splitViewId

      সংখ্যা

      নির্দিষ্ট ট্যাবগুলো সম্বলিত নতুন তৈরি হওয়া স্প্লিট ভিউটির আইডি।

ফেরত

  • প্রতিশ্রুতি<সংখ্যা>

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

detectLanguage()

প্রতিশ্রুতি
chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)
: Promise<string>

একটি ট্যাবের বিষয়বস্তুর প্রধান ভাষা শনাক্ত করে।

প্যারামিটার

  • ট্যাবআইডি

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

    ডিফল্টরূপে বর্তমান উইন্ডোর সক্রিয় ট্যাবটি ব্যবহৃত হয়।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (language: string) => void

    • ভাষা

      স্ট্রিং

      একটি ISO ভাষা কোড, যেমন en বা fr । এই পদ্ধতিতে সমর্থিত ভাষাগুলির সম্পূর্ণ তালিকার জন্য, kLanguageInfoTable দেখুন। দ্বিতীয় থেকে চতুর্থ কলামগুলি পরীক্ষা করা হয় এবং প্রথম নন-NULL মানটি ফেরত দেওয়া হয়, তবে সরলীকৃত চীনা ভাষার ক্ষেত্রে zh-CN ফেরত দেওয়া হয়। কোনো অজানা/অসংজ্ঞায়িত ভাষার জন্য, und ফেরত দেওয়া হয়।

ফেরত

  • প্রতিশ্রুতি<string>

    ক্রোম ৮৮+

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

discard()

প্রমিস ক্রোম ৫৪+
chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)
: Promise<Tab | undefined>

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

প্যারামিটার

  • ট্যাবআইডি

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

    যে ট্যাবটি বাতিল করা হবে তার আইডি। এটি নির্দিষ্ট করা হলে, ট্যাবটি বাতিল করা হয়, যদি না সেটি সক্রিয় থাকে বা ইতিমধ্যে বাতিল করা হয়ে থাকে। এটি বাদ দেওয়া হলে, ব্রাউজার সবচেয়ে কম গুরুত্বপূর্ণ ট্যাবটি বাতিল করে। বাতিল করার মতো কোনো ট্যাব না থাকলে এই প্রক্রিয়াটি ব্যর্থ হতে পারে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (tab?: Tab) => void

    • ট্যাব

      ট্যাব ঐচ্ছিক

      বাতিল করা ট্যাব, যদি তা সফলভাবে বাতিল করা হয়ে থাকে; অন্যথায় অনির্ধারিত।

ফেরত

  • প্রতিশ্রুতি< ট্যাব | অনির্দিষ্ট>

    ক্রোম ৮৮+

    অপারেশনটি সম্পন্ন হওয়ার পর সমাধান হয়ে যায়।

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

duplicate()

প্রতিশ্রুতি
chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)
: Promise<Tab | undefined>

একটি ট্যাবের প্রতিলিপি তৈরি করে।

প্যারামিটার

  • ট্যাবআইডি

    সংখ্যা

    যে ট্যাবটি প্রতিলিপি করতে হবে তার আইডি।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (tab?: Tab) => void

    • ট্যাব

      ট্যাব ঐচ্ছিক

      ডুপ্লিকেট ট্যাব সম্পর্কিত বিবরণ। ` url , pendingUrl , title এবং favIconUrl প্রপার্টিগুলো tabs.Tab অবজেক্টে শুধুমাত্র তখনই অন্তর্ভুক্ত করা হয়, যদি এক্সটেনশনটির "tabs" পারমিশন অথবা পেজটির জন্য হোস্ট পারমিশন থাকে।

ফেরত

  • প্রতিশ্রুতি< ট্যাব | অনির্দিষ্ট>

    ক্রোম ৮৮+

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

executeScript()

Promise ≤ MV2 ( ক্রোম ৯১ থেকে অপ্রচলিত)
chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)
: Promise<any[] | undefined>

Manifest V3-তে scripting.executeScript দ্বারা প্রতিস্থাপিত হয়েছে।

একটি পৃষ্ঠায় জাভাস্ক্রিপ্ট কোড প্রবেশ করায়। বিস্তারিত জানতে, কন্টেন্ট স্ক্রিপ্টস ডকের প্রোগ্রাম্যাটিক ইনজেকশন বিভাগটি দেখুন।

প্যারামিটার

  • ট্যাবআইডি

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

    যে ট্যাবে স্ক্রিপ্টটি চালানো হবে তার আইডি; ডিফল্টরূপে এটি বর্তমান উইন্ডোর সক্রিয় ট্যাব হিসেবে গণ্য হয়।

  • বিস্তারিত

    যে স্ক্রিপ্টটি চালানো হবে তার বিবরণ। হয় কোড অথবা ফাইল প্রপার্টি সেট করতে হবে, কিন্তু উভয়ই একই সাথে সেট করা যাবে না।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (result?: any[]) => void

    • ফলাফল

      যেকোনো[] ঐচ্ছিক

      প্রতিটি ইনজেক্ট করা ফ্রেমে স্ক্রিপ্টটির ফলাফল।

ফেরত

  • প্রতিশ্রুতি<যেকোনো[] | অনির্দিষ্ট>

    ক্রোম ৮৮+

    সমস্ত জাভাস্ক্রিপ্ট নির্বাহ হয়ে যাওয়ার পর এটি সমাধান হয়।

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

get()

প্রতিশ্রুতি
chrome.tabs.get(
  tabId: number,
  callback?: function,
)
: Promise<Tab>

নির্দিষ্ট ট্যাবটির বিবরণ পুনরুদ্ধার করে।

প্যারামিটার

  • ট্যাবআইডি

    সংখ্যা

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (tab: Tab) => void

ফেরত

  • প্রতিশ্রুতি< ট্যাব >

    ক্রোম ৮৮+

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

getAllInWindow()

Promise ≤ MV2 অপ্রচলিত
chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)
: Promise<Tab[]>

অনুগ্রহ করে tabs.query {windowId: windowId} ব্যবহার করুন।

নির্দিষ্ট উইন্ডোর সমস্ত ট্যাবের বিবরণ পাওয়া যায়।

প্যারামিটার

  • উইন্ডোআইডি

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

    ডিফল্টরূপে বর্তমান উইন্ডো ব্যবহৃত হয়।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (tabs: Tab[]) => void

ফেরত

  • প্রতিশ্রুতি< ট্যাব []>

    ক্রোম ৮৮+

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

getCurrent()

প্রতিশ্রুতি
chrome.tabs.getCurrent(
  callback?: function,
)
: Promise<Tab | undefined>

যে ট্যাব থেকে এই স্ক্রিপ্ট কলটি করা হচ্ছে, সেটি পাওয়া যায়। যদি কোনো নন-ট্যাব প্রেক্ষাপট থেকে (যেমন, একটি ব্যাকগ্রাউন্ড পেজ বা পপআপ ভিউ) কল করা হয়, তাহলে এটি undefined রিটার্ন করে।

প্যারামিটার

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (tab?: Tab) => void

ফেরত

  • প্রতিশ্রুতি< ট্যাব | অনির্দিষ্ট>

    ক্রোম ৮৮+

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

getSelected()

Promise ≤ MV2 অপ্রচলিত
chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)
: Promise<Tab>

অনুগ্রহ করে tabs.query {active: true} ব্যবহার করুন।

নির্দিষ্ট উইন্ডোতে নির্বাচিত ট্যাবটি নিয়ে আসে।

প্যারামিটার

  • উইন্ডোআইডি

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

    ডিফল্টরূপে বর্তমান উইন্ডো ব্যবহৃত হয়।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (tab: Tab) => void

ফেরত

  • প্রতিশ্রুতি< ট্যাব >

    ক্রোম ৮৮+

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

getZoom()

প্রতিশ্রুতি
chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
)
: Promise<number>

একটি নির্দিষ্ট ট্যাবের বর্তমান জুম ফ্যাক্টর বের করে।

প্যারামিটার

  • ট্যাবআইডি

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

    যে ট্যাব থেকে বর্তমান জুম ফ্যাক্টরটি নেওয়া হবে তার আইডি; ডিফল্টরূপে এটি বর্তমান উইন্ডোর সক্রিয় ট্যাব হয়ে থাকে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (zoomFactor: number) => void

    • জুম ফ্যাক্টর

      সংখ্যা

      ট্যাবটির বর্তমান জুম ফ্যাক্টর।

ফেরত

  • প্রতিশ্রুতি<সংখ্যা>

    ক্রোম ৮৮+

    ট্যাবটি ফেচ করার পর সেটির বর্তমান জুম ফ্যাক্টর অনুযায়ী সমাধান করা হয়।

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

getZoomSettings()

প্রতিশ্রুতি
chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)
: Promise<ZoomSettings>

একটি নির্দিষ্ট ট্যাবের বর্তমান জুম সেটিংস দেখায়।

প্যারামিটার

  • ট্যাবআইডি

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

    যে ট্যাব থেকে বর্তমান জুম সেটিংস নিতে হবে তার আইডি; ডিফল্টরূপে এটি বর্তমান উইন্ডোর সক্রিয় ট্যাব হয়ে থাকে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (zoomSettings: ZoomSettings) => void

ফেরত

  • প্রতিশ্রুতি< জুম সেটিংস >

    ক্রোম ৮৮+

    ট্যাবের বর্তমান জুম সেটিংস অনুযায়ী সমাধান হয়।

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

goBack()

প্রমিস ক্রোম ৭২+
chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)
: Promise<void>

পূর্ববর্তী পৃষ্ঠায় ফিরে যান, যদি তা উপলব্ধ থাকে।

প্যারামিটার

  • ট্যাবআইডি

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

    যে ট্যাবে ফিরে যেতে হবে তার আইডি; ডিফল্টরূপে এটি বর্তমান উইন্ডোর নির্বাচিত ট্যাবটি হয়ে থাকে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    () => void

ফেরত

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

    ক্রোম ৮৮+

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

goForward()

প্রমিস ক্রোম ৭২+
chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)
: Promise<void>

পরবর্তী পৃষ্ঠা থাকলে, সেখানে যান।

প্যারামিটার

  • ট্যাবআইডি

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

    সামনে এগিয়ে যাওয়ার জন্য ট্যাবের আইডি; ডিফল্টরূপে এটি বর্তমান উইন্ডোর নির্বাচিত ট্যাব হয়ে থাকে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    () => void

ফেরত

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

    ক্রোম ৮৮+

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

group()

প্রমিস ক্রোম ৮৮+
chrome.tabs.group(
  options: object,
  callback?: function,
)
: Promise<number>

একটি নির্দিষ্ট গ্রুপে এক বা একাধিক ট্যাব যোগ করে, অথবা কোনো গ্রুপ নির্দিষ্ট করা না থাকলে, প্রদত্ত ট্যাবগুলোকে একটি নতুন তৈরি করা গ্রুপে যোগ করে।

প্যারামিটার

  • বিকল্পগুলি

    বস্তু

    • বৈশিষ্ট্য তৈরি করুন

      বস্তু ঐচ্ছিক

      গ্রুপ তৈরির জন্য কনফিগারেশন। যদি groupId আগে থেকেই নির্দিষ্ট করা থাকে, তবে এটি ব্যবহার করা যাবে না।

      • উইন্ডোআইডি

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

        নতুন গ্রুপের উইন্ডো। ডিফল্ট হিসেবে বর্তমান উইন্ডো ব্যবহৃত হয়।

    • গ্রুপ আইডি

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

      যে গ্রুপে ট্যাবগুলো যোগ করতে হবে, তার আইডি। এটি নির্দিষ্ট করা না থাকলে একটি নতুন গ্রুপ তৈরি করা হবে।

    • ট্যাবআইডি

      সংখ্যা | [সংখ্যা, ...সংখ্যা[]]

      নির্দিষ্ট গ্রুপে যোগ করার জন্য ট্যাব আইডি বা ট্যাব আইডিগুলোর তালিকা।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (groupId: number) => void

    • গ্রুপ আইডি

      সংখ্যা

      যে গ্রুপে ট্যাবগুলো যোগ করা হয়েছিল, সেই গ্রুপের আইডি।

ফেরত

  • প্রতিশ্রুতি<সংখ্যা>

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

highlight()

প্রতিশ্রুতি
chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)
: Promise<windows.Window>

প্রদত্ত ট্যাবগুলোকে হাইলাইট করে এবং গ্রুপের প্রথমটিতে ফোকাস করে। যদি নির্দিষ্ট ট্যাবটি বর্তমানে সক্রিয় থাকে, তবে এটি আপাতদৃষ্টিতে কিছুই করবে না।

প্যারামিটার

  • হাইলাইটইনফো

    বস্তু

    • ট্যাব

      সংখ্যা | সংখ্যা[]

      হাইলাইট করার জন্য এক বা একাধিক ট্যাব সূচক।

    • উইন্ডোআইডি

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

      যে উইন্ডোটিতে ট্যাবগুলো থাকে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (window: Window) => void

    • জানালা

      যে উইন্ডোর ট্যাবগুলো হাইলাইট করা হয়েছিল, সেটির বিবরণ রয়েছে।

ফেরত

  • প্রতিশ্রুতি< windows.Window >

    ক্রোম ৮৮+

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

insertCSS()

Promise ≤ MV2 ( ক্রোম ৯১ থেকে অপ্রচলিত)
chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)
: Promise<void>

Manifest V3-তে scripting.insertCSS দ্বারা প্রতিস্থাপিত হয়েছে।

একটি পৃষ্ঠায় CSS যুক্ত করে। এই পদ্ধতিতে যুক্ত করা স্টাইলগুলো scripting.removeCSS ব্যবহার করে মুছে ফেলা যায়। বিস্তারিত জানতে, কন্টেন্ট স্ক্রিপ্টস ডক-এর প্রোগ্রাম্যাটিক ইনজেকশন অংশটি দেখুন।

প্যারামিটার

  • ট্যাবআইডি

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

    যে ট্যাবে CSS সন্নিবেশ করতে হবে তার আইডি; ডিফল্টরূপে এটি বর্তমান উইন্ডোর সক্রিয় ট্যাব হয়ে থাকে।

  • বিস্তারিত

    সন্নিবেশ করার জন্য CSS টেক্সটের বিবরণ। হয় কোড অথবা ফাইল প্রপার্টি সেট করতে হবে, কিন্তু উভয়ই একই সাথে সেট করা যাবে না।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    () => void

ফেরত

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

    ক্রোম ৮৮+

    সমস্ত CSS সন্নিবেশ করা হয়ে গেলে সমাধান হয়।

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

move()

প্রতিশ্রুতি
chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
  callback?: function,
)
: Promise<Tab | Tab[]>

এক বা একাধিক ট্যাবকে তার উইন্ডোর মধ্যে একটি নতুন অবস্থানে, অথবা একটি নতুন উইন্ডোতে সরানো যায়। উল্লেখ্য যে, ট্যাবগুলিকে শুধুমাত্র সাধারণ (window.type === "normal") উইন্ডোতেই সরানো যায়।

প্যারামিটার

  • ট্যাবআইডি

    সংখ্যা | সংখ্যা[]

    যে ট্যাব আইডি বা ট্যাব আইডিগুলোর তালিকা সরাতে হবে।

  • moveProperties

    বস্তু

    • সূচক

      সংখ্যা

      উইন্ডোটি যে অবস্থানে সরাতে চান। ট্যাবটিকে উইন্ডোর শেষে রাখতে -1 ব্যবহার করুন।

    • উইন্ডোআইডি

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

      ডিফল্টরূপে ট্যাবটি বর্তমানে যে উইন্ডোতে আছে, সেটিই ব্যবহৃত হয়।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (tabs: Tab | Tab[]) => void

    • ট্যাব

      স্থানান্তরিত ট্যাবগুলো সম্পর্কে বিস্তারিত তথ্য।

ফেরত

  • প্রতিশ্রুতি< ট্যাব | ট্যাব []>

    ক্রোম ৮৮+

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

query()

প্রতিশ্রুতি
chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)
: Promise<Tab[]>

নির্দিষ্ট বৈশিষ্ট্যসম্পন্ন সমস্ত ট্যাব খুঁজে বের করে, অথবা কোনো বৈশিষ্ট্য নির্দিষ্ট না করা থাকলে সমস্ত ট্যাব খুঁজে বের করে।

প্যারামিটার

  • কোয়েরিইনফো

    বস্তু

    • সক্রিয়

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

      ট্যাবগুলো তাদের উইন্ডোতে সক্রিয় আছে কিনা।

    • শ্রবণযোগ্য

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

      ক্রোম ৪৫+

      ট্যাবগুলো শোনা যাচ্ছে কিনা।

    • স্বয়ংক্রিয়ভাবে বাতিলযোগ্য

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

      ক্রোম ৫৪+

      রিসোর্স কমে গেলে ব্রাউজার ট্যাবগুলো স্বয়ংক্রিয়ভাবে বাতিল করতে পারে কিনা।

    • বর্তমান উইন্ডো

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

      ট্যাবগুলো বর্তমান উইন্ডোতে আছে কিনা।

    • বাতিল করা

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

      ক্রোম ৫৪+

      ট্যাবগুলো বাতিল করা হয়েছে কিনা। বাতিল করা ট্যাব হলো এমন একটি ট্যাব যার বিষয়বস্তু মেমরি থেকে আনলোড করা হয়েছে, কিন্তু সেটি ট্যাব স্ট্রিপে তখনও দৃশ্যমান থাকে। পরবর্তীবার সক্রিয় করার সময় এর বিষয়বস্তু পুনরায় লোড হয়।

    • হিমায়িত

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

      ক্রোম ১৩২+

      ট্যাবগুলো ফ্রিজ করা আছে কিনা। একটি ফ্রিজ করা ট্যাব ইভেন্ট হ্যান্ডলার বা টাইমার সহ কোনো কাজ সম্পাদন করতে পারে না। এটি ট্যাব স্ট্রিপে দৃশ্যমান থাকে এবং এর বিষয়বস্তু মেমরিতে লোড হয়। সক্রিয় করলে এটি আনফ্রিজ হয়ে যায়।

    • গ্রুপ আইডি

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

      ক্রোম ৮৮+

      ট্যাবগুলো যে গ্রুপে রয়েছে, সেই গ্রুপের আইডি, অথবা গ্রুপবিহীন ট্যাবগুলোর জন্য tabGroups.TAB_GROUP_ID_NONE

    • হাইলাইট করা হয়েছে

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

      ট্যাবগুলো হাইলাইট করা আছে কিনা।

    • সূচক

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

      তাদের উইন্ডোগুলোর মধ্যে ট্যাবগুলোর অবস্থান।

    • শেষ ফোকাসড উইন্ডো

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

      ট্যাবগুলো সর্বশেষ ফোকাস করা উইন্ডোতে আছে কিনা।

    • নিঃশব্দ

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

      ক্রোম ৪৫+

      ট্যাবগুলো মিউট করা আছে কিনা।

    • পিন করা

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

      ট্যাবগুলো পিন করা আছে কিনা।

    • splitViewId

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

      ক্রোম ১৪০+

      যে স্প্লিট ভিউতে ট্যাবগুলো রয়েছে, তার আইডি; অথবা যে ট্যাবগুলো স্প্লিট ভিউতে নেই, সেগুলোর জন্য tabs.SPLIT_VIEW_ID_NONE

    • অবস্থা

      ট্যাব লোড হওয়ার অবস্থা।

    • শিরোনাম

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

      একটি প্যাটার্নের সাথে পৃষ্ঠার শিরোনামগুলো মেলান। যদি এক্সটেনশনটির কাছে পৃষ্ঠাটির জন্য "tabs" পারমিশন বা হোস্ট পারমিশন না থাকে, তাহলে এই প্রপার্টিটি উপেক্ষা করা হয়।

    • ইউআরএল

      স্ট্রিং | স্ট্রিং[] (ঐচ্ছিক)

      এক বা একাধিক ইউআরএল প্যাটার্নের সাথে ট্যাবগুলো মেলান। ফ্র্যাগমেন্ট আইডেন্টিফায়ারগুলো মেলানো হয় না। যদি এক্সটেনশনটির কাছে পেজটির জন্য "tabs" পারমিশন বা হোস্ট পারমিশন না থাকে, তাহলে এই প্রপার্টিটি উপেক্ষা করা হয়।

    • উইন্ডোআইডি

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

      প্যারেন্ট উইন্ডোর আইডি, অথবা বর্তমান উইন্ডোর জন্য windows.WINDOW_ID_CURRENT

    • উইন্ডো টাইপ

      ট্যাবগুলো যে ধরনের উইন্ডোতে রয়েছে।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    (result: Tab[]) => void

ফেরত

  • প্রতিশ্রুতি< ট্যাব []>

    ক্রোম ৮৮+

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

reload()

প্রতিশ্রুতি
chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)
: Promise<void>

একটি ট্যাব পুনরায় লোড করুন।

প্যারামিটার

  • ট্যাবআইডি

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

    যে ট্যাবটি পুনরায় লোড করতে হবে তার আইডি; ডিফল্টরূপে এটি বর্তমান উইন্ডোর নির্বাচিত ট্যাবটি হয়ে থাকে।

  • পুনরায় লোড করুন বৈশিষ্ট্য

    বস্তু ঐচ্ছিক

    • বাইপাস ক্যাশে

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

      স্থানীয় ক্যাশিং এড়িয়ে যাওয়া হবে কিনা। ডিফল্ট মান হলো false

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    () => void

ফেরত

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

    ক্রোম ৮৮+

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

remove()

প্রতিশ্রুতি
chrome.tabs.remove(
  tabIds: number | number[],
  callback?: function,
)
: Promise<void>

এক বা একাধিক ট্যাব বন্ধ করে।

প্যারামিটার

  • ট্যাবআইডি

    সংখ্যা | সংখ্যা[]

    যে ট্যাব আইডি বা ট্যাব আইডিগুলোর তালিকা বন্ধ করতে চান।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    () => void

ফেরত

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

    ক্রোম ৮৮+

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

removeCSS()

Promise Chrome 87+ ≤ MV2 ( Chrome 91 থেকে বাতিল )
chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)
: Promise<void>

Manifest V3-তে scripting.removeCSS দ্বারা প্রতিস্থাপিত হয়েছে।

পৃষ্ঠা থেকে সেই CSS মুছে ফেলে যা পূর্বে scripting.insertCSS কল করে যোগ করা হয়েছিল।

প্যারামিটার

  • ট্যাবআইডি

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

    যে ট্যাব থেকে CSS অপসারণ করা হবে তার আইডি; ডিফল্টরূপে এটি বর্তমান উইন্ডোর সক্রিয় ট্যাব হয়ে থাকে।

  • যে CSS টেক্সটটি সরাতে হবে তার বিবরণ। হয় কোডটি অথবা ফাইল প্রপার্টিটি সেট করতে হবে, কিন্তু উভয়ই একই সাথে সেট করা যাবে না।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

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

    () => void

ফেরত

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

    ক্রোম ৮৮+

    সমস্ত CSS মুছে ফেলা হলে সমাধান হয়।

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

sendMessage()

প্রতিশ্রুতি
chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
)
: Promise<any>

নির্দিষ্ট ট্যাবে থাকা কন্টেন্ট স্ক্রিপ্ট(গুলি)-তে একটি একক বার্তা পাঠায়। বর্তমান এক্সটেনশনের জন্য নির্দিষ্ট ট্যাবে চলমান প্রতিটি কন্টেন্ট স্ক্রিপ্টে runtime.onMessage ইভেন্টটি ফায়ার হয়।

প্যারামিটার

  • ট্যাবআইডি

    সংখ্যা

  • বার্তা

    যেকোনো

    প্রেরণ করার জন্য বার্তা। এই বার্তাটি একটি JSON-উপযোগী অবজেক্ট হওয়া উচিত।

  • বিকল্পগুলি

    বস্তু ঐচ্ছিক

    • ডকুমেন্ট আইডি

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

      ক্রোম ১০৬+

      ট্যাবের সমস্ত ফ্রেমে বার্তা পাঠানোর পরিবর্তে, documentId দ্বারা চিহ্নিত একটি নির্দিষ্ট ডকুমেন্টে বার্তা পাঠান।

    • ফ্রেমআইডি

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

      ট্যাবের সমস্ত ফ্রেমের পরিবর্তে frameId দ্বারা চিহ্নিত একটি নির্দিষ্ট ফ্রেমে বার্তা পাঠান।

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    ক্রোম ৯৯+

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

    (response: any) => void

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

      যেকোনো

      মেসেজ হ্যান্ডলার কর্তৃক প্রেরিত JSON রেসপন্স অবজেক্ট।

ফেরত

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

    ক্রোম ৯৯+

    কন্টেন্ট স্ক্রিপ্ট থেকে প্রাপ্ত প্রতিক্রিয়ার মাধ্যমে যে প্রমিসটি রিজলভ হয়। নির্দিষ্ট ট্যাবে সংযোগ করার সময় কোনো ত্রুটি ঘটলে, প্রমিসটি রিজেক্ট হয়ে যাবে।

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

sendRequest()

Promise ≤ MV2 অপ্রচলিত
chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)
: Promise<any>

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

নির্দিষ্ট ট্যাবে থাকা কন্টেন্ট স্ক্রিপ্ট(গুলি)তে একটি একক অনুরোধ পাঠায়, এবং প্রতিক্রিয়া ফেরত এলে চালানোর জন্য একটি ঐচ্ছিক কলব্যাকও থাকে। বর্তমান এক্সটেনশনের জন্য নির্দিষ্ট ট্যাবে চলমান প্রতিটি কন্টেন্ট স্ক্রিপ্টে extension.onRequest ইভেন্টটি ফায়ার হয়।

প্যারামিটার

  • ট্যাবআইডি

    সংখ্যা

  • অনুরোধ

    যেকোনো

  • কলব্যাক

    ফাংশন ঐচ্ছিক

    Chrome 99+

    The callback parameter looks like:

    (response: any) => void

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

      যেকোনো

      The JSON response object sent by the handler of the request. If an error occurs while connecting to the specified tab, the promise will be rejected.

ফেরত

  • Promise<any>

    Chrome 99+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

setZoom()

প্রতিশ্রুতি
chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)
: Promise<void>

Zooms a specified tab.

Parameters

  • tabId

    number optional

    The ID of the tab to zoom; defaults to the active tab of the current window.

  • zoomFactor

    সংখ্যা

    The new zoom factor. A value of 0 sets the tab to its current default zoom factor. Values greater than 0 specify a (possibly non-default) zoom factor for the tab.

  • কলব্যাক

    function optional

    The callback parameter looks like:

    () => void

ফেরত

  • Promise<void>

    Chrome 88+

    Resolves after the zoom factor has been changed.

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

setZoomSettings()

প্রতিশ্রুতি
chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)
: Promise<void>

Sets the zoom settings for a specified tab, which define how zoom changes are handled. These settings are reset to defaults upon navigating the tab.

Parameters

  • tabId

    number optional

    The ID of the tab to change the zoom settings for; defaults to the active tab of the current window.

  • zoomSettings

    Defines how zoom changes are handled and at what scope.

  • কলব্যাক

    function optional

    The callback parameter looks like:

    () => void

ফেরত

  • Promise<void>

    Chrome 88+

    Resolves after the zoom settings are changed.

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

ungroup()

PromiseChrome 88+
chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
)
: Promise<void>

Removes one or more tabs from their respective groups. If any groups become empty, they are deleted.

Parameters

  • tabIds

    number | [number, ...number[]]

    The tab ID or list of tab IDs to remove from their respective groups.

  • কলব্যাক

    function optional

    The callback parameter looks like:

    () => void

ফেরত

  • Promise<void>

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

unsplit()

Promise Pending
chrome.tabs.unsplit(
  splitViewId: number,
  callback?: function,
)
: Promise<void>

Separates the tabs in a Split View into independent tabs.

Parameters

  • splitViewId

    সংখ্যা

    The ID of the Split View to separate.

  • কলব্যাক

    function optional

    The callback parameter looks like:

    () => void

ফেরত

  • Promise<void>

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

update()

প্রতিশ্রুতি
chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
)
: Promise<Tab | undefined>

Modifies the properties of a tab. Properties that are not specified in updateProperties are not modified.

Parameters

  • tabId

    number optional

    Defaults to the selected tab of the current window .

  • updateProperties

    বস্তু

    • সক্রিয়

      boolean optional

      Whether the tab should be active. Does not affect whether the window is focused (see windows.update ).

    • autoDiscardable

      boolean optional

      Chrome 54+

      Whether the tab should be discarded automatically by the browser when resources are low.

    • highlighted

      boolean optional

      Adds or removes the tab from the current selection.

    • নিঃশব্দ

      boolean optional

      Chrome 45+

      Whether the tab should be muted.

    • openerTabId

      number optional

      The ID of the tab that opened this tab. If specified, the opener tab must be in the same window as this tab.

    • pinned

      boolean optional

      Whether the tab should be pinned.

    • selected

      boolean optional

      Deprecated

      Please use highlighted .

      Whether the tab should be selected.

    • ইউআরএল

      string optional

      A URL to navigate the tab to. JavaScript URLs are not supported; use scripting.executeScript instead.

  • কলব্যাক

    function optional

    The callback parameter looks like:

    (tab?: Tab) => void

    • ট্যাব

      Tab optional

      Details about the updated tab. The url , pendingUrl , title and favIconUrl properties are only included on the tabs.Tab object if the extension has the "tabs" permission or has host permissions for the page.

ফেরত

  • Promise< Tab | undefined>

    Chrome 88+

    Promises are only supported for Manifest V3 and later, other platforms need to use callbacks.

ইভেন্টগুলি

onActivated

chrome.tabs.onActivated.addListener(
  callback: function,
)

Fires when the active tab in a window changes. Note that the tab's URL may not be set at the time this event fired, but you can listen to onUpdated events so as to be notified when a URL is set.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (activeInfo: object) => void

    • activeInfo

      বস্তু

      • tabId

        সংখ্যা

        The ID of the tab that has become active.

      • windowId

        সংখ্যা

        The ID of the window the active tab changed inside of.

onActiveChanged

≤ MV2 Deprecated
chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Please use tabs.onActivated .

Fires when the selected tab in a window changes. Note that the tab's URL may not be set at the time this event fired, but you can listen to tabs.onUpdated events so as to be notified when a URL is set.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (tabId: number, selectInfo: object) => void

    • tabId

      সংখ্যা

    • selectInfo

      বস্তু

      • windowId

        সংখ্যা

        The ID of the window the selected tab changed inside of.

onAttached

chrome.tabs.onAttached.addListener(
  callback: function,
)

Fired when a tab is attached to a window; for example, because it was moved between windows.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (tabId: number, attachInfo: object) => void

    • tabId

      সংখ্যা

    • attachInfo

      বস্তু

      • newPosition

        সংখ্যা

      • newWindowId

        সংখ্যা

onCreated

chrome.tabs.onCreated.addListener(
  callback: function,
)

Fired when a tab is created. Note that the tab's URL and tab group membership may not be set at the time this event is fired, but you can listen to onUpdated events so as to be notified when a URL is set or the tab is added to a tab group.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (tab: Tab) => void

    • ট্যাব

onDetached

chrome.tabs.onDetached.addListener(
  callback: function,
)

Fired when a tab is detached from a window; for example, because it was moved between windows.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (tabId: number, detachInfo: object) => void

    • tabId

      সংখ্যা

    • detachInfo

      বস্তু

      • oldPosition

        সংখ্যা

      • oldWindowId

        সংখ্যা

onHighlightChanged

≤ MV2 Deprecated
chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Please use tabs.onHighlighted .

Fired when the highlighted or selected tabs in a window changes.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (selectInfo: object) => void

    • selectInfo

      বস্তু

      • tabIds

        number[]

        All highlighted tabs in the window.

      • windowId

        সংখ্যা

        The window whose tabs changed.

onHighlighted

chrome.tabs.onHighlighted.addListener(
  callback: function,
)

Fired when the highlighted or selected tabs in a window changes.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (highlightInfo: object) => void

    • highlightInfo

      বস্তু

      • tabIds

        number[]

        All highlighted tabs in the window.

      • windowId

        সংখ্যা

        The window whose tabs changed.

onMoved

chrome.tabs.onMoved.addListener(
  callback: function,
)

Fired when a tab is moved within a window. Only one move event is fired, representing the tab the user directly moved. Move events are not fired for the other tabs that must move in response to the manually-moved tab. This event is not fired when a tab is moved between windows; for details, see tabs.onDetached .

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (tabId: number, moveInfo: object) => void

    • tabId

      সংখ্যা

    • moveInfo

      বস্তু

      • fromIndex

        সংখ্যা

      • toIndex

        সংখ্যা

      • windowId

        সংখ্যা

onRemoved

chrome.tabs.onRemoved.addListener(
  callback: function,
)

Fired when a tab is closed.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (tabId: number, removeInfo: object) => void

    • tabId

      সংখ্যা

    • removeInfo

      বস্তু

      • isWindowClosing

        বুলিয়ান

        True when the tab was closed because its parent window was closed.

      • windowId

        সংখ্যা

        The window whose tab is closed.

onReplaced

chrome.tabs.onReplaced.addListener(
  callback: function,
)

Fired when a tab is replaced with another tab due to prerendering or instant.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (addedTabId: number, removedTabId: number) => void

    • addedTabId

      সংখ্যা

    • removedTabId

      সংখ্যা

onSelectionChanged

≤ MV2 Deprecated
chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Please use tabs.onActivated .

Fires when the selected tab in a window changes.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (tabId: number, selectInfo: object) => void

    • tabId

      সংখ্যা

    • selectInfo

      বস্তু

      • windowId

        সংখ্যা

        The ID of the window the selected tab changed inside of.

onUpdated

chrome.tabs.onUpdated.addListener(
  callback: function,
)

Fired when a tab is updated.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (tabId: number, changeInfo: object, tab: Tab) => void

    • tabId

      সংখ্যা

    • changeInfo

      বস্তু

      • শ্রবণযোগ্য

        boolean optional

        Chrome 45+

        The tab's new audible state.

      • autoDiscardable

        boolean optional

        Chrome 54+

        The tab's new auto-discardable state.

      • discarded

        boolean optional

        Chrome 54+

        The tab's new discarded state.

      • favIconUrl

        string optional

        The tab's new favicon URL.

      • হিমায়িত

        boolean optional

        Chrome 132+

        The tab's new frozen state.

      • groupId

        number optional

        Chrome 88+

        The tab's new group.

      • mutedInfo

        MutedInfo optional

        Chrome 46+

        The tab's new muted state and the reason for the change.

      • pinned

        boolean optional

        The tab's new pinned state.

      • splitViewId

        number optional

        Chrome 140+

        The tab's new Split View.

      • অবস্থা

        TabStatus optional

        The tab's loading status.

      • শিরোনাম

        string optional

        Chrome 48+

        The tab's new title.

      • ইউআরএল

        string optional

        The tab's URL if it has changed.

    • ট্যাব

onZoomChange

chrome.tabs.onZoomChange.addListener(
  callback: function,
)

Fired when a tab is zoomed.

Parameters

  • কলব্যাক

    ফাংশন

    The callback parameter looks like:

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      বস্তু

      • newZoomFactor

        সংখ্যা

      • oldZoomFactor

        সংখ্যা

      • tabId

        সংখ্যা

      • zoomSettings