Açıklama
Tarayıcı sekme sistemiyle etkileşim kurmak için chrome.tabs
API'yi kullanın. Tarayıcıda sekme oluşturmak, değiştirmek ve yeniden düzenlemek için bu API'yi kullanabilirsiniz.
Genel Bakış
Sekme API'si, sekmelerle ilgili işlem yapma ve sekmeleri yönetme özelliklerinin yanı sıra sekmenin dilini algılayabilir, ekran görüntüsü alabilir ve sekmenin içerik komut dosyalarıyla iletişim kurabilir.
İzinler
Çoğu özelliğin kullanılması için izin gerekmez. Örneğin: Yeni bir sekme oluşturma, bir sekmeyi yeniden yükleme, başka bir URL'ye geçme vb.
Geliştiricilerin, Tabs API ile çalışırken dikkat etmeleri gereken üç izin vardır.
- "Sekmeler" izni
- Bu izin,
chrome.tabs
ad alanına erişim sağlamaz. Bunun yerine,tabs.Tab
örneklerindeki dört hassas mülkle (url
,pendingUrl
,title
vefavIconUrl
) ilgili olaraktabs.query()
çağrısı yapma olanağı sağlar. - Ana makine izinleri
- Ana makine izinleri, bir uzantının eşleşen sekmenin dört hassas
tabs.Tab
mülkünü okumasına ve sorgulamasına olanak tanır. Ayrıcatabs.captureVisibleTab()
,tabs.executeScript()
,tabs.insertCSS()
vetabs.removeCSS()
gibi yöntemleri kullanarak eşleşen sekmelerle doğrudan etkileşim kurabilirler. - "activeTab" izni
activeTab
, kullanıcı çağrısına yanıt olarak uzantıya geçerli sekme için geçici ana makine izni verir. Ana makine izinlerinin aksine,activeTab
herhangi bir uyarı tetiklemez.
Manifest
Aşağıda, manifest her iznin nasıl beyan edileceğine dair örnekler verilmiştir:
{
"name": "My extension",
...
"permissions": [
"tabs"
],
...
}
{
"name": "My extension",
...
"host_permissions": [
"http://*/*",
"https://*/*"
],
...
}
{
"name": "My extension",
...
"permissions": [
"activeTab"
],
...
}
Kullanım alanları
Aşağıdaki bölümlerde bazı yaygın kullanım alanları gösterilmektedir.
Uzantı sayfasını yeni bir sekmede açma
Uzantılar için yaygın bir kalıp, uzantı yüklendiğinde yeni bir sekmede ilk katılım sayfası açmaktır. Aşağıdaki örnekte bunun nasıl yapılacağı gösterilmektedir.
background.js:
chrome.runtime.onInstalled.addListener(({reason}) => {
if (reason === 'install') {
chrome.tabs.create({
url: "onboarding.html"
});
}
});
Geçerli sekmeyi al
Bu örnek, bir uzantının hizmet çalışanının etkin sekmeyi o anda odaklanılan pencereden (veya hiçbir Chrome penceresine odaklanmıyorsa en son odaklanılan pencereden) nasıl alabileceğini gösterir. Bu genellikle kullanıcının mevcut sekmesi olarak düşünülebilir.
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);
});
}
Belirtilen sekmeyi yoksay
Bu örnekte, bir uzantının belirli bir sekmenin sessiz durumunu nasıl değiştirebileceği gösterilmektedir.
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" }`);
});
}
Tıklandığında geçerli sekmeyi ilk konuma taşıma
Bu örnekte, sürükleme işlemi devam ederken veya devam etmezken bir sekmenin nasıl taşınacağı gösterilmektedir. Bu örnekte chrome.tabs.move
kullanılsa da sürükleme işlemi devam ederken sekmeleri değiştiren diğer çağrılar için aynı bekleme modelini kullanabilirsiniz.
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.");
}
});
}
Seçili sekmenin içerik komut dosyasına mesaj iletme
Bu örnekte, bir uzantının hizmet çalışanının tabs.sendMessage()
kullanarak belirli tarayıcı sekmelerindeki içerik komut dosyalarıyla nasıl iletişim kurabileceği gösterilmektedir.
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.
}
Uzantı örnekleri
Daha fazla Tabs API uzantısı demosu için aşağıdakilerden birini inceleyin:
Türler
MutedInfo
Sekmenin sessiz durumu ve son durum değişikliğinin nedeni.
Özellikler
-
extensionId
dize isteğe bağlı
Sesi kapatma durumunu değiştiren uzantının kimliği. Sessiz durumunun en son değiştirilme nedeni bir uzantı değilse ayarlanmamış olur.
-
ses kapatıldı
boolean
Sekmenin sesinin kapatılıp kapatılmadığı (ses çalmasının engellenip engellenmediği). Sekme, ses çalmayı durdurmamış veya şu anda ses çalmayı durdurmamış olsa bile sessize alınmış olabilir. "Sessiz" ses göstergesinin gösterilip gösterilmediğine eşdeğerdir.
-
neden
MutedInfoReason isteğe bağlı
Sekmenin sessize alınması veya sessize alınmasının kaldırılmasının nedeni. Sekmenin sessize alma durumu hiç değiştirilmediyse ayarlanmamış olur.
MutedInfoReason
Sessize alma durumunun değişmesine neden olan bir etkinlik.
Enum
"user"
Bir kullanıcı girişi işlemi, sessiz durumunu ayarladı.
"capture"
Sekme yakalama işlemi başlatıldı ve sessiz durum değişikliği zorunlu kılındı.
"extension"
extensionId alanıyla tanımlanan bir uzantı, sessiz durumunu ayarladı.
Tab
Özellikler
-
etkin
boolean
Sekmenin penceresinde etkin olup olmadığı. Pencerenin odağa alındığı anlamına gelmez.
-
audible
boole isteğe bağlı
Chrome 45 ve sonraki sürümlerSekmenin son birkaç saniye içinde ses çıkarıp çıkarmadığını belirtir (ancak sessize alınmışsa ses duyulmayabilir). "Hoparlör sesi" göstergesinin gösterilmesiyle eşdeğerdir.
-
autoDiscardable
boolean
Chrome 54 ve sonraki sürümlerKaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak atlanıp atlanamayacağını belirtir.
-
silindi
boolean
Chrome 54 ve sonraki sürümlerSekmenin atlanıp atlanmadığı. Atılan sekme, içeriği bellekten kaldırılmış ancak sekme şeridinde hâlâ görünür olan sekmedir. Bu cihaz tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
-
favIconUrl
dize isteğe bağlı
Sekmenin yer imi simgesinin URL'si. Bu özellik yalnızca uzantının manifest dosyasında
"tabs"
izni varsa bulunur. Sekme yükleniyorsa boş bir dize de olabilir. -
donduruldu
boolean
BeklemedeSekmenin donup donmadığı. Dondurulmuş bir sekme, etkinlik işleyiciler veya zamanlayıcılar da dahil olmak üzere görevleri yürütemez. Sekme şeridinde görünür ve içeriği belleğe yüklenir. Etkinleştirildiğinde dondurulması kaldırılır.
-
groupId
sayı
Chrome 88 ve sonraki sürümlerSekmenin ait olduğu grubun kimliği.
-
yükseklik
number isteğe bağlı
Sekmenin piksel cinsinden yüksekliği.
-
öne çıkarıldı
boolean
Sekmenin vurgulanıp vurgulanmadığı.
-
id
sayı isteğe bağlı
Sekmenin kimliği. Sekme kimlikleri, tarayıcı oturumunda benzersizdir. Bazı durumlarda (örneğin,
sessions
API'sini kullanarak yabancı sekmeleri sorgularken) sekmeye kimlik atanmamış olabilir. Bu durumda, oturum kimliği bulunabilir. Sekme kimliği, uygulamalar ve devtools pencereleri içinchrome.tabs.TAB_ID_NONE
olarak da ayarlanabilir. -
gizli
boolean
Sekmenin gizli pencerede olup olmadığı.
-
indeks
sayı
Sekmenin kendi penceresindeki sıfır tabanlı dizini.
-
lastAccessed
sayı
Chrome 121 ve sonraki sürümlerDönemden bu yana geçen milisaniye sayısı olarak sekmeye en son erişildiği zaman.
-
mutedInfo
MutedInfo isteğe bağlı
Chrome 46 ve sonraki sürümlerSekmenin sessiz durumu ve son durum değişikliğinin nedeni.
-
openerTabId
number isteğe bağlı
Bu sekmeyi açan sekmenin kimliği (varsa). Bu özellik yalnızca açan sekmesi hâlâ mevcutsa bulunur.
-
pendingUrl
dize isteğe bağlı
Chrome 79 ve sonraki sürümlerSekmenin, kaydetmeden önce gittiği URL. Bu özellik yalnızca uzantının manifest'i
"tabs"
iznini içeriyorsa ve bekleyen bir gezinme varsa mevcuttur. -
sabitlendi
boolean
Sekmenin sabitlenip sabitlenmediğini belirtir.
-
seçildi
boolean
Desteği sonlandırıldıLütfen
tabs.Tab.highlighted
kullanın.Sekmenin seçili olup olmadığı.
-
sessionId
dize isteğe bağlı
sessions
API'den alınan bir sekmeyi benzersiz şekilde tanımlamak için kullanılan oturum kimliği. -
durum
TabStatus isteğe bağlı
Sekmenin yükleme durumu.
-
title
dize isteğe bağlı
Sekmenin başlığı. Bu özellik yalnızca uzantının manifest'inde
"tabs"
izni varsa mevcuttur. -
url
dize isteğe bağlı
Sekmenin ana çerçevesinin kaydedilen son URL'si. Bu özellik yalnızca uzantının manifest dosyasında
"tabs"
izni varsa bulunur ve sekme henüz bağlanmamışsa boş bir dize olabilir. Ayrıca bkz.Tab.pendingUrl
. -
genişlik
number isteğe bağlı
Sekmenin piksel cinsinden genişliği.
-
windowId
sayı
Sekmeyi içeren pencerenin kimliği.
TabStatus
Sekmenin yükleme durumu.
Enum
"unload"
"loading"
"complete"
WindowType
Pencerenin türü.
Enum
"normal"
"popup"
"panel"
"uygulama"
"devtools"
ZoomSettings
Sekmedeki yakınlaştırma değişikliklerinin nasıl ve hangi kapsamda ele alınacağını tanımlar.
Özellikler
-
defaultZoomFactor
number isteğe bağlı
Chrome 43 ve sonraki sürümlertabs.getZoomSettings çağrılarında geçerli sekmenin varsayılan yakınlaştırma düzeyini döndürmek için kullanılır.
-
mod
ZoomSettingsMode isteğe bağlı
Yakınlaştırma değişikliklerinin nasıl ele alınacağını (yani sayfanın gerçek ölçeklendirilmesinden hangi öğenin sorumlu olacağını) tanımlar. Varsayılan olarak
automatic
değerini alır. -
kapsam
ZoomSettingsScope isteğe bağlı
Yakınlaştırma değişikliklerinin sayfanın kaynağında kalıcı olup olmayacağını veya yalnızca bu sekmede geçerli olup olmayacağını tanımlar. Varsayılan olarak
automatic
modundaper-origin
, aksi takdirdeper-tab
değerini alır.
ZoomSettingsMode
Yakınlaştırma değişikliklerinin nasıl işleneceğini (yani, sayfanın gerçek ölçeklendirmesinden hangi varlığın sorumlu olduğunu) tanımlar; varsayılan olarak automatic
değerini alır.
Enum
"automatic"
Yakınlaştırma değişiklikleri, tarayıcı tarafından otomatik olarak işlenir.
"manual"
Yakınlaştırma değişikliklerinin otomatik olarak işlenmesini geçersiz kılar. onZoomChange
etkinliği yine gönderilir ve bu etkinliği dinlemek ve sayfayı manuel olarak ölçeklendirmek uzantının sorumluluğundadır. Bu mod, per-origin
yakınlaştırma özelliğini desteklemediğinden scope
yakınlaştırma ayarını yoksayar ve per-tab
değerini varsayar.
"disabled"
Sekmede tüm yakınlaştırma işlemlerini devre dışı bırakır. Sekme, varsayılan yakınlaştırma düzeyine geri döner ve yapılan tüm yakınlaştırma değişiklikleri yoksayılır.
ZoomSettingsScope
Yakınlaştırma değişikliklerinin sayfanın kaynağında kalıcı olup olmayacağını veya yalnızca bu sekmede geçerli olup olmayacağını tanımlar. Varsayılan olarak automatic
modunda per-origin
, aksi takdirde per-tab
değerini alır.
Enum
"per-origin"
Yakınlaştırma değişiklikleri, yakınlaştırılmış sayfanın kaynağında kalır. Yani, aynı kaynağa yönlendirilen diğer tüm sekmeler de yakınlaştırılır. Ayrıca, per-origin
yakınlaştırma değişiklikleri başlangıç noktasıyla birlikte kaydedilir. Diğer bir deyişle, aynı kaynaktaki diğer sayfalara giderken aynı yakınlaştırma faktörüne göre yakınlaştırma yapılır. per-origin
kapsamı yalnızca automatic
modunda kullanılabilir.
"sekme başına"
Yakınlaştırma değişiklikleri yalnızca bu sekmede geçerli olur ve diğer sekmelerdeki yakınlaştırma değişiklikleri bu sekmenin yakınlaştırma ayarını etkilemez. Ayrıca, per-tab
yakınlaştırma değişiklikleri gezinme sırasında sıfırlanır. Sekmelerde gezinirken sayfalar her zaman per-origin
yakınlaştırma faktörleriyle yüklenir.
Özellikler
MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND
Saniyede captureVisibleTab
için maksimum çağrı sayısı. captureVisibleTab
pahalıdır ve çok sık çağrılmamalıdır.
Değer
2
TAB_ID_NONE
Tarayıcı sekmesinin bulunmadığını gösteren bir kimlik.
Değer
-1
TAB_INDEX_NONE
Bir tab_strip öğesinde sekme dizini bulunmadığını gösteren dizin.
Değer
-1
Yöntemler
captureVisibleTab()
chrome.tabs.captureVisibleTab(
windowId?: number,
options?: ImageDetails,
callback?: function,
)
Belirtilen pencerede etkin olan sekmenin görünür alanını yakalar. Bu yöntemin çağrılabilmesi için uzantının <all_urls> veya activeTab iznine sahip olması gerekir. Bu yöntem, uzantıların normalde erişebildiği sitelere ek olarak chrome:-scheme sayfaları, diğer uzantıların sayfaları ve data: URL'leri gibi normalde kısıtlanmış olan hassas siteleri yakalamasına olanak tanır. Bu hassas siteler yalnızca activeTab izniyle yakalanabilir. Dosya URL'leri yalnızca uzantıya dosya erişimi verilmişse yakalanabilir.
Parametreler
-
windowId
number isteğe bağlı
Hedef pencere. Varsayılan olarak mevcut pencere kullanılır.
-
seçenekler
ImageDetails isteğe bağlı
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(dataUrl: string) => void
-
dataUrl
dize
Yakalanan sekmenin görünür alanının resmini kodlayan bir veri URL'si. Görüntülemek için bir HTML
img
öğesinin "src" özelliğine atanabilir.
-
İadeler
-
Promise<string>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
connect()
chrome.tabs.connect(
tabId: number,
connectInfo?: object,
)
Belirtilen sekmedeki içerik komut dosyalarına bağlanır. runtime.onConnect
etkinliği, geçerli uzantı için belirtilen sekmede çalışan her içerik komut dosyasında tetiklenir. Daha fazla bilgi için Content Script Mesajlaşma başlıklı makaleyi inceleyin.
Parametreler
-
tabId
sayı
-
connectInfo
nesne isteğe bağlı
-
documentId
dize isteğe bağlı
Chrome 106 ve sonraki sürümlerSekmedeki tüm çerçeveler yerine
documentId
ile tanımlanan belirli bir doküman için bir bağlantı noktası açın. -
frameId
sayı isteğe bağlı
Sekmedeki tüm kareler yerine
frameId
ile tanımlanan belirli bir kare için bir bağlantı noktası açın. -
ad
dize isteğe bağlı
Bağlantı etkinliğini dinleyen içerik komut dosyaları için onConnect işlevine iletilir.
-
İadeler
-
Belirtilen sekmede çalışan içerik komut dosyalarıyla iletişim kurmak için kullanılabilecek bağlantı noktası. Sekme kapanırsa veya mevcut değilse bağlantı noktasının
runtime.Port
etkinliği tetiklenir.
create()
chrome.tabs.create(
createProperties: object,
callback?: function,
)
Yeni bir sekme oluşturur.
Parametreler
-
createProperties
nesne
-
etkin
boole isteğe bağlı
Sekmenin pencerede etkin sekme olup olmayacağı. Pencerenin odaklanıp odaklanmadığını etkilemez (
windows.update
bölümüne bakın). Varsayılan olaraktrue
değerini alır. -
indeks
number isteğe bağlı
Sekmenin pencerede alacağı konum. Sağlanan değer, sıfır ile penceredeki sekme sayısı arasına sabitlenir.
-
openerTabId
sayı isteğe bağlı
Bu sekmeyi açan sekmenin kimliği. Belirtilmişse açıcı sekmesi, yeni oluşturulan sekmeyle aynı pencerede olmalıdır.
-
sabitlendi
boole isteğe bağlı
Sekmenin sabitlenip sabitlenmeyeceği. Varsayılan olarak
false
değerine ayarlanır -
seçildi
boole isteğe bağlı
Kullanımdan kaldırıldıLütfen etkin seçeneğini kullanın.
Sekmenin, pencerede seçili sekme olup olmayacağı. Varsayılan olarak
true
değerine ayarlanır -
url
dize isteğe bağlı
Sekmede ilk gidilecek URL. Tam nitelikli URL'ler bir şema (ör. "www.google.com" değil, "http://www.google.com"). Göreli URL'ler, uzantıdaki geçerli sayfaya görelidir. Varsayılan olarak Yeni Sekme sayfası kullanılır.
-
windowId
number isteğe bağlı
Yeni sekmenin oluşturulacağı pencere. Varsayılan olarak mevcut pencere kullanılır.
-
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tab: Tab) => void
-
sekmesinden
Oluşturulan sekme.
-
İadeler
-
Promise<Tab>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
detectLanguage()
chrome.tabs.detectLanguage(
tabId?: number,
callback?: function,
)
Sekmedeki içeriğin birincil dilini algılar.
Parametreler
-
tabId
number isteğe bağlı
Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(language: string) => void
-
language
dize
en
veyafr
gibi bir ISO dil kodu. Bu yöntemin desteklediği dillerin tam listesi için kLanguageInfoTable sayfasına bakın.zh-CN
değerinin döndürüldüğü Basitleştirilmiş Çince hariç ikinci ile dördüncü sütunlar işaretlenir ve NULL olmayan ilk değer döndürülür. Bilinmeyen/tanımlanmamış bir dil içinund
döndürülür.
-
İadeler
-
Promise<string>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
discard()
chrome.tabs.discard(
tabId?: number,
callback?: function,
)
Sekmeyi bellekten siler. Atılan sekmeler sekme şeridinde görünür durumda kalır ve etkinleştirildiğinde yeniden yüklenir.
Parametreler
-
tabId
number isteğe bağlı
Atılacak sekmenin kimliği. Belirtilen sekme, etkin olmadığı veya zaten atılmadığı sürece atılır. Atlanırsa tarayıcı en az önemli sekmeyi atar. Atılabilir sekme yoksa bu işlem başarısız olabilir.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tab?: Tab) => void
-
sekmesinden
Sekme isteğe bağlı
Başarıyla silindiyse silinen sekme; aksi takdirde tanımlanmamıştır.
-
İadeler
-
Promise<Sekme | tanımsız>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
duplicate()
chrome.tabs.duplicate(
tabId: number,
callback?: function,
)
Sekmeyi kopyalar.
Parametreler
-
tabId
sayı
Kopyalanacak sekmenin kimliği.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tab?: Tab) => void
İadeler
-
Promise<Tab | undefined>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
executeScript()
chrome.tabs.executeScript(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Manifest V3'te scripting.executeScript
ile değiştirildi.
JavaScript kodunu sayfaya ekler. Ayrıntılar için içerik komut dosyaları dokümanının programatik ekleme bölümüne bakın.
Parametreler
-
tabId
number isteğe bağlı
Komut dosyasının çalıştırılacağı sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesini ifade eder.
-
ayrıntılar
Çalıştırılacak komut dosyasının ayrıntıları. Kod veya dosya mülkü ayarlanmalıdır ancak her ikisi aynı anda ayarlanamaz.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(result?: any[]) => void
-
sonuç
any[] isteğe bağlı
Her enjekte edilen karede komut dosyasının sonucu.
-
İadeler
-
Promise<any[] | undefined>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
get()
chrome.tabs.get(
tabId: number,
callback?: function,
)
Belirtilen sekmeyle ilgili ayrıntıları alır.
Parametreler
-
tabId
sayı
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tab: Tab) => void
-
sekmesinden
-
İadeler
-
Promise<Sekme>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
getAllInWindow()
chrome.tabs.getAllInWindow(
windowId?: number,
callback?: function,
)
Lütfen tabs.query
{windowId: windowId}
kullanın.
Belirtilen penceredeki tüm sekmelerle ilgili ayrıntıları alır.
Parametreler
-
windowId
number isteğe bağlı
Varsayılan olarak geçerli pencere kullanılır.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tabs: Tab[]) => void
-
sekmeler
Sekme[]
-
İadeler
-
Promise<Tab[]>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
getCurrent()
chrome.tabs.getCurrent(
callback?: function,
)
Bu komut dosyası çağrısının yapıldığı sekmeyi alır. Sekme dışı bir bağlamda (ör. arka plan sayfası veya pop-up görünümü) çağrılırsa undefined
döndürür.
Parametreler
İadeler
-
Promise<Tab | undefined>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
getSelected()
chrome.tabs.getSelected(
windowId?: number,
callback?: function,
)
Lütfen tabs.query
{active: true}
kullanın.
Belirtilen pencerede seçili olan sekmeyi alır.
Parametreler
-
windowId
number isteğe bağlı
Varsayılan olarak mevcut pencere kullanılır.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tab: Tab) => void
-
sekmesinden
-
İadeler
-
Promise<Sekme>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
getZoom()
chrome.tabs.getZoom(
tabId?: number,
callback?: function,
)
Belirtilen sekmenin mevcut yakınlaştırma faktörünü alır.
Parametreler
-
tabId
number isteğe bağlı
Geçerli yakınlaştırma faktörünü alacağınız sekmenin kimliğidir. Varsayılan olarak geçerli pencerenin etkin sekmesidir.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(zoomFactor: number) => void
-
zoomFactor
sayı
Sekmenin mevcut yakınlaştırma faktörü.
-
İadeler
-
Taahhüt<sayı>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
getZoomSettings()
chrome.tabs.getZoomSettings(
tabId?: number,
callback?: function,
)
Belirtilen bir sekmenin mevcut yakınlaştırma ayarlarını alır.
Parametreler
-
tabId
number isteğe bağlı
Geçerli yakınlaştırma ayarlarını alacağınız sekmenin kimliği. Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(zoomSettings: ZoomSettings) => void
-
zoomSettings
Sekmenin mevcut yakınlaştırma ayarları.
-
İadeler
-
Promise<ZoomSettings>.
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
goBack()
chrome.tabs.goBack(
tabId?: number,
callback?: function,
)
Varsa önceki sayfaya geri dönün.
Parametreler
-
tabId
number isteğe bağlı
Geri gidilecek sekmenin kimliğidir. Varsayılan olarak geçerli pencerede seçili sekmedir.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<geçersiz>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
goForward()
chrome.tabs.goForward(
tabId?: number,
callback?: function,
)
Varsa bir sonraki sayfaya gidin.
Parametreler
-
tabId
sayı isteğe bağlı
İleri gidilecek sekmenin kimliğidir. Varsayılan olarak geçerli pencerede seçili sekmedir.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<geçersiz>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
group()
chrome.tabs.group(
options: object,
callback?: function,
)
Belirtilen bir gruba bir veya daha fazla sekme ekler. Grup belirtilmezse belirtilen sekmeler yeni oluşturulan bir gruba eklenir.
Parametreler
-
seçenekler
nesne
-
createProperties
nesne isteğe bağlı
Grup oluşturma yapılandırmaları. groupId zaten belirtilmişse kullanılamaz.
-
windowId
number isteğe bağlı
Yeni grubun penceresi. Varsayılan olarak geçerli pencere kullanılır.
-
-
groupId
number isteğe bağlı
Sekmelerin ekleneceği grubun kimliği. Belirtilmezse yeni bir grup oluşturulur.
-
tabIds
sayı | [sayı, ...sayı[]]
Belirtilen gruba eklenecek sekme kimliği veya sekme kimlikleri listesi.
-
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(groupId: number) => void
-
groupId
sayı
Sekmelerin eklendiği grubun kimliği.
-
İadeler
-
Promise<number>
Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
highlight()
chrome.tabs.highlight(
highlightInfo: object,
callback?: function,
)
Belirtilen sekmeleri vurgular ve grubun ilk sekmesine odaklanır. Belirtilen sekme şu anda etkinse hiçbir şey yapmamış gibi görünür.
Parametreler
-
highlightInfo
nesne
-
sekmeler
sayı | sayı[]
Vurgulanacak bir veya daha fazla sekme dizini.
-
windowId
sayı isteğe bağlı
Sekmeleri içeren pencere.
-
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(window: Window) => void
-
pencere
Sekmeleri vurgulanan pencereyle ilgili ayrıntıları içerir.
-
İadeler
-
Promise<windows.Window>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
insertCSS()
chrome.tabs.insertCSS(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Manifest V3'te scripting.insertCSS
ile değiştirildi.
CSS'yi bir sayfaya ekler. Bu yöntemle eklenen stiller scripting.removeCSS
ile kaldırılabilir. Ayrıntılar için içerik komut dosyaları dokümanının programatik ekleme bölümüne bakın.
Parametreler
-
tabId
sayı isteğe bağlı
CSS'nin ekleneceği sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
-
ayrıntılar
Eklenecek CSS metninin ayrıntıları. Kod veya dosya mülkü ayarlanmalıdır ancak her ikisi aynı anda ayarlanamaz.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<geçersiz>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
move()
chrome.tabs.move(
tabIds: number | number[],
moveProperties: object,
callback?: function,
)
Bir veya daha fazla sekmeyi penceresinde yeni bir konuma ya da yeni bir pencereye taşır. Sekmelerin yalnızca normal (window.type === "normal") pencerelere ve bu pencerelerden taşınabileceğini unutmayın.
Parametreler
-
tabIds
sayı | sayı[]
Taşınacak sekme kimliği veya sekme kimliklerinin listesi.
-
moveProperties
nesne
-
indeks
sayı
Pencerenin taşınacağı konum. Sekmeyi pencerenin sonuna yerleştirmek için
-1
tuşunu kullanın. -
windowId
number isteğe bağlı
Varsayılan olarak sekmenin şu anda bulunduğu pencere kullanılır.
-
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tabs: Tab | Tab[]) => void
İadeler
-
Chrome 88 ve sonraki sürümler
Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
query()
chrome.tabs.query(
queryInfo: object,
callback?: function,
)
Belirtilen özelliklere sahip tüm sekmeleri veya hiçbir özellik belirtilmezse tüm sekmeleri alır.
Parametreler
-
queryInfo
nesne
-
etkin
boole isteğe bağlı
Sekmelerin pencerelerinde etkin olup olmadığı.
-
audible
boole isteğe bağlı
Chrome 45 ve sonraki sürümlerSekmelerin sesli olup olmadığı.
-
autoDiscardable
boole isteğe bağlı
Chrome 54 ve sonraki sürümlerKaynaklar azaldığında sekmelerin tarayıcı tarafından otomatik olarak atlanıp atlanamayacağını belirtir.
-
currentWindow
boole isteğe bağlı
Sekmelerin geçerli pencerede olup olmadığı.
-
silindi
boole isteğe bağlı
Chrome 54 ve sonraki sürümlerSekmelerin atlanıp atlanmayacağı. Silinen sekme, içeriği bellekten kaldırılan ancak sekme şeridinde görünmeye devam eden sekmelerdir. Bu cihaz tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
-
dondurulmuş
boole isteğe bağlı
BeklemedeSekmelerin dondurulup dondurulmadığı. Dondurulmuş bir sekme, etkinlik işleyiciler veya zamanlayıcılar da dahil olmak üzere görevleri yürütemez. Sekme şeridinde görünür ve içeriği belleğe yüklenir. Etkinleştirme sonrasında donduruldu.
-
groupId
sayı isteğe bağlı
Chrome 88 ve sonraki sürümlerSekmelerin bulunduğu grubun kimliği veya gruplandırılmamış sekmeler için
tabGroups.TAB_GROUP_ID_NONE
. -
öne çıkarıldı
boole isteğe bağlı
Sekmelerin vurgulanıp vurgulanmayacağı.
-
indeks
number isteğe bağlı
Sekmelerin pencerelerindeki konumu.
-
lastFocusedWindow
boole isteğe bağlı
Sekmelerin, odaklanan son pencerede olup olmadığı.
-
ses kapatıldı
boole isteğe bağlı
Chrome 45 ve sonraki sürümlerSekmelerin sessiz olup olmadığı.
-
sabitlendi
boole isteğe bağlı
Sekmelerin sabitlenip sabitlenmediği.
-
durum
TabStatus isteğe bağlı
Sekme yükleme durumu.
-
title
dize isteğe bağlı
Sayfa başlıklarını bir kalıpla eşleştirin. Uzantı
"tabs"
iznine sahip değilse bu özellik yoksayılır. -
url
dize | dize[] isteğe bağlı
Sekmeleri bir veya daha fazla URL kalıbıyla eşleştirin. Parça tanımlayıcıları eşleşmiyor. Uzantı
"tabs"
iznine sahip değilse bu özellik yoksayılır. -
windowId
sayı isteğe bağlı
Üst pencerenin kimliği veya mevcut pencere için
windows.WINDOW_ID_CURRENT
. -
windowType
WindowType isteğe bağlı
Sekmelerin bulunduğu pencerenin türü.
-
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(result: Tab[]) => void
-
sonuç
Sekme[]
-
İadeler
-
Promise<Tab[]>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
reload()
chrome.tabs.reload(
tabId?: number,
reloadProperties?: object,
callback?: function,
)
Bir sekmeyi yeniden yükleyin.
Parametreler
-
tabId
number isteğe bağlı
Yeniden yüklenecek sekmenin kimliği; varsayılan olarak geçerli pencerenin seçili sekmesine ayarlanır.
-
reloadProperties
nesne isteğe bağlı
-
bypassCache
boole isteğe bağlı
Yerel önbelleğe almanın atlanıp atlanmayacağı. Varsayılan olarak
false
değerine ayarlanır.
-
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<geçersiz>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
remove()
chrome.tabs.remove(
tabIds: number | number[],
callback?: function,
)
Bir veya daha fazla sekmeyi kapatır.
Parametreler
-
tabIds
sayı | sayı[]
Kapatılacak sekme kimliği veya sekme kimlikleri listesi.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<geçersiz>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
removeCSS()
chrome.tabs.removeCSS(
tabId?: number,
details: DeleteInjectionDetails,
callback?: function,
)
Manifest V3'te scripting.removeCSS
ile değiştirildi.
Daha önce scripting.insertCSS
çağrısıyla yerleştirilen CSS sayfasındaki CSS'den kaldırılır.
Parametreler
-
tabId
sayı isteğe bağlı
CSS'nin kaldırılacağı sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
-
ayrıntılar
Kaldırılacak CSS metninin ayrıntıları. Kod veya dosya mülkü ayarlanmalıdır ancak her ikisi aynı anda ayarlanamaz.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<geçersiz>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
sendMessage()
chrome.tabs.sendMessage(
tabId: number,
message: any,
options?: object,
callback?: function,
)
Belirtilen sekmedeki içerik komut dosyalarına tek bir ileti gönderir. İsteğe bağlı olarak, bir yanıt geri gönderildiğinde geri çağırma yapılır. runtime.onMessage
etkinliği, geçerli uzantı için belirtilen sekmede çalışan her içerik komut dosyasında tetiklenir.
Parametreler
-
tabId
sayı
-
mesaj
herhangi
Gönderilecek mesaj. Bu mesaj, JSON'a dönüştürülebilir bir nesne olmalıdır.
-
seçenekler
nesne isteğe bağlı
-
geri çağırma
işlev isteğe bağlı
Chrome 99 ve sonraki sürümlercallback
parametresi şu şekilde görünür:(response: any) => void
-
gönderin
herhangi
Mesajın işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken hata oluşursa geri çağırma işlevi bağımsız değişken olmadan çağrılır ve
runtime.lastError
hata mesajına ayarlanır.
-
İadeler
-
Promise<any>
Chrome 99 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
sendRequest()
chrome.tabs.sendRequest(
tabId: number,
request: any,
callback?: function,
)
Lütfen runtime.sendMessage
kullanın.
Belirtilen sekmedeki içerik komut dosyalarına tek bir istek gönderir. İsteğe bağlı olarak, bir yanıt geri gönderildiğinde geri çağırma işlevi de kullanılır. extension.onRequest
etkinliği, geçerli uzantı için belirtilen sekmede çalışan her içerik komut dosyasında tetiklenir.
Parametreler
-
tabId
sayı
-
istek
herhangi
-
geri çağırma
işlev isteğe bağlı
Chrome 99 ve sonraki sürümlercallback
parametresi şu şekilde görünür:(response: any) => void
-
gönderin
herhangi
İsteğin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken hata oluşursa geri çağırma işlevi bağımsız değişken olmadan çağrılır ve
runtime.lastError
hata mesajına ayarlanır.
-
İadeler
-
Promise<any>
Chrome 99 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
setZoom()
chrome.tabs.setZoom(
tabId?: number,
zoomFactor: number,
callback?: function,
)
Belirli bir sekmeyi yakınlaştırır.
Parametreler
-
tabId
number isteğe bağlı
Yakınlaştırmak için kullanılacak sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesini ifade eder.
-
zoomFactor
sayı
Yeni yakınlaştırma faktörü.
0
değeri, sekmeyi mevcut varsayılan yakınlaştırma faktörüne ayarlar.0
'ten büyük değerler, sekme için bir yakınlaştırma faktörü (varsayılan olmayan) belirtir. -
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<geçersiz>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
setZoomSettings()
chrome.tabs.setZoomSettings(
tabId?: number,
zoomSettings: ZoomSettings,
callback?: function,
)
Belirtilen bir sekme için yakınlaştırma ayarlarını belirler. Bu ayarlar, yakınlaştırma değişikliklerinin nasıl ele alınacağını tanımlar. Bu ayarlar, sekmede gezindiğinizde varsayılan ayarlara sıfırlanır.
Parametreler
-
tabId
number isteğe bağlı
Yakınlaştırma ayarlarını değiştirecek sekmenin kimliğidir. Varsayılan olarak geçerli pencerenin etkin sekmesidir.
-
zoomSettings
Yakınlaştırma değişikliklerinin nasıl ve hangi kapsamda işleneceğini tanımlar.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<geçersiz>
Chrome 88 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
ungroup()
chrome.tabs.ungroup(
tabIds: number | [number, ...number[]],
callback?: function,
)
Bir veya daha fazla sekmeyi ilgili gruplarından kaldırır. Boş kalan gruplar silinir.
Parametreler
-
tabIds
sayı | [sayı, ...sayı[]]
İlgili gruplarından kaldırılacak sekme kimliği veya sekme kimlikleri listesi.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Promise<void>
Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
update()
chrome.tabs.update(
tabId?: number,
updateProperties: object,
callback?: function,
)
Sekmenin özelliklerini değiştirir. updateProperties
içinde belirtilmeyen özellikler değiştirilmez.
Parametreler
-
tabId
number isteğe bağlı
Varsayılan olarak geçerli penceredeki seçili sekmedir.
-
updateProperties
nesne
-
etkin
boole isteğe bağlı
Sekmenin etkin olup olmayacağı. Pencerenin odaklanıp odaklanmadığını etkilemez (
windows.update
bölümüne bakın). -
autoDiscardable
boole isteğe bağlı
Chrome 54 ve sonraki sürümlerKaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak silinip silinmeyeceği.
-
öne çıkarıldı
boole isteğe bağlı
Sekmeyi mevcut seçime ekler veya mevcut seçimden kaldırır.
-
ses kapatıldı
boole isteğe bağlı
Chrome 45 ve sonraki sürümlerSekmenin sesinin kapatılıp kapatılmayacağı.
-
openerTabId
sayı isteğe bağlı
Bu sekmeyi açan sekmenin kimliği. Belirtilmişse açıcı sekme, bu sekmeyle aynı pencerede olmalıdır.
-
sabitlendi
boole isteğe bağlı
Sekmenin sabitlenip sabitlenmeyeceği.
-
seçildi
boole isteğe bağlı
Kullanımdan kaldırıldıLütfen vurgulananlar özelliğini kullanın.
Sekmenin seçilip seçilmeyeceği.
-
url
dize isteğe bağlı
Sekmenin gidileceği URL. JavaScript URL'leri desteklenmez. Bunun yerine
scripting.executeScript
kullanın.
-
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tab?: Tab) => void
İadeler
-
Promise<Tab | undefined>
Chrome 88 ve sonraki sürümlerSözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.
Etkinlikler
onActivated
chrome.tabs.onActivated.addListener(
callback: function,
)
Bir penceredeki etkin sekme değiştiğinde tetiklenir. Sekme URL'sinin bu etkinlik tetiklendiği sırada ayarlanmamış olabileceğini unutmayın, ancak bir URL ayarlandığında bildirim almak için onUpdated etkinliklerini dinleyebilirsiniz.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(activeInfo: object) => void
-
activeInfo
nesne
-
tabId
sayı
Etkin hale gelen sekmenin kimliği.
-
windowId
sayı
Etkin sekmenin içinde değiştiği pencerenin kimliği.
-
-
onActiveChanged
chrome.tabs.onActiveChanged.addListener(
callback: function,
)
Lütfen tabs.onActivated
kullanın.
Bir pencerede seçili sekme değiştiğinde tetiklenir. Bu etkinlik tetiklendiğinde sekmenin URL'sinin ayarlanmamış olabileceğini unutmayın. Ancak bir URL ayarlandığında bildirim almak için tabs.onUpdated
etkinliklerini dinleyebilirsiniz.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(tabId: number, selectInfo: object) => void
-
tabId
sayı
-
selectInfo
nesne
-
windowId
sayı
Seçili sekmenin içinde yer aldığı pencerenin kimliği.
-
-
onAttached
chrome.tabs.onAttached.addListener(
callback: function,
)
Bir sekme pencereye eklendiğinde (ör. pencereler arasında taşındığı için) tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(tabId: number, attachInfo: object) => void
-
tabId
sayı
-
attachInfo
nesne
-
newPosition
sayı
-
newWindowId
sayı
-
-
onCreated
chrome.tabs.onCreated.addListener(
callback: function,
)
Bir sekme oluşturulduğunda tetiklenir. Sekmenin URL'si ve sekme grubu üyeliği, bu etkinlik tetiklendiğinde ayarlanmayabilir. Ancak URL ayarlandığında veya sekme bir sekme grubuna eklendiğinde bildirim almak için onUpdated etkinliklerini dinleyebilirsiniz.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(tab: Tab) => void
-
sekmesinden
-
onDetached
chrome.tabs.onDetached.addListener(
callback: function,
)
Bir sekme pencereden ayrıldığında (ör. pencereler arasında taşındığında) tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(tabId: number, detachInfo: object) => void
-
tabId
sayı
-
detachInfo
nesne
-
oldPosition
sayı
-
oldWindowId
sayı
-
-
onHighlightChanged
chrome.tabs.onHighlightChanged.addListener(
callback: function,
)
Lütfen tabs.onHighlighted
kullanın.
Bir pencerede vurgulanan veya seçilen sekmeler değiştiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(selectInfo: object) => void
-
selectInfo
nesne
-
tabIds
numara[]
Pencerede vurgulanan tüm sekmeler.
-
windowId
sayı
Sekmelerinin değiştirildiği pencere.
-
-
onHighlighted
chrome.tabs.onHighlighted.addListener(
callback: function,
)
Bir pencerede vurgulanan veya seçilen sekmeler değiştiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(highlightInfo: object) => void
-
highlightInfo
nesne
-
tabIds
numara[]
Pencerede vurgulanan tüm sekmeler.
-
windowId
sayı
Sekmelerinin değiştirildiği pencere.
-
-
onMoved
chrome.tabs.onMoved.addListener(
callback: function,
)
Bir sekme pencere içinde taşındığında tetiklenir. Yalnızca bir taşıma etkinliği tetiklenir. Bu etkinlik, kullanıcının doğrudan taşıdığı sekmeyi temsil eder. Manuel olarak taşınan sekmeye göre hareket etmesi gereken diğer sekmeler için taşıma etkinlikleri tetiklenmez. Bu etkinlik, bir sekme pencereler arasında taşındığında tetiklenmez. Ayrıntılar için tabs.onDetached
bölümüne bakın.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(tabId: number, moveInfo: object) => void
-
tabId
sayı
-
moveInfo
nesne
-
fromIndex
sayı
-
toIndex
sayı
-
windowId
sayı
-
-
onRemoved
chrome.tabs.onRemoved.addListener(
callback: function,
)
Bir sekme kapatıldığında tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(tabId: number, removeInfo: object) => void
-
tabId
sayı
-
removeInfo
nesne
-
isWindowClosing
boolean
Üst penceresi kapalı olduğu için sekme kapatıldığında doğru değerini döndürür.
-
windowId
sayı
Sekmesi kapalı olan pencere.
-
-
onReplaced
chrome.tabs.onReplaced.addListener(
callback: function,
)
Bir sekme, ön oluşturma veya anında oluşturma nedeniyle başka bir sekmeyle değiştirildiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(addedTabId: number, removedTabId: number) => void
-
addedTabId
sayı
-
removedTabId
sayı
-
onSelectionChanged
chrome.tabs.onSelectionChanged.addListener(
callback: function,
)
Lütfen tabs.onActivated
kullanın.
Bir pencerede seçili sekme değiştiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(tabId: number, selectInfo: object) => void
-
tabId
sayı
-
selectInfo
nesne
-
windowId
sayı
Seçili sekmenin içinde yer aldığı pencerenin kimliği.
-
-
onUpdated
chrome.tabs.onUpdated.addListener(
callback: function,
)
Bir sekme güncellendiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(tabId: number, changeInfo: object, tab: Tab) => void
-
tabId
sayı
-
changeInfo
nesne
-
audible
boole isteğe bağlı
Chrome 45 ve sonraki sürümlerSekmenin yeni sesli durumu.
-
autoDiscardable
boole isteğe bağlı
Chrome 54 ve sonraki sürümlerSekmenin yeni otomatik olarak atılabilir durumu.
-
silindi
boole isteğe bağlı
Chrome 54 ve sonraki sürümlerSekmenin yeni "Silindi" durumu.
-
favIconUrl
dize isteğe bağlı
Sekmenin yeni simge URL'si.
-
dondurulmuş
boole isteğe bağlı
BeklemedeSekmenin yeni donma durumu.
-
groupId
sayı isteğe bağlı
Chrome 88 ve sonraki sürümlerSekmenin yeni grubu.
-
mutedInfo
MutedInfo isteğe bağlı
Chrome 46 ve sonraki sürümlerSekmenin yeni sessiz durumu ve değişikliğin nedeni.
-
sabitlendi
boole isteğe bağlı
Sekmenin yeni sabitlenmiş durumu.
-
durum
TabStatus isteğe bağlı
Sekmenin yükleme durumu.
-
title
dize isteğe bağlı
Chrome 48 ve sonraki sürümlerSekmenin yeni başlığı.
-
url
dize isteğe bağlı
Değiştiyse sekmenin URL'si.
-
-
sekmesinden
-
onZoomChange
chrome.tabs.onZoomChange.addListener(
callback: function,
)
Bir sekme yakınlaştırıldığında tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(ZoomChangeInfo: object) => void
-
ZoomChangeInfo
nesne
-
newZoomFactor
sayı
-
oldZoomFactor
sayı
-
tabId
sayı
-
zoomSettings
-
-