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 memanggiltabs.query()
terhadap empat properti sensitif pada instancetabs.Tab
:url
,pendingUrl
,title
, danfavIconUrl
.{ "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 sepertitabs.captureVisibleTab()
,tabs.executeScript()
,tabs.insertCSS()
, dantabs.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"
});
}
});
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);
}
}
}
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:
Jenis
MutedInfo
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
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' muncul.
-
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 baruID 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 kechrome.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 baruTerakhir 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 baruURL 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 lagiGunakan
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 jugaTab.pendingUrl
. -
lebar
nomor opsional
Lebar tab dalam piksel.
-
windowId
angka
ID jendela yang berisi tab.
TabStatus
Status pemuatan tab.
Enum
WindowType
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 baruDigunakan 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 modeautomatic
, danper-tab
jika tidak.
ZoomSettingsMode
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
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
Frekuensi maksimum captureVisibleTab
dapat dipanggil per detik. captureVisibleTab
mahal dan sebaiknya tidak terlalu sering dipanggil.
Nilai
2
TAB_ID_NONE
ID yang menunjukkan tidak adanya tab browser.
Nilai
-1
TAB_INDEX_NONE
Indeks yang menyatakan tidak adanya indeks tab dalam tab_strip.
Nilai
-1
Metode
captureVisibleTab()
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 baruPromise 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
-
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()
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 adalahtrue
. -
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 lagiGunakan 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 yang dibuat.
-
Hasil
-
Promise<Tab>
Chrome 88 dan yang lebih baruPromise 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()
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
ataufr
. 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 yangzh-CN
-nya ditampilkan. Untuk bahasa yang tidak diketahui/tidak ditentukan,und
akan ditampilkan.
-
Hasil
-
Promise<string>
Chrome 88 dan yang lebih baruPromise 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()
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 baruPromise 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()
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
Hasil
-
Promise<Tab | undefined>
Chrome 88 dan yang lebih baruPromise 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()
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
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[] | belum ditentukan>
Chrome 88 dan yang lebih baruPromise 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()
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
-
Hasil
-
Promise<Tab>
Chrome 88 dan yang lebih baruPromise 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()
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 baruPromise 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()
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
Hasil
-
Promise<Tab | undefined>
Chrome 88 dan yang lebih baruPromise 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()
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
-
Hasil
-
Promise<Tab>
Chrome 88 dan yang lebih baruPromise 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()
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 baruPromise 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()
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
Setelan zoom tab saat ini.
-
Hasil
-
Promise<ZoomSettings>
Chrome 88 dan yang lebih baruPromise 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()
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 baruPromise 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()
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 baruPromise 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()
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()
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 | nomor[]
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
Berisi detail tentang jendela yang tabnya ditandai.
-
Hasil
-
Promise<windows.Window>
Chrome 88 dan yang lebih baruPromise 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()
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
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 baruPromise 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()
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 | nomor[]
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
Hasil
-
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()
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 baruID 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[] opsional
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 baruPromise 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()
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 baruPromise 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()
chrome.tabs.remove(
tabIds: number | number[],
callback?: function,
)
Menutup satu atau beberapa tab.
Parameter
-
tabIds
nomor | nomor[]
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 baruPromise 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()
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
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 baruPromise 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()
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
-
callback
fungsi opsional
Chrome 99 dan yang lebih baruParameter
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 baruPromise 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()
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 baruParameter
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 baruPromise 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()
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 dari0
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 baruPromise 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()
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
Menentukan cara penanganan perubahan zoom dan cakupannya.
-
callback
fungsi opsional
Parameter
callback
terlihat seperti:() => void
Hasil
-
Promise<void>
Chrome 88 dan yang lebih baruPromise 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()
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()
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 lagiGunakan 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
Hasil
-
Promise<Tab | undefined>
Chrome 88 dan yang lebih baruPromise 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
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.
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
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
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 baruGrup 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
-
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
-
-