chrome.tabs

Catatan: Tabs API dapat digunakan oleh pekerja layanan dan halaman ekstensi, tetapi tidak oleh skrip konten.

Deskripsi

Menggunakan chrome.tabs API untuk berinteraksi dengan sistem tab browser. Anda dapat menggunakan API ini untuk membuat, mengubah, dan mengatur ulang tab di browser.

Tabs API tidak hanya menawarkan fitur untuk memanipulasi dan mengelola tab, tetapi juga dapat mendeteksi bahasa tab, mengambil screenshot, dan berkomunikasi dengan skrip konten tab.

Izin

Sebagian besar fitur tidak memerlukan izin apa pun untuk digunakan. Misalnya: membuat tab baru, memuat ulang tab, menavigasi ke URL lain, dll.

Ada tiga izin yang harus diperhatikan developer saat menggunakan Tabs API.

Izin "tab"

Izin ini tidak memberikan akses ke namespace chrome.tabs. Sebagai gantinya, hal ini memberi ekstensi kemampuan untuk memanggil tabs.query() terhadap empat properti sensitif pada instance tabs.Tab: url, pendingUrl, title, dan favIconUrl.

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

Izin host

Izin host memungkinkan ekstensi membaca dan membuat kueri untuk empat properti tabs.Tab sensitif di tab yang cocok. Pengguna juga dapat berinteraksi langsung dengan tab yang cocok menggunakan metode seperti tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS(), dan tabs.removeCSS().

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

Izin "activeTab"

activeTab memberikan izin host sementara ekstensi untuk tab saat ini sebagai respons terhadap pemanggilan pengguna. Tidak seperti izin host, activeTab tidak memicu peringatan apa pun.

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

Kasus penggunaan

Bagian berikut menunjukkan beberapa kasus penggunaan umum.

Membuka halaman ekstensi di tab baru

Pola umum untuk ekstensi adalah membuka halaman orientasi di tab baru saat ekstensi diinstal. Contoh berikut menunjukkan cara melakukannya.

background.js:

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

Catatan: Contoh ini tidak memerlukan izin apa pun.

Dapatkan tab saat ini

Contoh ini menunjukkan cara pekerja layanan ekstensi dapat mengambil tab aktif dari jendela yang saat ini difokuskan (atau jendela yang baru saja difokuskan, jika tidak ada jendela Chrome yang difokuskan). Hal ini biasanya dapat dianggap sebagai tab pengguna saat ini.

  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);
    });
  }

Menonaktifkan tab yang ditentukan

Contoh ini menunjukkan cara ekstensi dapat mengalihkan status dibisukan untuk tab tertentu.

  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" }`);
    });
  }

Pindahkan tab saat ini ke posisi pertama saat diklik

Contoh ini menunjukkan cara memindahkan tab saat penarikan mungkin sedang berlangsung atau tidak. Meskipun contoh ini menggunakan chrome.tabs.move, Anda dapat menggunakan pola tunggu yang sama untuk panggilan lain yang mengubah tab saat penarikan sedang berlangsung.

  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);
      }
    }
  }

Penting: Menggunakan catch(error) di Promise adalah cara untuk memastikan bahwa error yang mengisi `chrome.runtime.lastError` tidak dicentang.

  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.");
      }
    });
  }

Meneruskan pesan ke skrip konten tab yang dipilih

Contoh ini menunjukkan cara pekerja layanan ekstensi dapat berkomunikasi dengan skrip konten di tab browser tertentu menggunakan 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.
}

Contoh ekstensi

Untuk demo ekstensi Tabs API lainnya, pelajari salah satu opsi berikut:

• Manifes V2 - Ekstensi API Tab.
• Manifes V3 - Pengelola Tab.

Jenis

MutedInfo

Chrome 46+

Status tab yang dibisukan dan alasan perubahan status terakhir.

Properti

• extensionId

  string opsional

  ID ekstensi yang mengubah status dibisukan. Tidak ditetapkan jika ekstensi bukan alasan status dibisukan terakhir diubah.

• dibisukan

  boolean

  Apakah tab dibisukan (dicegah pemutaran suara). Tab dapat dibisukan audionya meskipun tidak diputar atau sedang tidak memutar suara. Setara dengan apakah indikator audio 'bisu' ditampilkan.

• alasan

  MutedInfoReason opsional

  Alasan tab dibisukan atau dibunyikan. Tidak disetel jika status bisukan tab belum pernah diubah.

MutedInfoReason

Chrome 46+

Peristiwa yang menyebabkan perubahan status dibisukan.

Enum

"user"
Tindakan input pengguna menyetel status tanpa suara.

"capture"
Pengambilan tab dimulai, memaksa perubahan status tanpa suara.

"extension"
Ekstensi, yang diidentifikasi oleh kolom extensionId, menetapkan status tanpa suara.

Tab

Properti

• aktif

  boolean

  Apakah tab aktif di jendelanya. Bukan berarti jendela terfokus.

• audible

  boolean opsional

  Chrome 45+

  Apakah tab telah menghasilkan suara selama beberapa detik terakhir (tetapi mungkin tidak akan terdengar jika juga dibisukan). Setara dengan apakah indikator 'audio speaker' ditampilkan.

• autoDiscardable

  boolean

  Chrome 54+

  Apakah tab dapat dihapus secara otomatis oleh browser saat resource hampir habis.

• dihapus

  boolean

  Chrome 54+

  Apakah tab akan dihapus. Tab yang dihapus adalah tab yang kontennya telah dihapus muatannya dari memori, tetapi masih terlihat di tab setrip. Kontennya akan dimuat ulang saat diaktifkan kembali.

• favIconUrl

  string opsional

  URL favicon tab. Properti ini hanya ada jika manifes ekstensi menyertakan izin "tabs". String ini juga dapat berupa string kosong jika tab sedang dimuat.

• groupId

  angka

  Chrome 88 dan yang lebih baru

  ID grup tempat tab berada.

• tinggi

  nomor opsional

  Tinggi tab dalam piksel.

• disorot

  boolean

  Apakah tab disorot.

• id

  nomor opsional

  ID tab. ID tab bersifat unik dalam sesi browser. Dalam situasi tertentu, tab mungkin tidak diberi ID; misalnya, saat membuat kueri tab asing menggunakan sessions API, dalam hal ini ID sesi mungkin ada. ID tab juga dapat disetel ke chrome.tabs.TAB_ID_NONE untuk aplikasi dan jendela devtools.

• samaran

  boolean

  Apakah tab berada dalam jendela samaran.

• index

  angka

  Indeks tab berbasis nol dalam jendelanya.

• lastAccessed

  nomor opsional

  Chrome 121 dan yang lebih baru

  Terakhir kali tab diakses berupa jumlah milidetik sejak epoch.

• mutedInfo

  MutedInfo opsional

  Chrome 46+

  Status tab yang dibisukan dan alasan perubahan status terakhir.

• openerTabId

  nomor opsional

  ID tab yang membuka tab ini, jika ada. Properti ini hanya ada jika tab pembuka masih ada.

• pendingUrl

  string opsional

  Chrome 79 dan yang lebih baru

  URL yang dibuka tab, sebelum di-commit. Properti ini hanya ada jika manifes ekstensi menyertakan izin "tabs" dan ada navigasi yang tertunda.

• dipasangi pin

  boolean

  Apakah tab disematkan.

• dipilih

  boolean

  Tidak digunakan lagi

  Gunakan tabs.Tab.highlighted.

  Apakah tab dipilih.

• sessionId

  string opsional

  ID sesi yang digunakan untuk mengidentifikasi secara unik tab yang diperoleh dari sessions API.

• status

  TabStatus opsional

  Status pemuatan tab.

• title

  string opsional

  Judul tab. Properti ini hanya ada jika manifes ekstensi menyertakan izin "tabs".

• url

  string opsional

  URL terakhir yang di-commit dari frame utama tab. Properti ini hanya ada jika manifes ekstensi menyertakan izin "tabs" dan mungkin berupa string kosong jika tab belum di-commit. Lihat juga Tab.pendingUrl.

• lebar

  nomor opsional

  Lebar tab dalam piksel.

• windowId

  angka

  ID jendela yang berisi tab.

TabStatus

Chrome 44+

Status pemuatan tab.

Enum

WindowType

Chrome 44+

Jenis jendela.

Enum

"normal"

"popup"

"panel"

"devtools"

ZoomSettings

Menentukan bagaimana perubahan zoom di tab ditangani dan cakupannya.

Properti

• defaultZoomFactor

  nomor opsional

  Chrome 43 dan yang lebih baru

  Digunakan untuk menampilkan tingkat zoom default untuk tab saat ini dalam panggilan ke tab.getZoomSettings.

• mode

  ZoomSettingsMode opsional

  Menentukan cara penanganan perubahan zoom, yaitu entitas mana yang bertanggung jawab atas penskalaan halaman yang sebenarnya; setelan defaultnya adalah automatic.

• cakupan

  ZoomSettingsScope opsional

  Menentukan apakah perubahan zoom tetap ada untuk asal halaman, atau hanya diterapkan di tab ini; default ke per-origin saat dalam mode automatic, dan per-tab jika tidak.

ZoomSettingsMode

Chrome 44+

Menentukan cara penanganan perubahan zoom, yaitu entitas mana yang bertanggung jawab atas penskalaan halaman yang sebenarnya; setelan defaultnya adalah automatic.

Enum

"otomatis"
Perubahan zoom ditangani secara otomatis oleh browser.

"manual"
Mengganti penanganan otomatis perubahan zoom. Peristiwa onZoomChange akan tetap dikirim, dan ekstensi bertanggung jawab untuk memproses peristiwa ini dan menskalakan halaman secara manual. Mode ini tidak mendukung zoom per-origin, sehingga mengabaikan setelan zoom scope dan menganggap per-tab.

"disabled"
Menonaktifkan semua zoom pada tab. Tab akan kembali ke tingkat zoom default, dan semua percobaan perubahan zoom akan diabaikan.

ZoomSettingsScope

Chrome 44+

Menentukan apakah perubahan zoom tetap ada untuk asal halaman, atau hanya diterapkan di tab ini; default ke per-origin saat dalam mode automatic, dan per-tab jika tidak.

Enum

"per origin"
Perubahan zoom tetap ada di asal halaman yang di-zoom, yaitu semua tab lain yang dibuka ke asal yang sama juga akan di-zoom. Selain itu, perubahan zoom per-origin disimpan dengan asal, artinya saat membuka halaman lain dengan asal yang sama, semua halaman akan di-zoom ke faktor zoom yang sama. Cakupan per-origin hanya tersedia dalam mode automatic.

"per-tab"
Perubahan zoom hanya berlaku di tab ini, dan perubahan zoom di tab lain tidak memengaruhi zoom tab ini. Selain itu, perubahan zoom per-tab direset saat navigasi; membuka tab selalu memuat halaman dengan faktor zoom per-origin.

Properti

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 dan yang lebih baru

Frekuensi maksimum captureVisibleTab dapat dipanggil per detik. captureVisibleTab mahal dan sebaiknya tidak terlalu sering dipanggil.

Nilai

2

TAB_ID_NONE

Chrome 46+

ID yang menunjukkan tidak adanya tab browser.

Nilai

-1

TAB_INDEX_NONE

Chrome 123 dan yang lebih baru

Indeks yang menyatakan tidak adanya indeks tab dalam tab_strip.

Nilai

-1

Metode

captureVisibleTab()

Promise

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
  callback?: function,
)

Menangkap area yang terlihat dari tab yang sedang aktif di jendela yang ditentukan. Untuk memanggil metode ini, ekstensi harus memiliki izin <all_urls> atau izin activeTab. Selain situs yang biasanya dapat diakses ekstensi, metode ini memungkinkan ekstensi untuk menangkap situs sensitif yang dibatasi, termasuk halaman chrome:-skema, halaman ekstensi lain, dan URL: URL. Situs sensitif ini hanya dapat ditangkap dengan izin activeTab. URL file hanya dapat direkam jika ekstensi telah diberi akses file.

Parameter

• windowId

  nomor opsional

  Jendela target. Default-nya adalah jendela saat ini.

• opsi

  ImageDetails opsional

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (dataUrl: string)=>void

  • dataUrl

    string

    URL data yang mengenkode gambar area yang terlihat dari tab yang diambil. Dapat ditetapkan ke properti 'src' dari elemen img HTML untuk ditampilkan.

Hasil

• Promise<string>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

connect()

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

Menghubungkan ke skrip konten di tab yang ditentukan. Peristiwa runtime.onConnect diaktifkan di setiap skrip konten yang berjalan di tab yang ditentukan untuk ekstensi saat ini. Untuk mengetahui detail selengkapnya, lihat Pesan Skrip Konten.

Parameter

• tabId

  angka

• connectInfo

  objek opsional

  • documentId

    string opsional

    Chrome 106+

    Membuka port ke dokumen tertentu yang diidentifikasi oleh documentId, bukan semua frame di tab.

  • frameId

    nomor opsional

    Membuka port ke frame tertentu yang diidentifikasi oleh frameId, bukan semua frame di tab.

  • name

    string opsional

    Diteruskan ke onConnect untuk skrip konten yang memproses peristiwa koneksi.

Hasil

• runtime.Port

  Port yang dapat digunakan untuk berkomunikasi dengan skrip konten yang berjalan di tab yang ditentukan. Peristiwa runtime.Port port diaktifkan jika tab ditutup atau tidak ada.

create()

Promise

chrome.tabs.create(
  createProperties: object,
  callback?: function,
)

Membuat tab baru.

Parameter

• createProperties

  objek

  • aktif

    boolean opsional

    Apakah tab tersebut akan menjadi tab aktif di jendela. Tidak memengaruhi apakah jendela difokuskan (lihat windows.update). Default-nya adalah true.

  • index

    nomor opsional

    Posisi yang harus diambil tab di jendela. Nilai yang diberikan dibatasi ke antara nol dan jumlah tab di jendela.

  • openerTabId

    nomor opsional

    ID tab yang membuka tab ini. Jika ditentukan, tab pembuka harus berada di jendela yang sama dengan tab yang baru dibuat.

  • dipasangi pin

    boolean opsional

    Apakah tab harus disematkan. Default-nya adalah false

  • dipilih

    boolean opsional

    Tidak digunakan lagi

    Gunakan active.

    Apakah tab akan menjadi tab yang dipilih di jendela. Default-nya adalah true

  • url

    string opsional

    URL yang menjadi tujuan navigasi tab pertama kali. URL yang sepenuhnya memenuhi syarat harus menyertakan skema (yaitu 'http://www.google.com', bukan 'www.google.com'). URL relatif bersifat relatif terhadap halaman saat ini dalam ekstensi. Default-nya adalah Halaman Tab Baru.

  • windowId

    nomor opsional

    Jendela tempat membuat tab baru. Default-nya adalah jendela saat ini.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (tab: Tab)=>void

  • Subscription

    Tab

    Tab yang dibuat.

Hasil

• Promise<Tab>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

detectLanguage()

Promise

chrome.tabs.detectLanguage(
  tabId?: number,
  callback?: function,
)

Mendeteksi bahasa utama konten di tab.

Parameter

• tabId

  nomor opsional

  Setelan default-nya adalah tab aktif dari jendela saat ini.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (language: string)=>void

  • language

    string

    Kode bahasa ISO seperti en atau fr. Untuk mengetahui daftar lengkap bahasa yang didukung oleh metode ini, lihat kLanguageInfoTable. Kolom kedua hingga keempat diperiksa dan nilai non-NULL pertama ditampilkan, kecuali untuk China Aksara Sederhana yang zh-CN-nya ditampilkan. Untuk bahasa yang tidak diketahui/tidak ditentukan, und akan ditampilkan.

Hasil

• Promise<string>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

discard()

Promise Chrome 54+

chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

Membuang tab dari memori. Tab yang dihapus masih terlihat di tab setrip dan dimuat ulang saat diaktifkan.

Parameter

• tabId

  nomor opsional

  ID tab yang akan dihapus. Jika ditentukan, tab akan dihapus kecuali jika aktif atau sudah dihapus. Jika dihilangkan, browser akan menghapus tab yang paling tidak penting. Tindakan ini dapat gagal jika tidak ada tab yang dapat dihapus.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (tab?: Tab)=>void

  • Subscription

    Tab opsional

    Tab yang dihapus, jika berhasil dihapus; tidak ditentukan jika sebaliknya.

Hasil

• Promise<Tab|undefined>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

duplicate()

Promise

chrome.tabs.duplicate(
  tabId: number,
  callback?: function,
)

Menduplikasi tab.

Parameter

• tabId

  angka

  ID tab yang akan diduplikasi.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (tab?: Tab)=>void

  • Subscription

    Tab opsional

    Detail tentang tab duplikat. Objek tabs.Tab tidak berisi url, pendingUrl, title, dan favIconUrl jika izin "tabs" tidak diminta.

Hasil

• Promise<Tab|undefined>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

executeScript()

Promise &leq; MV2 Tidak digunakan lagi sejak Chrome 91

chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Diganti dengan scripting.executeScript di Manifes V3.

Memasukkan kode JavaScript ke halaman. Untuk mengetahui detailnya, lihat bagian injeksi terprogram dalam dokumen skrip konten.

Parameter

• tabId

  nomor opsional

  ID tab untuk menjalankan skrip; setelan defaultnya adalah tab aktif di jendela saat ini.

• detail

  InjectDetails

  Detail skrip yang akan dijalankan. Kode atau properti file harus ditetapkan, tetapi keduanya tidak boleh ditetapkan bersamaan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (result?: any[])=>void

  • hasil

    any[] opsional

    Hasil skrip di setiap frame yang dimasukkan.

Hasil

• Promise<any[]|undefined>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

get()

Promise

chrome.tabs.get(
  tabId: number,
  callback?: function,
)

Mengambil detail tentang tab yang ditentukan.

Parameter

• tabId

  angka

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (tab: Tab)=>void

  • Subscription

    Tab

Hasil

• Promise<Tab>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

getAllInWindow()

Promise &leq; MV2 Tidak digunakan lagi

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

Gunakan tabs.query {windowId: windowId}.

Mendapatkan detail tentang semua tab di jendela yang ditentukan.

Parameter

• windowId

  nomor opsional

  Default-nya adalah jendela saat ini.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (tabs: Tab[])=>void

  • tab

    Tab[]

Hasil

• Promise<Tab[]>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

getCurrent()

Promise

chrome.tabs.getCurrent(
  callback?: function,
)

Mendapatkan tab tempat panggilan skrip ini dilakukan. Menampilkan undefined jika dipanggil dari konteks non-tab (misalnya, halaman latar belakang atau tampilan pop-up).

Parameter

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (tab?: Tab)=>void

  • Subscription

    Tab opsional

Hasil

• Promise<Tab|undefined>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

getSelected()

Promise &leq; MV2 Tidak digunakan lagi

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

Gunakan tabs.query {active: true}.

Mendapatkan tab yang dipilih di jendela yang ditentukan.

Parameter

• windowId

  nomor opsional

  Default-nya adalah jendela saat ini.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (tab: Tab)=>void

  • Subscription

    Tab

Hasil

• Promise<Tab>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

getZoom()

Promise

chrome.tabs.getZoom(
  tabId?: number,
  callback?: function,
)

Mendapatkan faktor zoom saat ini dari tab yang ditentukan.

Parameter

• tabId

  nomor opsional

  ID tab untuk mendapatkan faktor zoom saat ini; setelan defaultnya adalah tab aktif dari jendela saat ini.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (zoomFactor: number)=>void

  • zoomFactor

    angka

    Faktor zoom tab saat ini.

Hasil

• Promise<number>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

getZoomSettings()

Promise

chrome.tabs.getZoomSettings(
  tabId?: number,
  callback?: function,
)

Mendapatkan setelan zoom saat ini untuk tab yang ditentukan.

Parameter

• tabId

  nomor opsional

  ID tab untuk mendapatkan setelan zoom saat ini; setelan defaultnya adalah tab aktif di jendela yang aktif.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (zoomSettings: ZoomSettings)=>void

  • zoomSettings

    ZoomSettings

    Setelan zoom tab saat ini.

Hasil

• Promise<ZoomSettings>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

goBack()

Promise Chrome 72+

chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

Kembali ke halaman sebelumnya, jika tersedia.

Parameter

• tabId

  nomor opsional

  ID tab untuk menavigasi kembali; setelan defaultnya adalah tab yang dipilih di jendela saat ini.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

goForward()

Promise Chrome 72+

chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

Lanjutkan ke halaman berikutnya, jika tersedia.

Parameter

• tabId

  nomor opsional

  ID tab yang akan dinavigasi; setelan defaultnya adalah tab yang dipilih di jendela saat ini.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

group()

Promise Chrome 88+

chrome.tabs.group(
  options: object,
  callback?: function,
)

Menambahkan satu atau beberapa tab ke grup tertentu, atau jika tidak ada grup yang ditentukan, menambahkan tab tertentu ke grup yang baru dibuat.

Parameter

• opsi

  objek

  • createProperties

    objek opsional

    Konfigurasi untuk membuat grup. Tidak dapat digunakan jika groupId sudah ditentukan.

    • windowId

      nomor opsional

      Jendela grup baru. Default-nya adalah jendela saat ini.

  • groupId

    nomor opsional

    ID grup yang akan ditambahi tab. Jika tidak ditentukan, grup baru akan dibuat.

  • tabIds

    nomor|[nomor,...nomor[]]

    ID tab atau daftar ID tab yang akan ditambahkan ke grup yang ditentukan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (groupId: number)=>void

  • groupId

    angka

    ID grup tempat tab ditambahkan.

Hasil

• Promise<number>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

highlight()

Promise

chrome.tabs.highlight(
  highlightInfo: object,
  callback?: function,
)

Menyoroti tab tertentu dan berfokus pada tab pertama di grup. Tampaknya tidak akan melakukan apa pun jika tab yang ditentukan sedang aktif.

Parameter

• highlightInfo

  objek

  • tab

    nomor|angka[]

    Satu atau beberapa indeks tab untuk ditandai.

  • windowId

    nomor opsional

    Jendela yang berisi tab.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (window: Window)=>void

  • jendela

    Jendela

    Berisi detail tentang jendela yang tabnya ditandai.

Hasil

• Promise<windows.Window>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

insertCSS()

Promise &leq; MV2 Tidak digunakan lagi sejak Chrome 91

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Diganti dengan scripting.insertCSS di Manifes V3.

Memasukkan CSS ke halaman. Gaya yang disisipkan dengan metode ini dapat dihapus dengan scripting.removeCSS. Untuk mengetahui detailnya, lihat bagian injeksi terprogram dalam dokumen skrip konten.

Parameter

• tabId

  nomor opsional

  ID tab untuk menyisipkan CSS; setelan defaultnya adalah tab aktif di jendela saat ini.

• detail

  InjectDetails

  Detail teks CSS yang akan disisipkan. Kode atau properti file harus ditetapkan, tetapi keduanya tidak boleh ditetapkan bersamaan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

move()

Promise

chrome.tabs.move(
  tabIds: number|number[],
  moveProperties: object,
  callback?: function,
)

Memindahkan satu atau beberapa tab ke posisi baru dalam jendelanya, atau ke jendela baru. Perhatikan bahwa tab hanya dapat dipindahkan ke dan dari jendela normal (window.type === "normal").

Parameter

• tabIds

  nomor|angka[]

  ID tab atau daftar ID tab yang akan dipindahkan.

• moveProperties

  objek

  • index

    angka

    Posisi untuk memindahkan jendela. Gunakan -1 untuk menempatkan tab di ujung jendela.

  • windowId

    nomor opsional

    Setelan defaultnya adalah jendela tempat tab berada saat ini.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

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

  • tab

    Tab|Tab[]

    Detail tentang tab yang dipindahkan.

Hasil

• Promise<Tab|Tab[]>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

query()

Promise

chrome.tabs.query(
  queryInfo: object,
  callback?: function,
)

Mendapatkan semua tab yang memiliki properti yang ditentukan, atau semua tab jika tidak ada properti yang ditentukan.

Parameter

• queryInfo

  objek

  • aktif

    boolean opsional

    Apakah tab aktif di jendelanya.

  • audible

    boolean opsional

    Chrome 45+

    Apakah tab dapat didengar atau tidak.

  • autoDiscardable

    boolean opsional

    Chrome 54+

    Apakah tab dapat dibuang secara otomatis oleh browser saat sumber daya hampir habis.

  • currentWindow

    boolean opsional

    Apakah tab berada di jendela saat ini.

  • dihapus

    boolean opsional

    Chrome 54+

    Apakah tab akan dihapus. Tab yang dihapus adalah tab yang kontennya telah dihapus muatannya dari memori, tetapi masih terlihat di tab setrip. Kontennya akan dimuat ulang saat diaktifkan kembali.

  • groupId

    nomor opsional

    Chrome 88 dan yang lebih baru

    ID grup tempat tab berada, atau tabGroups.TAB_GROUP_ID_NONE untuk tab yang tidak dikelompokkan.

  • disorot

    boolean opsional

    Apakah tab disorot.

  • index

    nomor opsional

    Posisi tab dalam jendela.

  • lastFocusedWindow

    boolean opsional

    Apakah tab berada di jendela yang terakhir difokuskan.

  • dibisukan

    boolean opsional

    Chrome 45+

    Apakah tab dibisukan.

  • dipasangi pin

    boolean opsional

    Apakah tab disematkan atau tidak.

  • status

    TabStatus opsional

    Status pemuatan tab.

  • title

    string opsional

    Cocokkan judul halaman dengan pola. Properti ini diabaikan jika ekstensi tidak memiliki izin "tabs".

  • url

    string|string[] optional

    Cocokkan tab dengan satu atau beberapa pola URL. ID fragmen tidak cocok. Properti ini diabaikan jika ekstensi tidak memiliki izin "tabs".

  • windowId

    nomor opsional

    ID jendela induk, atau windows.WINDOW_ID_CURRENT untuk jendela saat ini.

  • windowType

    WindowType opsional

    Jenis jendela tempat tab berada.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (result: Tab[])=>void

  • hasil

    Tab[]

Hasil

• Promise<Tab[]>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

reload()

Promise

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
  callback?: function,
)

Muat ulang tab.

Parameter

• tabId

  nomor opsional

  ID tab yang akan dimuat ulang; setelan defaultnya adalah tab yang dipilih di jendela saat ini.

• reloadProperties

  objek opsional

  • bypassCache

    boolean opsional

    Apakah akan mengabaikan penyimpanan cache lokal. Default-nya adalah false.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

remove()

Promise

chrome.tabs.remove(
  tabIds: number|number[],
  callback?: function,
)

Menutup satu atau beberapa tab.

Parameter

• tabIds

  nomor|angka[]

  ID tab atau daftar ID tab yang akan ditutup.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

removeCSS()

Promise Chrome 87+ &leq; MV2 Tidak digunakan lagi sejak Chrome 91

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Diganti dengan scripting.removeCSS di Manifes V3.

Menghapus dari CSS halaman yang sebelumnya dimasukkan oleh panggilan ke scripting.insertCSS.

Parameter

• tabId

  nomor opsional

  ID tab tempat menghapus CSS; setelan defaultnya adalah tab aktif di jendela saat ini.

• detail

  DeleteInjectionDetails

  Detail teks CSS yang akan dihapus. Kode atau properti file harus ditetapkan, tetapi keduanya tidak boleh ditetapkan bersamaan.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

sendMessage()

Promise

chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
  callback?: function,
)

Mengirim satu pesan ke skrip konten pada tab yang ditentukan, dengan callback opsional yang akan dijalankan saat respons dikirim kembali. Peristiwa runtime.onMessage diaktifkan di setiap skrip konten yang berjalan di tab yang ditentukan untuk ekstensi saat ini.

Parameter

• tabId

  angka

• pesan

  apa pun

  Pesan yang akan dikirim. Pesan ini harus berupa objek JSON-ifiable.

• opsi

  objek opsional

  • documentId

    string opsional

    Chrome 106+

    Kirim pesan ke dokumen tertentu yang diidentifikasi oleh documentId, bukan semua frame di tab.

  • frameId

    nomor opsional

    Kirim pesan ke bingkai tertentu yang diidentifikasi oleh frameId, bukan semua frame di tab.

• callback

  fungsi opsional

  Chrome 99 dan yang lebih baru

  Parameter callback terlihat seperti:

  (response: any)=>void

  • respons

    apa pun

    Objek respons JSON yang dikirim oleh pengendali pesan. Jika terjadi error saat menghubungkan ke tab yang ditentukan, callback akan dipanggil tanpa argumen dan runtime.lastError disetel ke pesan error.

Hasil

• Janji<apa pun>

  Chrome 99 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

sendRequest()

Promise &leq; MV2 Tidak digunakan lagi

chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)

Gunakan runtime.sendMessage.

Mengirim satu permintaan ke skrip konten di tab yang ditentukan, dengan callback opsional yang akan dijalankan saat respons dikirim kembali. Peristiwa extension.onRequest diaktifkan di setiap skrip konten yang berjalan di tab yang ditentukan untuk ekstensi saat ini.

Parameter

• tabId

  angka

• minta

  apa pun

• callback

  fungsi opsional

  Chrome 99 dan yang lebih baru

  Parameter callback terlihat seperti:

  (response: any)=>void

  • respons

    apa pun

    Objek respons JSON yang dikirim oleh pengendali permintaan. Jika terjadi error saat menghubungkan ke tab yang ditentukan, callback akan dipanggil tanpa argumen dan runtime.lastError disetel ke pesan error.

Hasil

• Janji<apa pun>

  Chrome 99 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

setZoom()

Promise

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
  callback?: function,
)

Memperbesar tab yang ditentukan.

Parameter

• tabId

  nomor opsional

  ID tab yang akan diperbesar/diperkecil; setelan defaultnya adalah tab aktif di jendela saat ini.

• zoomFactor

  angka

  Faktor zoom baru. Nilai 0 menetapkan tab ke faktor zoom default saat ini. Nilai yang lebih besar dari 0 akan menentukan faktor zoom (mungkin non-default) untuk tab.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

setZoomSettings()

Promise

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
  callback?: function,
)

Menetapkan setelan zoom untuk tab yang ditentukan, yang menentukan cara penanganan perubahan zoom. Setelan ini direset ke default setelah membuka tab.

Parameter

• tabId

  nomor opsional

  ID tab yang akan diubah setelan zoomnya; setelan defaultnya adalah tab aktif di jendela yang aktif.

• zoomSettings

  ZoomSettings

  Menentukan cara penanganan perubahan zoom dan cakupannya.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

ungroup()

Promise Chrome 88+

chrome.tabs.ungroup(
  tabIds: number|[number,...number[]],
  callback?: function,
)

Menghapus satu atau beberapa tab dari grupnya masing-masing. Jika ada grup yang kosong, grup tersebut akan dihapus.

Parameter

• tabIds

  nomor|[nomor,...nomor[]]

  ID tab atau daftar ID tab yang akan dihapus dari grupnya masing-masing.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  ()=>void

Hasil

• Promise<void>

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

update()

Promise

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
  callback?: function,
)

Memodifikasi properti tab. Properti yang tidak ditentukan di updateProperties tidak akan diubah.

Parameter

• tabId

  nomor opsional

  Setelan default-nya adalah tab yang dipilih pada jendela saat ini.

• updateProperties

  objek

  • aktif

    boolean opsional

    Apakah tab harus aktif. Tidak memengaruhi apakah jendela difokuskan (lihat windows.update).

  • autoDiscardable

    boolean opsional

    Chrome 54+

    Apakah tab akan otomatis dihapus oleh browser saat resource hampir habis.

  • disorot

    boolean opsional

    Menambahkan atau menghapus tab dari pilihan saat ini.

  • dibisukan

    boolean opsional

    Chrome 45+

    Apakah tab harus dibisukan.

  • openerTabId

    nomor opsional

    ID tab yang membuka tab ini. Jika ditentukan, tab pembuka harus berada di jendela yang sama dengan tab ini.

  • dipasangi pin

    boolean opsional

    Apakah tab harus disematkan.

  • dipilih

    boolean opsional

    Tidak digunakan lagi

    Gunakan fitur ditandai.

    Apakah tab harus dipilih.

  • url

    string opsional

    URL untuk membuka tab. URL JavaScript tidak didukung; gunakan scripting.executeScript sebagai gantinya.

• callback

  fungsi opsional

  Parameter callback terlihat seperti:

  (tab?: Tab)=>void

  • Subscription

    Tab opsional

    Detail tentang tab yang diperbarui. Objek tabs.Tab tidak berisi url, pendingUrl, title, dan favIconUrl jika izin "tabs" tidak diminta.

Hasil

• Promise<Tab|undefined>

  Chrome 88 dan yang lebih baru

  Promise didukung di Manifes V3 dan yang lebih baru, tetapi callback disediakan untuk kompatibilitas mundur. Anda tidak dapat menggunakan keduanya pada panggilan fungsi yang sama. Promise di-resolve dengan jenis yang sama yang diteruskan ke callback.

Acara

onActivated

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

Diaktifkan saat tab aktif di jendela berubah. Perhatikan bahwa URL tab mungkin tidak ditetapkan pada saat peristiwa ini diaktifkan, tetapi Anda dapat memproses peristiwa onUpdated agar diberi tahu ketika URL ditetapkan.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  (activeInfo: object)=>void

  • activeInfo

    objek

    • tabId

      angka

      ID tab yang telah aktif.

    • windowId

      angka

      ID jendela tempat tab aktif diubah.

onActiveChanged

&leq; MV2 Tidak digunakan lagi

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

Gunakan tabs.onActivated.

Diaktifkan saat tab yang dipilih di jendela berubah. Perhatikan bahwa URL tab mungkin tidak ditetapkan pada saat peristiwa ini diaktifkan, tetapi Anda dapat memproses peristiwa tabs.onUpdated sehingga akan diberi tahu saat URL ditetapkan.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

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

  • tabId

    angka

  • selectInfo

    objek

    • windowId

      angka

      ID jendela tempat tab yang dipilih diubah.

onAttached

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

Diaktifkan saat tab terpasang ke jendela; misalnya, karena dipindahkan antar jendela.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

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

  • tabId

    angka

  • attachInfo

    objek

    • newPosition

      angka

    • newWindowId

      angka

onCreated

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

Diaktifkan saat tab dibuat. Perlu diperhatikan bahwa keanggotaan grup tab dan URL tab mungkin tidak ditetapkan pada saat peristiwa ini diaktifkan, tetapi Anda dapat memproses peristiwa onUpdated untuk mendapatkan notifikasi saat URL ditetapkan atau tab ditambahkan ke grup tab.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  (tab: Tab)=>void

  • Subscription

    Tab

onDetached

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

Diaktifkan saat tab dilepas dari jendela; misalnya, karena dipindahkan antar jendela.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

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

  • tabId

    angka

  • detachInfo

    objek

    • oldPosition

      angka

    • oldWindowId

      angka

onHighlightChanged

&leq; MV2 Tidak digunakan lagi

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

Gunakan tabs.onHighlighted.

Diaktifkan saat tab yang disorot atau dipilih di jendela berubah.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  (selectInfo: object)=>void

  • selectInfo

    objek

    • tabIds

      angka[]

      Semua tab yang disorot di jendela.

    • windowId

      angka

      Jendela yang tabnya berubah.

onHighlighted

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

Diaktifkan saat tab yang disorot atau dipilih di jendela berubah.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  (highlightInfo: object)=>void

  • highlightInfo

    objek

    • tabIds

      angka[]

      Semua tab yang disorot di jendela.

    • windowId

      angka

      Jendela yang tabnya berubah.

onMoved

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

Diaktifkan saat tab dipindahkan di dalam jendela. Hanya satu peristiwa gerakan yang diaktifkan, yang mewakili tab yang langsung dipindahkan pengguna. Peristiwa pemindahan tidak diaktifkan untuk tab lain yang harus dipindahkan sebagai respons terhadap tab yang dipindahkan secara manual. Peristiwa ini tidak diaktifkan saat tab dipindahkan antar-jendela; untuk mengetahui detailnya, lihat tabs.onDetached.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

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

  • tabId

    angka

  • moveInfo

    objek

    • fromIndex

      angka

    • toIndex

      angka

    • windowId

      angka

onRemoved

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

Diaktifkan saat tab ditutup.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

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

  • tabId

    angka

  • removeInfo

    objek

    • isWindowClosing

      boolean

      True saat tab ditutup karena jendela induknya ditutup.

    • windowId

      angka

      Jendela yang tabnya ditutup.

onReplaced

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

Diaktifkan saat tab diganti dengan tab lain karena pra-rendering atau instan.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

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

  • addedTabId

    angka

  • removedTabId

    angka

onSelectionChanged

&leq; MV2 Tidak digunakan lagi

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

Gunakan tabs.onActivated.

Diaktifkan saat tab yang dipilih di jendela berubah.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

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

  • tabId

    angka

  • selectInfo

    objek

    • windowId

      angka

      ID jendela tempat tab yang dipilih diubah.

onUpdated

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

Diaktifkan saat tab diperbarui.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

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

  • tabId

    angka

  • changeInfo

    objek

    • audible

      boolean opsional

      Chrome 45+

      Status audio baru pada tab.

    • autoDiscardable

      boolean opsional

      Chrome 54+

      Status baru tab yang dapat dihapus otomatis.

    • dihapus

      boolean opsional

      Chrome 54+

      Status baru tab dihapus.

    • favIconUrl

      string opsional

      URL favicon baru tab.

    • groupId

      nomor opsional

      Chrome 88 dan yang lebih baru

      Grup baru tab.

    • mutedInfo

      MutedInfo opsional

      Chrome 46+

      Status dibisukan yang baru pada tab dan alasan perubahannya.

    • dipasangi pin

      boolean opsional

      Status tersemat yang baru untuk tab.

    • status

      TabStatus opsional

      Status pemuatan tab.

    • title

      string opsional

      Chrome 48+

      Judul baru tab.

    • url

      string opsional

      URL tab jika telah berubah.

  • Subscription

    Tab

onZoomChange

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

Diaktifkan saat tab di-zoom.

Parameter

• callback

  fungsi

  Parameter callback terlihat seperti:

  (ZoomChangeInfo: object)=>void

  • ZoomChangeInfo

    objek

    • newZoomFactor

      angka

    • oldZoomFactor

      angka

    • tabId

      angka

    • zoomSettings

      ZoomSettings