Açıklama
Tarayıcının sekme sistemiyle etkileşimde bulunmak için chrome.tabs
API'yi kullanın. Bu API'yi 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 sekmeleri dil olarak ayarlamak için, bir ekran görüntüsü alın ve bir sekmenin içerik metinleriyle iletişim kurun.
İzinler
Çoğu özellik için herhangi bir izin gerekmez. Örneğin: yeni bir sekme oluşturma, bir sekmeyi yeniden yükleme, başka bir URL'ye gitme vb.
Geliştiricilerin, Tabs API ile çalışırken dikkat etmeleri gereken üç izin vardır.
- "Sekmeler" izin
Bu izin,
chrome.tabs
ad alanına erişim sağlamaz. Bunun yerine bir uzantının dört farklı çağrıya göretabs.query()
çağrısı yapmasına olanak tanırtabs.Tab
örneklerindeki hassas özellikler:url
,pendingUrl
,title
vefavIconUrl
{ "name": "My extension", ... "permissions": [ "tabs" ], ... }
- Ana makine izinleri
Ana makine izinleri, bir uzantının eşleşen bir sekmenin dört hassas verilerini okumasına ve sorgulamasına olanak tanır.
tabs.Tab
mülk. Ayrıca, eşleşen sekmelerle doğrudan etkileşimde bulunabilirler. Bunun içintabs.captureVisibleTab()
olarak,tabs.executeScript()
,tabs.insertCSS()
vetabs.removeCSS()
{ "name": "My extension", ... "host_permissions": [ "http://*/*", "https://*/*" ], ... }
- "activeTab" izin
activeTab
, bir uzantıya şuradaki geçerli sekme için geçici ana makine izni verir: yanıt verir. Ana makine izinlerinden farklı olarakactiveTab
, herhangi bir uyarı tetiklemez.{ "name": "My extension", ... "permissions": [ "activeTab" ], ... }
Kullanım alanları
Aşağıdaki bölümlerde bazı yaygın kullanım alanları gösterilmektedir.
Bir uzantı sayfasını yeni sekmede açma
Uzantılar için yaygın bir kalıp, uzantı etkinken yeni bir sekmede ilk katılım sayfası açmaktır. yüklendi. 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 sırada odaklanmış pencere (veya hiçbir Chrome penceresine odaklanılmadıysa en son odaklanılan pencere). 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, bir uzantının belirli bir sekme için sessiz duruma nasıl geçebileceğ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şır
Bu örnekte, sürükleme devam ederken veya devam etmezken bir sekmenin nasıl taşınacağı gösterilmektedir. Bu örnekte
chrome.tabs.move
kullanırsa sekmelerde değişiklik yapan diğer çağrılar için aynı bekleme kalıbını
bir sürükleme devam ediyor.
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ı
Sessize alma durumunu değiştiren uzantının kimliği. Sesi kapalı durumun son değişmesinin nedeni bir uzantı değilse ayarlanmaz.
-
ses kapatıldı
boolean
Sekmenin sesinin kapatılıp kapatılmadığı (ses çalmasının engellenip engellenmediği). Sekme, çalınmasa veya o anda ses çalmasa bile sesi kapatılabilir. "Sessiz" olup olmadığına ses göstergesi gösteriliyor.
-
neden
MutedInfoReason isteğe bağlı
Sekmenin sesinin kapatılma veya sesinin açılma nedeni. Sekmenin sessize alma durumu hiç değiştirilmediyse ayarlanmaz.
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ığı için sessiz durum değişikliği zorunlu kılındı.
"extension"
ExtensionId alanıyla tanımlanan bir uzantı, sessiz durumunu ayarlayın.
Tab
Özellikler
-
etkin
boolean
Sekmenin kendi penceresinde etkin olup olmadığı. Pencerenin odaklanıldığı anlamına gelmesi gerekmez.
-
audible
boole isteğe bağlı
Chrome 45 ve sonraki sürümler 'nı inceleyin.Sekmenin son birkaç saniye içinde ses üretip üretmediği (ancak sesi kapatılmışsa ses duyulmayabilir). "Hoparlör sesi"nin olup olmadığına bakın.
-
autoDiscardable
boolean
Chrome 54 ve sonraki sürümler 'nı inceleyin.Kaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak silinip silinmeyeceği.
-
silindi
boolean
Chrome 54 ve sonraki sürümler 'nı inceleyin.Sekmenin silinip silinmediği. Silinen sekme, içeriği bellekten kaldırılan ancak sekme şeridinde görünmeye devam eden sekmelerdir. Tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
-
favIconUrl
dize isteğe bağlı
Sekmenin site simgesinin URL'si. Bu özellik yalnızca uzantının manifest dosyası
"tabs"
iznini içeriyorsa kullanılabilir. Sekme yükleniyorsa boş bir dize de olabilir. -
groupId
sayı
Chrome 88 ve sonraki sürümler 'nı inceleyin.Sekmenin ait olduğu grubun kimliği.
-
yükseklik
sayı 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 bir sekmeye kimlik atanamayabilir; Örneğin,
sessions
API'yi kullanarak yabancı sekmeleri sorgularken oturum kimliği bulunabilir. Sekme kimliği, uygulamalar ve geliştirici araçları pencereleri için dechrome.tabs.TAB_ID_NONE
olarak 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ümler 'nı inceleyin.Dö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ümler 'nı inceleyin.Sekmenin sessiz durumu ve son durum değişikliğinin nedeni.
-
openerTabId
sayı isteğe bağlı
Varsa, bu sekmeyi açan sekmenin kimliği. Bu özellik yalnızca açılış sekmesi hâlâ mevcutsa mevcuttur.
-
pendingUrl
dize isteğe bağlı
Chrome 79 ve sonraki sürümler 'nı inceleyin.Sekmenin gittiği URL, kaydetmeden önce. Bu özellik yalnızca uzantının manifest dosyası
"tabs"
iznini içeriyorsa ve bekleyen bir gezinme varsa kullanılabilir. -
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üklenme durumu.
-
title
dize isteğe bağlı
Sekmenin başlığı. Bu özellik yalnızca uzantının manifest dosyası
"tabs"
iznini içeriyorsa kullanılabilir. -
url
dize isteğe bağlı
Sekmenin ana çerçevesinin kaydedilen son URL'si. Bu özellik yalnızca uzantının manifest dosyası
"tabs"
iznini içeriyorsa kullanılabilir ve sekme henüz kaydetmediyse boş bir dize olabilir. Ayrıca bkz.Tab.pendingUrl
. -
genişlik
sayı isteğe bağlı
Sekmenin piksel cinsinden genişliği.
-
windowId
sayı
Sekmeyi içeren pencerenin kimliği.
TabStatus
Sekmenin yüklenme durumu.
Enum
"unload"
"loading"
"complete"
WindowType
Pencerenin türü.
Enum
"normal"
"popup"
"panel"
"uygulama"
"devtools"
ZoomSettings
Bir sekmedeki yakınlaştırma değişikliklerinin nasıl ve hangi kapsamda işleneceğini tanımlar.
Özellikler
-
defaultZoomFactor
sayı isteğe bağlı
Chrome 43 ve sonraki sürümler 'nı inceleyin.Sekmeler.getZoomSettings çağrılarında geçerli sekmenin varsayılan yakınlaştırma seviyesini döndürmek için kullanılır.
-
mod
ZoomSettingsMode optional
Yakınlaştırma değişikliklerinin nasıl işleneceğini (örneğin, sayfanın gerçek ölçeklendirmesinden hangi varlığın sorumlu olduğunu) tanımlar; varsayılan olarak
automatic
değerine ayarlanır. -
kapsam
ZoomSettingsScope isteğe bağlı
Yakınlaştırma değişikliklerinin sayfanın kaynağı için kalıcı mı yoksa yalnızca bu sekmede mi geçerli olacağını tanımlar;
automatic
modundayken varsayılan olarakper-origin
, aksi haldeper-tab
değerine ayarlanır.
ZoomSettingsMode
Yakınlaştırma değişikliklerinin nasıl işleneceğini (örneğin, sayfanın gerçek ölçeklendirmesinden hangi varlığın sorumlu olduğunu) tanımlar; varsayılan olarak automatic
değerine ayarlanı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 de gönderilir ve bu etkinliği dinleyip sayfayı manuel olarak ölçeklendirmek uzantının sorumluluğundadır. Bu mod per-origin
yakınlaştırmayı desteklemediğinden scope
yakınlaştırma ayarını yok sayar ve per-tab
değerini varsayar.
"disable"
Sekmedeki tüm yakınlaştırmayı 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ğı için kalıcı mı yoksa yalnızca bu sekmede mi geçerli olacağını tanımlar; automatic
modundayken varsayılan olarak per-origin
, aksi halde per-tab
değerine ayarlanı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 giden 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. Diğer sekmelerdeki yakınlaştırma değişiklikleri, bu sekmenin yakınlaştırmasını etkilemez. Ayrıca, gezinme sırasında per-tab
yakınlaştırma değişikliği sıfırlandı; bir sekmede gezinmek her zaman kendi per-origin
yakınlaştırma faktörleriyle birlikte sayfaları yükler.
Ö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ı sekmesi olmadığını temsil eden kimlik.
Değer
-1
TAB_INDEX_NONE
tab_strip içinde bir sekme dizini olmadığını temsil eden dizin.
Değer
-1
Yöntemler
captureVisibleTab()
chrome.tabs.captureVisibleTab(
windowId?: number,
options?: ImageDetails,
callback?: function,
)
Geçerli olarak etkin olan sekmenin, belirtilen pencerede 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 chrome:-scheme sayfaları ve diğer uzantılar da dahil olmak üzere normalde kısıtlanan hassas siteleri yakalamasına olanak tanır. ve veriler: URL'ler. Bu hassas siteler yalnızca ActiveTab izniyle yakalanabilir. Dosya URL'leri, yalnızca uzantıya dosya erişimi verildiyse yakalanabilir.
Parametreler
-
windowId
sayı 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
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ındaki bir görüntüyü kodlayan veri URL'si. "src" öğesine atanabilir özelliği için bir HTML
img
öğesini seçin.
-
İadeler
-
Promise<dize>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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 içerik komut dosyasında tetiklenir. Daha fazla bilgi için İçerik Komut Dosyası Mesajı 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ümler 'nı inceleyin.Sekmedeki tüm çerçeveler yerine
documentId
ile tanımlanan belirli bir dokümanın bağlantı noktasını açın. -
frameId
sayı isteğe bağlı
Sekmedeki tüm kareler yerine
frameId
ile tanımlanan belirli bir çerçevenin bağlantı noktasını açın. -
ad
dize isteğe bağlı
Bağlantı etkinliğini dinleyen içerik komut dosyaları için onConnect'e aktarılır.
-
İ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 odaklanmayacağını etkilemez (bkz.
windows.update
). Varsayılan olaraktrue
değerine ayarlanır. -
indeks
sayı 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ı
Desteği sonlandırıldıLütfen etkin değerini kullanın.
Sekmenin pencerede seçili sekme olup olmayacağı. Varsayılan olarak
true
değerine ayarlanır -
url
dize isteğe bağlı
Sekmede başlangıçta gidilecek URL. Tam nitelikli URL'ler bir şema (yani "http://www.google.com", "www.google.com" değil). Göreli URL'ler, uzantıdaki geçerli sayfaya göre belirlenir. Varsayılan olarak Yeni Sekme Sayfası kullanılır.
-
windowId
sayı isteğe bağlı
Yeni sekmenin oluşturulacağı pencere. 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:(tab: Tab) => void
-
sekmesinden
Oluşturulan sekme.
-
İadeler
-
Promise<Sekme>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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
sayı 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 bölümüne 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<dize>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
discard()
chrome.tabs.discard(
tabId?: number,
callback?: function,
)
Sekmeyi bellekten siler. Silinen sekmeler, sekme şeridinde görünmeye devam eder ve etkinleştirildiğinde yeniden yüklenir.
Parametreler
-
tabId
sayı isteğe bağlı
Silinecek sekmenin kimliği. Belirtilirse sekme, etkin olmadığı veya zaten silinmediği sürece silinir. Atlanırsa tarayıcı en az önemli olan sekmeyi siler. Silinebilir 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; tanımlanamaz.
-
İadeler
-
Söz ver<Sekme | tanımlanmadı>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
duplicate()
chrome.tabs.duplicate(
tabId: number,
callback?: function,
)
Sekmenin kopyasını oluşturur.
Parametreler
-
tabId
sayı
Çoğaltılacak sekmenin kimliği.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tab?: Tab) => void
İadeler
-
Söz ver<Sekme | tanımlanmadı>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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ş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
sayı isteğe bağlı
Komut dosyasının çalıştırılacağı sekmenin kimliği; geçerli pencerenin etkin sekmesine varsayılan olarak ayarlanır.
-
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 aynı anda ayarlanamaz.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(result?: any[]) => void
-
sonuç
herhangi[] isteğe bağlı
Yerleştirilen her kareye komut dosyasının sonucu.
-
İadeler
-
Promise<any[] | tanımlanmadı>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
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ümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
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
sayı 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<Sekme[]>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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ışı 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
İadeler
-
Söz ver<Sekme | tanımlanmadı>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
getSelected()
chrome.tabs.getSelected(
windowId?: number,
callback?: function,
)
Lütfen tabs.query
{active: true}
kullanın.
Belirtilen pencerede seçilen sekmeyi alır.
Parametreler
-
windowId
sayı 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:(tab: Tab) => void
-
sekmesinden
-
İadeler
-
Promise<Sekme>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
getZoom()
chrome.tabs.getZoom(
tabId?: number,
callback?: function,
)
Belirtilen sekmenin geçerli yakınlaştırma faktörünü alır.
Parametreler
-
tabId
sayı isteğe bağlı
Geçerli yakınlaştırma faktörünün alınacağı sekmenin kimliği; geçerli pencerenin etkin sekmesine varsayılan olarak ayarlanır.
-
geri çağırma
işlev 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ü.
-
İadeler
-
Promise<number>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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
sayı isteğe bağlı
Geçerli yakınlaştırma ayarlarının alınacağı sekmenin kimliği; geçerli pencerenin etkin sekmesine varsayılan olarak ayarlanır.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(zoomSettings: ZoomSettings) => void
-
zoomSettings
Sekmenin geçerli yakınlaştırma ayarları.
-
İadeler
-
Promise<ZoomSettings>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
goBack()
chrome.tabs.goBack(
tabId?: number,
callback?: function,
)
Varsa önceki sayfaya geri dönün.
Parametreler
-
tabId
sayı isteğe bağlı
Geri gidilecek sekmenin kimliği; geçerli pencerenin seçilen sekmesine varsayılan olarak ayarlanır.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<void>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
goForward()
chrome.tabs.goForward(
tabId?: number,
callback?: function,
)
Varsa bir sonraki sayfaya gidin.
Parametreler
-
tabId
sayı isteğe bağlı
İleriye gitmek için sekmenin kimliği; geçerli pencerenin seçilen sekmesine varsayılan olarak ayarlanır.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<void>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
group()
chrome.tabs.group(
options: object,
callback?: function,
)
Belirli bir gruba bir veya daha fazla sekme ekler ya da herhangi bir grup belirtilmemişse, verilen sekmeleri yeni oluşturulan bir gruba ekler.
Parametreler
-
seçenekler
nesne
-
createProperties
nesne isteğe bağlı
Grup oluşturmayla ilgili yapılandırmalar. groupId zaten belirtilmişse kullanılamaz.
-
windowId
sayı isteğe bağlı
Yeni grubun penceresi. Varsayılan olarak geçerli pencere kullanılır.
-
-
groupId
sayı 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 kimliklerinin 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>
Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
highlight()
chrome.tabs.highlight(
highlightInfo: object,
callback?: function,
)
Belirtilen sekmeleri vurgular ve grubun ilkine odaklanır. Belirtilen sekme şu anda etkin durumdaysa hiçbir şey yapmamış gibi görünür.
Parametreler
-
highlightInfo
nesne
-
sekmeler
sayı | numara[]
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ümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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ş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; geçerli pencerenin etkin sekmesine varsayılan olarak ayarlanır.
-
ayrıntılar
Eklenecek CSS metninin ayrıntıları. Kod veya dosya özelliği 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<void>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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 kendi penceresinde yeni bir konuma veya yeni bir pencereye taşır. Sekmelerin yalnızca normal (window.type === "normal") pencerelere ve bu pencerelerden taşınabileceğini unutmayın.
Parametreler
-
tabIds
sayı | numara[]
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
sayı 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 'nı inceleyin.
Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
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ümler 'nı inceleyin.Sekmelerin sesli olup olmadığı.
-
autoDiscardable
boole isteğe bağlı
Chrome 54 ve sonraki sürümler 'nı inceleyin.Kaynaklar azaldığında sekmelerin tarayıcı tarafından otomatik olarak silinip silinmeyeceğ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ümler 'nı inceleyin.Sekmelerin silinip silinmeyeceği. Silinen sekme, içeriği bellekten kaldırılan ancak sekme şeridinde görünmeye devam eden sekmelerdir. Tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
-
groupId
sayı isteğe bağlı
Chrome 88 ve sonraki sürümler 'nı inceleyin.Sekmelerin bulunduğu grubun kimliği veya gruplanmamış sekmeler için
tabGroups.TAB_GROUP_ID_NONE
. -
öne çıkarıldı
boole isteğe bağlı
Sekmelerin vurgulanıp vurgulanmadığı.
-
indeks
sayı isteğe bağlı
Sekmelerin pencerelerindeki 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ümler 'nı inceleyin.Sekmelerin sesinin kapatılıp kapatılmadığı.
-
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ı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ştirilmez. Uzantının
"tabs"
izni yoksa bu özellik yoksayılır. -
windowId
sayı 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 pencere 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<Sekme[]>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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
sayı isteğe bağlı
Yeniden yüklenecek sekmenin kimliği; geçerli pencerenin seçilen sekmesine varsayılan olarak 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<void>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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
sayı | numara[]
Kapatılacak sekme kimliği veya sekme kimliklerinin listesi.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<void>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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ş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; geçerli pencerenin etkin sekmesine varsayılan olarak ayarlanır.
-
ayrıntılar
Kaldırılacak CSS metninin ayrıntıları. Kod veya dosya özelliği 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<void>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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. İsteğe bağlı olarak, bir yanıt geri gönderildiğinde geri çağırma işlevi bulunur. 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 tarafından etkinleştirilebilen 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ümler 'nı inceleyin.callback
parametresi şu şekilde görünür:(response: any) => void
-
yanıt
herhangi
Mesajın işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken 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.
-
İadeler
-
Söz veriyorum<herhangi biri>
Chrome 99 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
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ümler 'nı inceleyin.callback
parametresi şu şekilde görünür:(response: any) => void
-
yanıt
herhangi
İsteğin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken 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.
-
İadeler
-
Söz veriyorum<herhangi biri>
Chrome 99 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
setZoom()
chrome.tabs.setZoom(
tabId?: number,
zoomFactor: number,
callback?: function,
)
Belirtilen sekmeyi yakınlaştırır.
Parametreler
-
tabId
sayı isteğe bağlı
Yakınlaştırmak için sekmenin kimliği; geçerli pencerenin etkin sekmesine varsayılan olarak ayarlanır.
-
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 (büyük olasılıkla varsayılan olmayan) bir yakınlaştırma faktörü belirtir. -
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<void>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, geri çağırmaya iletilen aynı türle çözümlenir.
setZoomSettings()
chrome.tabs.setZoomSettings(
tabId?: number,
zoomSettings: ZoomSettings,
callback?: function,
)
Belirtilen 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 gezinirken varsayılanlara sıfırlanır.
Parametreler
-
tabId
sayı isteğe bağlı
Yakınlaştırma ayarlarının değiştirileceği sekmenin kimliği; geçerli pencerenin etkin sekmesine varsayılan olarak ayarlanır.
-
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<void>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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 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 kimliklerinin listesi.
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<void>
Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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
sayı 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 odaklanmayacağını etkilemez (bkz.
windows.update
). -
autoDiscardable
boole isteğe bağlı
Chrome 54 ve sonraki sürümler 'nı inceleyin.Kaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak silinip silinmeyeceği.
-
öne çıkarıldı
boole isteğe bağlı
Sekmeyi geçerli seçime ekler veya mevcut seçimden kaldırır.
-
ses kapatıldı
boole isteğe bağlı
Chrome 45 ve sonraki sürümler 'nı inceleyin.Sekmenin 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ı
Desteği sonlandı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
alanını kullanın.
-
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(tab?: Tab) => void
İadeler
-
Söz ver<Sekme | tanımlanmadı>
Chrome 88 ve sonraki sürümler 'nı inceleyin.Manifest V3 ve sonraki sürümlerde vaatler desteklenir ancak geriye dönük uyumluluk Aynı işlev çağrısında ikisini birden kullanamazsınız. İlgili içeriği oluşturmak için kullanılan taahhüt, 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. Sekmenin 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 yer aldığı 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. Sekme URL'sinin bu etkinlik tetiklendiği anda ayarlanmış olmayabileceğ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,
)
Pencereye bir sekme eklendiğinde tetiklenir; Örneğin, pencereler arasında taşındığı için fark yaratırsınız.
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ğinde sekmenin URL'sinin ve sekme grubu üyeliğinin ayarlanamayacağını unutmayın. Ancak bir 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 çıkarıldığında tetiklenir; Örneğin, pencereler arasında taşındığı için fark yaratırsınız.
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[]
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,
)
Bir sekme 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 göre hareket etmesi 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 tabs.onDetached
sayfasına göz atı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 kapatılan pencere.
-
-
onReplaced
chrome.tabs.onReplaced.addListener(
callback: function,
)
Bir sekme, önceden işleme veya anında 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ümler 'nı inceleyin.Sekmenin yeni sesli durumu.
-
autoDiscardable
boole isteğe bağlı
Chrome 54 ve sonraki sürümler 'nı inceleyin.Sekmenin yeni otomatik atılabilir durumu.
-
silindi
boole isteğe bağlı
Chrome 54 ve sonraki sürümler 'nı inceleyin.Sekmenin yeni silinme durumu.
-
favIconUrl
dize isteğe bağlı
Sekmenin yeni site simgesinin URL'si.
-
groupId
sayı isteğe bağlı
Chrome 88 ve sonraki sürümler 'nı inceleyin.Sekmenin yeni grubu.
-
mutedInfo
MutedInfo isteğe bağlı
Chrome 46 ve sonraki sürümler 'nı inceleyin.Sekmenin yeni sessiz durumu ve değişikliğin nedeni.
-
sabitlendi
boole isteğe bağlı
Sekmenin yeni sabitlenme durumu.
-
durum
TabStatus isteğe bağlı
Sekmenin yüklenme durumu.
-
title
dize isteğe bağlı
Chrome 48 ve sonraki sürümler 'nı inceleyin.Sekmenin 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
-
-