Açıklama
Tarayıcının sekme sistemiyle etkileşim kurmak için chrome.tabs
API'yi kullanın. Bu API'yı tarayıcıda sekmeler oluşturmak, değiştirmek ve yeniden düzenlemek için kullanabilirsiniz.
Tabs API yalnızca sekmeleri değiştirme ve yönetme özellikleri sunmakla kalmaz, aynı zamanda sekmenin dilini algılayabilir, ekran görüntüsü alabilir ve sekmenin içerik komut dosyalarıyla iletişim kurabilir.
İzinler
Çoğu özellik için herhangi bir izin gerekmez. Örneğin: Yeni sekme oluşturma, bir sekmeyi yeniden yükleme, başka bir URL'ye gezinme 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, bir uzantınıntabs.Tab
örneklerindeki şu dört hassas özelliğe karşıtabs.query()
öğesini çağırmasını sağlar:url
,pendingUrl
,title
vefavIconUrl
.{ "name": "My extension", ... "permissions": [ "tabs" ], ... }
- Ana makine izinleri
Ana makine izinleri, bir uzantının eşleşen sekmenin dört hassas
tabs.Tab
özelliğini okumasına ve sorgulamasına olanak tanır. Ayrıcatabs.captureVisibleTab()
,tabs.executeScript()
,tabs.insertCSS()
vetabs.removeCSS()
gibi yöntemler kullanarak eşleşen sekmelerle doğrudan etkileşime geçebilirler.{ "name": "My extension", ... "host_permissions": [ "http://*/*", "https://*/*" ], ... }
- "activeTab" izni
activeTab
, kullanıcı çağrısına yanıt olarak geçerli sekme için bir uzantıya geçici ana makine izni verir. Ana makine izinlerinden farklı olarakactiveTab
, herhangi bir uyarıyı tetiklemez.{ "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 sekmede açma
Uzantılar için yaygın olarak kullanılan 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 örnekte, bir uzantının hizmet çalışanının etkin sekmeyi o anda odaklanılan pencereden (veya hiç Chrome penceresi odaklanılmamışsa en son odaklanılan pencereden) nasıl alabileceği gösterilmektedir. Bu, genellikle kullanıcının geçerli 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, uzantının belirli bir sekme için sessize alma durumunu nasıl açıp kapatabileceğ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şı
Bu örnekte, sürükleme devam ederken veya devam ederken bir sekmenin nasıl taşınacağı gösterilmektedir. Bu örnekte chrome.tabs.move
kullanılmakla birlikte, bir sürükleme devam ederken sekmeleri değiştiren diğer çağrılar için aynı bekleme düzenini 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 bir mesaj iletin
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
Diğer Tabs API uzantıları demoları için aşağıdakilerden herhangi birini inceleyin:
Türler
MutedInfo
Sekmenin sessize alınmış durumu ve son durum değişikliğinin nedeni.
Özellikler
-
extensionId
string isteğe bağlı
Sessize alınma durumunu değiştiren uzantının kimliği. Sessize alma durumunun son değiştirilme nedeni uzantı değilse ayarlanmaz.
-
ses kapatıldı
boolean
Sekmenin sesinin kapatılıp kapatılmadığı (ses çalmasının engellenip engellenmediği). Sekmenin sesi çalınmasa veya şu anda ses çalmıyor olsa bile kapatılabilir. "Sesi kapalı" ses göstergesinin gösterilip gösterilmediğini belirten eşdeğerdir.
-
neden
MutedInfoReason isteğe bağlı
Sekmenin sesinin kapatılma veya açılma nedeni. Sekmenin sessize alma durumu hiç değiştirilmemişse ayarlanmaz.
MutedInfoReason
Sesi kapatılmış durum değişikliğine neden olan bir etkinlik.
Enum
"user"
Bir kullanıcı girişi işlemi, sesi kapalı durumunu ayarladı.
"capture"
Sekme yakalama işlemi başlatıldı ve sessize alınmış durum değişikliği zorunlu kılındı.
"extension"
ExtensionId alanıyla tanımlanan bir uzantı, sesi kapalı durumunu ayarlar.
Tab
Özellikler
-
etkin
boolean
Sekmenin penceresinde etkin olup olmadığı. Pencerenin odaklandığı anlamına gelmez.
-
audible
boole isteğe bağlı
Chrome 45 ve sonraki sürümlerSekmenin son birkaç saniye içinde ses üretip üretmediği (ancak sessize alınmışsa duyulmayabilir). "Hoparlör sesi" göstergesinin gösterilip gösterilmediğiyle aynı etkiye sahiptir.
-
autoDiscardable
boolean
Chrome 54 ve sonraki sürümlerKaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak silinip silinemeyeceği.
-
silindi
boolean
Chrome 54 ve sonraki sürümlerSekmenin silinip silinmediği. Silinen sekme, içeriği bellekten kaldırılan, ancak sekme şeridinde görünmeye devam eden bir sekmedir. Tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
-
favIconUrl
string isteğe bağlı
Sekmenin favori simgesinin URL'si. Bu özellik yalnızca uzantının manifesti
"tabs"
iznini içeriyorsa kullanılabilir. Sekme yükleniyorsa boş bir dize de olabilir. -
groupId
sayı
Chrome 88 ve sonraki sürümlerSekmenin ait olduğu grubun kimliği.
-
yükseklik
numara isteğe bağlı
Sekmenin piksel cinsinden yüksekliği.
-
öne çıkarıldı
boolean
Sekmenin vurgulu olup olmadığı.
-
id
numara isteğe bağlı
Sekmenin kimliği. Sekme kimlikleri, tarayıcı oturumunda benzersizdir. Bazı durumlarda bir sekmeye kimlik atanmayabilir. Örneğin,
sessions
API'sini kullanarak yabancı sekmeleri sorgularken bir oturum kimliği mevcut olabilir. Sekme kimliği, uygulamalar ve geliştirme araçları pencereleri için dechrome.tabs.TAB_ID_NONE
olarak ayarlanabilir. -
gizli
boolean
Sekmenin gizli pencerede olup olmadığı.
-
indeks
sayı
Sekmenin penceresi içindeki sıfır tabanlı dizini.
-
lastAccessed
numara isteğe bağlı
Chrome 121 ve sonraki sürümlerDönemden beri geçen milisaniye sayısı olarak, sekmeye en son ne zaman erişildiği.
-
mutedInfo
MutedInfo isteğe bağlı
Chrome 46 ve sonraki sürümlerSekmenin sessize alınmış durumu ve son durum değişikliğinin nedeni.
-
openerTabId
numara isteğe bağlı
Varsa, bu sekmeyi açan sekmenin kimliği. Bu özellik yalnızca açılış sekmesi hâlâ mevcutsa mevcuttur.
-
pendingUrl
string isteğe bağlı
Chrome 79 ve sonraki sürümlerSekmenin taahhüt edilmeden önce gittiği URL. Bu özellik yalnızca uzantının manifest dosyası
"tabs"
iznini içeriyorsa ve bekleyen bir gezinme işlemi varsa kullanılabilir. -
sabitlendi
boolean
Sekmenin sabitlenip sabitlenmediği.
-
seçildi
boolean
Kullanımdan kaldırıldıLütfen
tabs.Tab.highlighted
hesabını kullanın.Sekmenin seçili olup olmadığı.
-
sessionId
string isteğe bağlı
sessions
API'den alınan bir sekmeyi benzersiz şekilde tanımlamak için kullanılan oturum kimliği. -
status
TabStatus isteğe bağlı
Sekmenin yükleme durumu.
-
title
string isteğe bağlı
Sekmenin başlığı. Bu özellik yalnızca uzantının manifesti
"tabs"
iznini içeriyorsa kullanılabilir. -
url
string isteğe bağlı
Sekmenin ana çerçevesinin son kaydedilen URL'si. Bu özellik yalnızca uzantının manifesti,
"tabs"
iznini içeriyorsa mevcuttur ve sekme henüz taahhütte bulunmadıysa boş bir dize olabilir. Ayrıca bkz.Tab.pendingUrl
. -
genişlik
numara isteğe bağlı
Sekmenin piksel cinsinden genişliği.
-
windowId
sayı
Sekmeyi içeren pencerenin kimliği.
TabStatus
Sekmenin yükleme durumu.
Enum
"complete"
WindowType
Pencerenin türü.
Enum
"normal"
"popup"
"panel":
"devtools"
ZoomSettings
Bir sekmedeki yakınlaştırma değişikliklerinin nasıl ve hangi kapsamda işleneceğini tanımlar.
Özellikler
-
defaultZoomFactor
numara isteğe bağlı
Chrome 43 ve sonraki sürümlertab.getZoomSettings için yapılan çağrılarda geçerli sekme için varsayılan yakınlaştırma düzeyini döndürmek üzere kullanılır.
-
mod
ZoomSettingsMode isteğe bağlı
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. -
kapsam
ZoomSettingsScope isteğe bağlı
Yakınlaştırma değişikliklerinin sayfanın kaynağı için mi geçerli olacağını yoksa yalnızca bu sekmede mi geçerli olacağını tanımlar;
automatic
modundayken varsayılan olarakper-origin
, aksi haldeper-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
"auto"
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 dağıtılmaya devam eder ve bu etkinliği dinlemek ve sayfayı manuel olarak ölçeklendirmek uzantının sorumluluğundadır. Bu mod, per-origin
yakınlaştırmasını desteklemediğinden scope
yakınlaştırma ayarını yok sayar ve per-tab
olduğunu varsayar.
"disabled"
Sekmedeki tüm yakınlaştırmayı devre dışı bırakır. Sekme, varsayılan yakınlaştırma düzeyine döner ve denenen tüm yakınlaştırma değişiklikleri yok sayılır.
ZoomSettingsScope
Yakınlaştırma değişikliklerinin sayfanın kaynağı için mi geçerli olacağını yoksa yalnızca bu sekmede mi geçerli olacağını tanımlar; automatic
modundayken varsayılan olarak per-origin
, aksi halde per-tab
değerini alır.
Enum
"kaynak başına"
Yakınlaştırma değişiklikleri, yakınlaştırılan sayfanın kaynağında da kalır. Yani aynı kaynağa giden diğer tüm sekmeler de yakınlaştırılır. Ayrıca, per-origin
yakınlaştırma değişikliği kaynak ile birlikte kaydedilir, yani aynı kaynaktaki diğer sayfalara gidildiğinde tümü aynı yakınlaştırma faktörüne göre yakınlaştırı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 etkili olur ve diğer sekmelerdeki yakınlaştırma değişiklikleri bu sekmenin yakınlaştırmasını etkilemez. Ayrıca, per-tab
yakınlaştırma değişiklikleri gezinme sırasında sıfırlanır; bir sekmede gezinirken sayfalar her zaman per-origin
yakınlaştırma faktörleriyle yüklenir.
Özellikler
MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND
captureVisibleTab
işlevinin saniyede maksimum çağrılma sayısı. captureVisibleTab
pahalı olduğundan çok sık aranmamalıdır.
Değer
2
TAB_ID_NONE
Tarayıcı sekmesi olmadığını temsil eden bir kimlik.
Değer
-1
TAB_INDEX_NONE
Bir tab_strip içinde sekme dizininin olmadığını temsil eden bir 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öntemi çağırmak 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, uzantıların başka bir şekilde kısıtlanmış olan hassas siteleri yakalamalarına olanak tanır. Örneğin, chrome:-şema sayfaları, diğer uzantıların sayfaları ve "URL'ler" verileri. Bu hassas siteler yalnızca ActiveTab izniyle yakalanabilir. Dosya URL'leri, yalnızca uzantıya dosya erişim izni verilmişse yakalanabilir.
Parametreler
-
windowId
numara isteğe bağlı
Hedef pencere. Varsayılan olarak geçerli pencere kullanılır.
-
seçenekler
ImageDetails isteğe bağlı
-
geri çağırma
Functions (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 görüntüsünü kodlayan bir veri URL'si. Görüntülenmek üzere bir HTML
img
öğesinin "src" özelliğine atanabilir.
-
İlerlemeler
-
Söz<dize>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
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 bir içerik komut dosyasında tetiklenir. Daha fazla ayrıntı için Content Komut Dosyası Mesajlaşması bölümüne bakın.
Parametreler
-
tabId
sayı
-
connectInfo
isteğe bağlı
-
documentId
string isteğe bağlı
Chrome 106 ve sonraki sürümlerSekmedeki tüm çerçeveler yerine
documentId
tarafından tanımlanan belirli bir dokümana bağlantı noktası açın. -
frameId
numara isteğe bağlı
Sekmedeki tüm kareler yerine
frameId
tarafından tanımlanan belirli bir çerçeveye bağlantı noktası açın. -
ad
string isteğe bağlı
Bağlantı etkinliğini dinleyen içerik komut dosyaları için onConnect'e iletilir.
-
İlerlemeler
-
Belirtilen sekmede çalışan içerik komut dosyalarıyla iletişim kurmak için kullanılabilecek bir 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 sekme oluşturur.
Parametreler
-
createProperties
nesne
-
etkin
boole isteğe bağlı
Sekmenin pencerede etkin sekme olup olmayacağı. Pencerenin odaklanıp odaklanmamasını etkilemez (bkz.
windows.update
). Varsayılan olaraktrue
değerine ayarlanır. -
indeks
numara isteğe bağlı
Sekmenin pencerede bulunması gereken konum. Sağlanan değer, sıfır ile penceredeki sekme sayısı arasına sabitlenir.
-
openerTabId
numara isteğe bağlı
Bu sekmeyi açan sekmenin kimliği. Belirtilirse, açıcı sekmesi, yeni oluşturulan sekmeyle aynı pencerede olmalıdır.
-
sabitlendi
boole isteğe bağlı
Sekmenin sabitlenip sabitlenmeyeceğini belirler. Varsayılan olarak
false
değerine ayarlanır -
seçildi
boole isteğe bağlı
Kullanımdan kaldırıldıLütfen etkin ayarını kullanın.
Sekmenin pencerede seçili sekme olup olmayacağı. Varsayılan olarak
true
değerine ayarlanır -
url
string isteğe bağlı
Sekmenin başlangıçta gidilecek URL'si. Tam nitelikli URL'ler bir şema (ör. 'www.google.com' değil, 'http://www.google.com'). Göreli URL'ler, uzantı içindeki geçerli sayfaya göre değişir. Varsayılan olarak Yeni Sekme Sayfası kullanılır.
-
windowId
numara isteğe bağlı
Yeni sekmenin oluşturulacağı pencere. Varsayılan olarak geçerli pencere kullanılır.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(tab: Tab) => void
-
sekmesinden
Oluşturulan sekme.
-
İlerlemeler
-
Promise<Tab>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
detectLanguage()
chrome.tabs.detectLanguage(
tabId?: number,
callback?: function,
)
Bir sekmedeki içeriğin birincil dilini algılar.
Parametreler
-
tabId
numara isteğe bağlı
Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(language: string) => void
-
dil
dize
en
veyafr
gibi bir ISO dil kodu. Bu yöntemin desteklediği dillerin tam listesi için kLanguageInfoTable adresine bakın. İkinci ile dördüncü sütun arasındaki sütunlar kontrol edilir vezh-CN
değerinin döndürüldüğü Basitleştirilmiş Çince hariç olmak üzere NULL olmayan ilk değer döndürülür. Bilinmeyen/tanımlanmamış bir dil içinund
döndürülür.
-
İlerlemeler
-
Söz<dize>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
discard()
chrome.tabs.discard(
tabId?: number,
callback?: function,
)
Bir sekmeyi bellekten siler. Silinen sekmeler, sekme şeridinde görünmeye devam eder ve etkinleştirildiklerinde yeniden yüklenir.
Parametreler
-
tabId
numara isteğe bağlı
Silinecek sekmenin kimliği. Belirtilirse sekme etkin değilse veya silinmiş değilse silinir. Atlanırsa, tarayıcı en önemsiz sekmeyi siler. Silinebilir sekme yoksa bu işlem başarısız olabilir.
-
geri çağırma
Functions (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.
-
İlerlemeler
-
Promise<Tab | undefined>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
duplicate()
chrome.tabs.duplicate(
tabId: number,
callback?: function,
)
Bir sekmenin kopyasını oluşturur.
Parametreler
-
tabId
sayı
Kopyalanacak sekmenin kimliği.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(tab?: Tab) => void
İlerlemeler
-
Promise<Tab | undefined>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
executeScript()
chrome.tabs.executeScript(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Manifest V3'te scripting.executeScript
ile değiştirilmiştir.
Bir sayfaya JavaScript kodu ekler. Ayrıntılar için içerik komut dosyaları dokümanının programatik yerleştirme bölümüne bakın.
Parametreler
-
tabId
numara isteğe bağlı
Komut dosyasının çalıştırılacağı sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
-
ayrıntılar
Çalıştırılacak komut dosyasının ayrıntıları. Kod veya dosya özelliği ayarlanmalıdır, ancak her ikisi de aynı anda ayarlanamaz.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result?: any[]) => void
-
sonuç
any[] isteğe bağlı
Eklenen her çerçevedeki komut dosyasının sonucu.
-
İlerlemeler
-
Vaat<herhangi biri[] | tanımsız>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
get()
chrome.tabs.get(
tabId: number,
callback?: function,
)
Belirtilen sekmeyle ilgili ayrıntıları getirir.
Parametreler
-
tabId
sayı
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(tab: Tab) => void
-
sekmesinden
-
İlerlemeler
-
Promise<Tab>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
getAllInWindow()
chrome.tabs.getAllInWindow(
windowId?: number,
callback?: function,
)
Lütfen şunu kullanın: tabs.query
{windowId: windowId}
.
Belirtilen penceredeki tüm sekmelerle ilgili ayrıntıları alır.
Parametreler
-
windowId
numara isteğe bağlı
Varsayılan olarak geçerli pencere kullanılır.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(tabs: Tab[]) => void
-
sekmeler
Sekme[]
-
İlerlemeler
-
Promise<Tab[]>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
getCurrent()
chrome.tabs.getCurrent(
callback?: function,
)
Bu komut dosyası çağrısının yapıldığı sekmeyi alır. Sekme dışındaki bir bağlamdan (örneğin, bir arka plan sayfası veya pop-up görünüm) çağrılırsa undefined
değerini döndürür.
Parametreler
İlerlemeler
-
Promise<Tab | undefined>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
getSelected()
chrome.tabs.getSelected(
windowId?: number,
callback?: function,
)
Lütfen şunu kullanın: tabs.query
{active: true}
.
Belirtilen pencerede seçilen sekmeyi getirir.
Parametreler
-
windowId
numara isteğe bağlı
Varsayılan olarak geçerli pencere kullanılır.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(tab: Tab) => void
-
sekmesinden
-
İlerlemeler
-
Promise<Tab>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
getZoom()
chrome.tabs.getZoom(
tabId?: number,
callback?: function,
)
Belirtilen bir sekmenin geçerli yakınlaştırma faktörünü alır.
Parametreler
-
tabId
numara isteğe bağlı
Geçerli yakınlaştırma faktörünün alınacağı sekme kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(zoomFactor: number) => void
-
zoomFactor
sayı
Sekmenin geçerli yakınlaştırma faktörü.
-
İlerlemeler
-
Vaat<sayı>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
getZoomSettings()
chrome.tabs.getZoomSettings(
tabId?: number,
callback?: function,
)
Belirtilen bir sekmenin geçerli yakınlaştırma ayarlarını alır.
Parametreler
-
tabId
numara isteğe bağlı
Geçerli yakınlaştırma ayarlarının alınacağı sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(zoomSettings: ZoomSettings) => void
-
zoomSettings
Sekmenin geçerli yakınlaştırma ayarları.
-
İlerlemeler
-
Promise<ZoomSettings>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
goBack()
chrome.tabs.goBack(
tabId?: number,
callback?: function,
)
Varsa önceki sayfaya geri gitme.
Parametreler
-
tabId
numara isteğe bağlı
Geri gidilecek sekmenin kimliği; varsayılan olarak geçerli pencerenin seçili sekmesidir.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
goForward()
chrome.tabs.goForward(
tabId?: number,
callback?: function,
)
Varsa sonraki sayfaya gidin.
Parametreler
-
tabId
numara isteğe bağlı
İleri gidilecek sekmenin kimliği; varsayılan olarak geçerli pencerenin seçili sekmesidir.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
group()
chrome.tabs.group(
options: object,
callback?: function,
)
Belirtilen gruba bir veya daha fazla sekme ekler ya da herhangi bir grup belirtilmezse belirtilen sekmeleri yeni oluşturulan bir gruba ekler.
Parametreler
-
seçenekler
nesne
-
createProperties
isteğe bağlı
Grup oluşturmayla ilgili yapılandırmalar. groupId zaten belirtilmişse kullanılamaz.
-
windowId
numara isteğe bağlı
Yeni grubun penceresi. Varsayılan olarak geçerli pencere kullanılır.
-
-
groupId
numara isteğe bağlı
Sekmelerin ekleneceği grubun kimliği. Belirtilmezse yeni bir grup oluşturulur.
-
tabIds
numara | [sayı, ...sayı[]]
Belirtilen gruba eklenecek sekme kimliği veya sekme kimliklerinin listesi.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(groupId: number) => void
-
groupId
sayı
Sekmelerin eklendiği grubun kimliği.
-
İlerlemeler
-
Vaat<sayı>
Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
highlight()
chrome.tabs.highlight(
highlightInfo: object,
callback?: function,
)
Belirtilen sekmeleri vurgular ve ilk gruba odaklanır. Belirtilen sekme şu anda etkinse hiçbir şey yapmıyor gibi görünecek.
Parametreler
-
highlightInfo
nesne
-
sekmeler
numara | sayı[]
Vurgulanacak bir veya daha fazla sekme dizini.
-
windowId
numara isteğe bağlı
Sekmeleri içeren pencere.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(window: Window) => void
-
pencere
Sekmeleri vurgulanmış pencereyle ilgili ayrıntıları içerir.
-
İlerlemeler
-
Söz<windows.Window>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
insertCSS()
chrome.tabs.insertCSS(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Manifest V3'te scripting.insertCSS
ile değiştirilmiştir.
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 yerleştirme bölümüne bakın.
Parametreler
-
tabId
numara 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 özelliği ayarlanmalıdır, ancak her ikisi de aynı anda ayarlanamaz.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
move()
chrome.tabs.move(
tabIds: number | number[],
moveProperties: object,
callback?: function,
)
Bir veya daha fazla sekmeyi penceresi içinde 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
numara | 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
öğesini kullanın. -
windowId
numara isteğe bağlı
Varsayılan olarak sekmenin bulunduğu pencere kullanılır.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(tabs: Tab | Tab[]) => void
İlerlemeler
-
Chrome 88 ve sonraki sürümler
Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
query()
chrome.tabs.query(
queryInfo: object,
callback?: function,
)
Belirtilen özelliklere sahip tüm sekmeleri veya herhangi bir özellik belirtilmediyse 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 silinip silinemeyeceği.
-
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 silinip silinmeyeceği. Silinen sekme, içeriği bellekten kaldırılan, ancak sekme şeridinde görünmeye devam eden bir sekmedir. Tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
-
groupId
numara isteğe bağlı
Chrome 88 ve sonraki sürümlerSekmelerin bulunduğu grubun kimliği veya gruplanmamış sekmeler için
tabGroups.TAB_GROUP_ID_NONE
. -
öne çıkarıldı
boole isteğe bağlı
Sekmelerin vurgulu olup olmadığı.
-
indeks
numara isteğe bağlı
Sekmelerin pencereleri içindeki konumu.
-
lastFocusedWindow
boole isteğe bağlı
Sekmelerin son odaklanılan pencerede olup olmadığı.
-
ses kapatıldı
boole isteğe bağlı
Chrome 45 ve sonraki sürümlerSekmelerin sesinin kapatılıp kapatılmadığı.
-
sabitlendi
boole isteğe bağlı
Sekmelerin sabitlenip sabitlenmediği.
-
status
TabStatus isteğe bağlı
Sekme yükleme durumu.
-
title
string isteğe bağlı
Sayfa başlıklarını bir kalıpla eşleştirin. Uzantının
"tabs"
izni yoksa bu özellik yoksayılır. -
url
string | string[] 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ının
"tabs"
izni yoksa bu özellik yoksayılır. -
windowId
numara isteğe bağlı
Üst pencerenin kimliği veya geçerli pencere için
windows.WINDOW_ID_CURRENT
. -
windowType
WindowType isteğe bağlı
Sekmelerin bulunduğu pencerenin türü.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(result: Tab[]) => void
-
sonuç
Sekme[]
-
İlerlemeler
-
Promise<Tab[]>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
reload()
chrome.tabs.reload(
tabId?: number,
reloadProperties?: object,
callback?: function,
)
Bir sekmeyi yeniden yükleyin.
Parametreler
-
tabId
numara isteğe bağlı
Yeniden yüklenecek sekmenin kimliğidir. Varsayılan olarak geçerli pencerenin seçili sekmesidir.
-
reloadProperties
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
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
remove()
chrome.tabs.remove(
tabIds: number | number[],
callback?: function,
)
Bir veya daha fazla sekmeyi kapatır.
Parametreler
-
tabIds
numara | sayı[]
Kapatılacak sekme kimliği veya sekme kimliklerinin listesi.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
removeCSS()
chrome.tabs.removeCSS(
tabId?: number,
details: DeleteInjectionDetails,
callback?: function,
)
Manifest V3'te scripting.removeCSS
ile değiştirilmiştir.
Daha önce scripting.insertCSS
çağrısıyla yerleştirilen bir sayfa CSS'sinden kaldırılır.
Parametreler
-
tabId
numara 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 özelliği ayarlanmalıdır, ancak her ikisi de aynı anda ayarlanamaz.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
sendMessage()
chrome.tabs.sendMessage(
tabId: number,
message: any,
options?: object,
callback?: function,
)
Belirtilen sekmedeki içerik komut dosyalarına tek bir ileti gönderir ve bir yanıt geri gönderildiğinde isteğe bağlı bir geri çağırma işlevi çalışır. runtime.onMessage
etkinliği, geçerli uzantı için belirtilen sekmede çalışan her bir içerik komut dosyasında tetiklenir.
Parametreler
-
tabId
sayı
-
mesaj
Tümü
Gönderilecek ileti. Bu ileti, JSON öğesine uygun bir nesne olmalıdır.
-
seçenekler
isteğe bağlı
-
geri çağırma
Functions (isteğe bağlı)
Chrome 99 ve sonraki sürümlercallback
parametresi şu şekilde görünür:(response: any) => void
-
yanıt
Tümü
İletinin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken bir hata oluşursa geri çağırma bağımsız değişken olmadan çağrılır ve
runtime.lastError
, hata mesajına ayarlanır.
-
İlerlemeler
-
Söz<herhangi>
Chrome 99 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
sendRequest()
chrome.tabs.sendRequest(
tabId: number,
request: any,
callback?: function,
)
Lütfen runtime.sendMessage
hesabını kullanın.
Belirtilen sekmedeki içerik komut dosyalarına tek bir istek gönderir ve bir yanıt geri gönderildiğinde isteğe bağlı bir geri çağırma işlevi kullanılır. extension.onRequest
etkinliği, geçerli uzantı için belirtilen sekmede çalışan her bir içerik komut dosyasında tetiklenir.
Parametreler
-
tabId
sayı
-
istek
Tümü
-
geri çağırma
Functions (isteğe bağlı)
Chrome 99 ve sonraki sürümlercallback
parametresi şu şekilde görünür:(response: any) => void
-
yanıt
Tümü
İsteğin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken bir hata oluşursa geri çağırma bağımsız değişken olmadan çağrılır ve
runtime.lastError
, hata mesajına ayarlanır.
-
İlerlemeler
-
Söz<herhangi>
Chrome 99 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
setZoom()
chrome.tabs.setZoom(
tabId?: number,
zoomFactor: number,
callback?: function,
)
Belirli bir sekmeyi yakınlaştırır.
Parametreler
-
tabId
numara isteğe bağlı
Yakınlaştırma yapılacak sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
-
zoomFactor
sayı
Yeni yakınlaştırma faktörü.
0
değeri, sekmeyi geçerli varsayılan yakınlaştırma faktörüne ayarlar.0
değerinden büyük değerler, sekme için (muhtemelen varsayılan olmayan) bir yakınlaştırma faktörü belirtir. -
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
setZoomSettings()
chrome.tabs.setZoomSettings(
tabId?: number,
zoomSettings: ZoomSettings,
callback?: function,
)
Yakınlaştırma değişikliklerinin nasıl kullanılacağını tanımlayan, belirtilen bir sekme için yakınlaştırma ayarlarını belirler. Sekmeye gidildiğinde bu ayarlar varsayılanlara sıfırlanır.
Parametreler
-
tabId
numara isteğe bağlı
Yakınlaştırma ayarlarının değiştirileceği sekmenin kimliği; 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
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
ungroup()
chrome.tabs.ungroup(
tabIds: number | [number, ...number[]],
callback?: function,
)
Bir veya daha fazla sekmeyi ilgili gruplardan kaldırır. Boş hale gelen gruplar silinir.
Parametreler
-
tabIds
numara | [sayı, ...sayı[]]
İlgili gruplarından kaldırılacak sekme kimliği veya sekme kimliklerinin listesi.
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
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
numara isteğe bağlı
Varsayılan olarak geçerli pencerenin seçili sekmesi kullanılır.
-
updateProperties
nesne
-
etkin
boole isteğe bağlı
Sekmenin etkin olup olmayacağı. Pencerenin odaklanıp odaklanmamasını etkilemez (bkz.
windows.update
). -
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
numara isteğe bağlı
Bu sekmeyi açan sekmenin kimliği. Belirtilirse, açıcı sekmesi bu sekmeyle aynı pencerede olmalıdır.
-
sabitlendi
boole isteğe bağlı
Sekmenin sabitlenip sabitlenmeyeceğini belirler.
-
seçildi
boole isteğe bağlı
Kullanımdan kaldırıldıLütfen vurgulu özelliğini kullanın.
Sekmenin seçili olup olmayacağı.
-
url
string isteğe bağlı
Sekmenin gidilecek URL'si. JavaScript URL'leri desteklenmez. Bunun yerine
scripting.executeScript
kullanın.
-
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(tab?: Tab) => void
İlerlemeler
-
Promise<Tab | undefined>
Chrome 88 ve sonraki sürümlerVaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.
Etkinlikler
onActivated
chrome.tabs.onActivated.addListener(
callback: function,
)
Bir penceredeki etkin sekme değiştiğinde tetiklenir. Bu etkinlik tetiklendiğinde sekmenin URL'sinin ayarlanamayabileceğ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
hesabını kullanın.
Bir pencerede seçili sekme değiştiğinde tetiklenir. Bu etkinlik tetiklendiğinde sekme 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 değiştiği pencerenin kimliği.
-
-
onAttached
chrome.tabs.onAttached.addListener(
callback: function,
)
Sekme bir pencereye eklendiğinde (ör. pencereler arasında taşındığında) 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. Bu etkinlik tetiklendiği sırada sekmenin URL'sinin ve sekme grubu üyeliğinin ayarlanamayabileceğini unutmayın. Ancak bir URL oluşturulduğunda 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,
)
Sekme, pencereden ayrıldığında (örneğin, 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
hesabını 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[]
Penceredeki vurgulanan tüm sekmeler.
-
windowId
sayı
Sekmeleri değişen 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[]
Penceredeki vurgulanan tüm sekmeler.
-
windowId
sayı
Sekmeleri değişen pencere.
-
-
onMoved
chrome.tabs.onMoved.addListener(
callback: function,
)
Sekme bir pencere içinde taşındığında tetiklenir. Kullanıcının doğrudan taşıdığı sekmeyi temsil eden yalnızca bir taşıma etkinliği tetiklenir. Manuel olarak taşınan sekmeye yanıt olarak taşınması gereken diğer sekmeler için taşıma etkinlikleri tetiklenmez. Bir sekme pencereler arasında taşındığında bu etkinlik tetiklenmez. Ayrıntılar için bkz. tabs.onDetached
.
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 alır.
-
windowId
sayı
Sekmesi kapatılan pencere.
-
-
onReplaced
chrome.tabs.onReplaced.addListener(
callback: function,
)
Bir sekme, önceden 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
hesabını 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 değiştiği 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 duyulabilir 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
string isteğe bağlı
Sekmenin yeni favori simgesi URL'si.
-
groupId
numara 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 yoksayılma durumu ve değişikliğin nedeni.
-
sabitlendi
boole isteğe bağlı
Sekmenin yeni sabitlenmiş durumu.
-
status
TabStatus isteğe bağlı
Sekmenin yükleme durumu.
-
title
string isteğe bağlı
Chrome 48 ve sonraki sürümlerSekmenin yeni başlığı.
-
url
string 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
-
-