Bu sayfa, Cloud Translation API ile çevrilmiştir.

chrome.tabs

Açıklama

Tarayıcı sekme sistemiyle etkileşim kurmak için chrome.tabs API'yi kullanın. Tarayıcıda sekme oluşturmak, değiştirmek ve yeniden düzenlemek için bu API'yi kullanabilirsiniz.

Sekme API'si, sekmelerle ilgili işlem yapma ve sekmeleri yönetme özelliklerinin yanı sıra sekmenin dilini algılayabilir, ekran görüntüsü alabilir ve sekmenin içerik komut dosyalarıyla iletişim kurabilir.

İzinler

Çoğu özelliğin kullanılması için izin gerekmez. Örneğin: Yeni bir sekme oluşturma, bir sekmeyi yeniden yükleme, başka bir URL'ye geçme vb.

Geliştiricilerin Tabs API ile çalışırken dikkat etmesi gereken üç izin vardır.

"Sekmeler" izni

Bu izin, chrome.tabs ad alanına erişim sağlamaz. Bunun yerine, tabs.Tab örneklerindeki dört hassas mülkle (url, pendingUrl, title ve favIconUrl) ilgili olarak tabs.query() çağrısı yapma olanağı sağlar.

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

Ana makine izinleri

Ana makine izinleri, bir uzantının eşleşen sekmenin dört hassas tabs.Tab mülkünü okumasına ve sorgulamasına olanak tanır. Ayrıca tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() ve tabs.removeCSS() gibi yöntemleri kullanarak eşleşen sekmelerle doğrudan etkileşim kurabilirler.

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

"activeTab" izni

activeTab, kullanıcı çağrısına yanıt olarak uzantıya geçerli sekme için geçici ana makine izni verir. Ana makine izinlerinin aksine, activeTab herhangi bir uyarı tetiklemez.

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

Kullanım alanları

Aşağıdaki bölümlerde bazı yaygın kullanım alanları gösterilmektedir.

Uzantı sayfasını yeni bir sekmede açma

Uzantılarda sık karşılaşılan bir durum, uzantı yüklendiğinde yeni bir sekmede ilk katılım sayfasının açılmasıdı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 alma

Bu örnekte, bir uzantının hizmet çalışanının etkin sekmeyi şu anda odaklanmış pencereden (veya hiçbir Chrome penceresi odaklanmış değilse en son odaklanmış pencereden) nasıl alabileceği gösterilmektedir. Bu genellikle kullanıcının mevcut sekmesi olarak düşünülebilir.

  async function getCurrentTab() {
    let queryOptions = { active: true, lastFocusedWindow: true };
    // `tab` will either be a `tabs.Tab` instance or `undefined`.
    let [tab] = await chrome.tabs.query(queryOptions);
    return tab;
  }

  function getCurrentTab(callback) {
    let queryOptions = { active: true, lastFocusedWindow: true };
    chrome.tabs.query(queryOptions, ([tab]) => {
      if (chrome.runtime.lastError)
      console.error(chrome.runtime.lastError);
      // `tab` will either be a `tabs.Tab` instance or `undefined`.
      callback(tab);
    });
  }

Belirtilen sekmenin sesini kapatma

Bu örnekte, bir uzantının belirli bir sekmenin sessiz durumunu nasıl değiştirebileceği gösterilmektedir.

  async function toggleMuteState(tabId) {
    const tab = await chrome.tabs.get(tabId);
    const muted = !tab.mutedInfo.muted;
    await chrome.tabs.update(tabId, {muted});
    console.log(`Tab ${tab.id} is ${muted ? "muted" : "unmuted"}`);
  }

  function toggleMuteState(tabId) {
    chrome.tabs.get(tabId, async (tab) => {
      let muted = !tab.mutedInfo.muted;
      await chrome.tabs.update(tabId, { muted });
      console.log(`Tab ${tab.id} is ${ muted ? "muted" : "unmuted" }`);
    });
  }

Tıklandığında geçerli sekmeyi ilk konuma taşıma

Bu örnekte, sürükleme işlemi devam ederken veya devam etmezken bir sekmenin nasıl taşınacağı gösterilmektedir. Bu örnekte chrome.tabs.move kullanılsa da sürükleme işlemi devam ederken sekmeleri değiştiren diğer çağrılar için aynı bekleme modelini kullanabilirsiniz.

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

  async function moveToFirstPosition(activeInfo) {
    try {
      await chrome.tabs.move(activeInfo.tabId, {index: 0});
      console.log("Success.");
    } catch (error) {
      if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
        setTimeout(() => moveToFirstPosition(activeInfo), 50);
      } else {
        console.error(error);
      }
    }
  }

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

  function moveToFirstPositionMV2(activeInfo) {
    chrome.tabs.move(activeInfo.tabId, { index: 0 }, () => {
      if (chrome.runtime.lastError) {
        const error = chrome.runtime.lastError;
        if (error == "Error: Tabs cannot be edited right now (user may be dragging a tab).") {
          setTimeout(() => moveToFirstPositionMV2(activeInfo), 50);
        } else {
          console.error(error);
        }
      } else {
        console.log("Success.");
      }
    });
  }

Seçilen sekmenin içerik komut dosyasına mesaj gönderme

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 Sekmeler API'si uzantısı demosu için aşağıdakilerden birini inceleyin:

Türler

MutedInfo

Chrome 46 ve sonraki sürümler

Sekmenin sessiz durumu ve son durum değişikliğinin nedeni.

Özellikler

extensionId

dize isteğe bağlı

Sesi kapatma durumunu değiştiren uzantının kimliği. Sessiz durumunun en son değiştirilme nedeni bir uzantı değilse ayarlanmamış olur.
ses kapatıldı

boolean

Sekmenin sesinin kapalı olup olmadığı (ses çalmasının engellenmesi). Sekme, ses çalmayı durdurmamış veya şu anda ses çalmayı durdurmamış olsa bile sessize alınmış olabilir. "Sessiz" ses göstergesinin gösterilip gösterilmediğine eşdeğerdir.
neden

MutedInfoReason isteğe bağlı

Sekmenin sessize alınması veya sessize alınmasının kaldırılmasının nedeni. Sekmenin sessize alma durumu hiç değiştirilmediyse ayarlanmamış olur.

MutedInfoReason

Chrome 46 ve sonraki sürümler

Sesin kapatılması durumunun değişmesine neden olan bir etkinlik.

Enum

"user"
Bir kullanıcı girişi işlemi, sessiz durumunu ayarladı.

"capture"
Sekme yakalama işlemi başlatıldı ve sessiz durum değişikliği zorunlu kılındı.

"extension"
extensionId alanıyla tanımlanan bir uzantı, sessiz durumunu ayarladı.

Tab

Özellikler

etkin

boolean

Sekmenin penceresinde etkin olup olmadığı. Pencerenin odağa alındığı anlamına gelmez.
audible

boole isteğe bağlı

Chrome 45 ve sonraki sürümler

Sekmenin son birkaç saniye içinde ses çıkarıp çıkarmadığını belirtir (ancak sessize alınmışsa ses duyulmayabilir). "Hoparlör sesi" göstergesinin gösterilip gösterilmediğine eşdeğerdir.
autoDiscardable

boolean

Chrome 54 ve sonraki sürümler

Kaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak atlanıp atlanamayacağını belirtir.
silindi

boolean

Chrome 54 ve sonraki sürümler

Sekmenin atlanıp atlanmadığı. Atılan sekme, içeriği bellekten kaldırılmış ancak sekme şeridinde hâlâ görünür olan sekmedir. Bu cihaz tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
favIconUrl

dize isteğe bağlı

Sekmenin yer imi simgesinin URL'si. Bu özellik yalnızca uzantının manifest dosyasında "tabs" izni varsa bulunur. Sekme yükleniyorsa boş bir dize de olabilir.
dondurulmuş

boolean

Beklemede

Sekmenin donup donmadığı. Dondurulmuş bir sekme, etkinlik işleyiciler veya zamanlayıcılar da dahil olmak üzere görevleri yürütemez. Sekme şeridinde görünür ve içeriği belleğe yüklenir. Etkinleştirildiğinde dondurulması kaldırılır.
groupId

sayı

Chrome 88 ve sonraki sürümler

Sekmenin ait olduğu grubun kimliği.
yükseklik

number isteğe bağlı

Sekmenin piksel cinsinden yüksekliği.
öne çıkarıldı

boolean

Sekmenin vurgulanıp vurgulanmadığı.
id

number isteğe bağlı

Sekmenin kimliği. Sekme kimlikleri, tarayıcı oturumunda benzersizdir. Bazı durumlarda sekmeye kimlik atanmayabilir. Örneğin, sessions API'si kullanılarak yabancı sekmeler sorgulanırken oturum kimliği bulunabilir. Sekme kimliği, uygulamalar ve devtools pencereleri için chrome.tabs.TAB_ID_NONE olarak da ayarlanabilir.
gizli

boolean

Sekmenin gizli pencerede olup olmadığı.
indeks

sayı

Sekmenin penceresindeki sıfır tabanlı dizini.
lastAccessed

sayı

Chrome 121 ve sonraki sürümler

Dönemden itibaren geçen milisaniye sayısı olarak sekmeye en son erişilen zaman.
mutedInfo

MutedInfo isteğe bağlı

Chrome 46 ve sonraki sürümler

Sekmenin sessiz durumu ve son durum değişikliğinin nedeni.
openerTabId

number isteğe bağlı

Bu sekmeyi açan sekmenin kimliği (varsa). Bu özellik yalnızca açan sekmesi hâlâ mevcutsa bulunur.
pendingUrl

dize isteğe bağlı

Chrome 79 ve sonraki sürümler

Sekmenin, kaydetmeden önce gittiği URL. Bu özellik yalnızca uzantının manifest'i "tabs" iznini içeriyorsa ve bekleyen bir gezinme varsa mevcuttur.
sabitlendi

boolean

Sekmenin sabitlenmiş olup olmadığı.
seçildi

boolean

Kullanımdan kaldırıldı

Lütfen tabs.Tab.highlighted kullanın.
Sekmenin seçili olup olmadığı.
sessionId

dize isteğe bağlı

sessions API'sinden alınan bir sekmeyi benzersiz bir şekilde tanımlamak için kullanılan oturum kimliği.
durum

TabStatus isteğe bağlı

Sekmenin yükleme durumu.
title

dize isteğe bağlı

Sekmenin başlığı. Bu özellik yalnızca uzantının manifest dosyasında "tabs" izni varsa bulunur.
url

dize isteğe bağlı

Sekmenin ana çerçevesinin son bağlanan URL'si. Bu özellik yalnızca uzantının manifest dosyasında "tabs" izni varsa bulunur ve sekme henüz bağlanmamışsa boş bir dize olabilir. Ayrıca Tab.pendingUrl adresini de inceleyin.
genişlik

number isteğe bağlı

Sekmenin piksel cinsinden genişliği.
windowId

sayı

Sekmeyi içeren pencerenin kimliği.

TabStatus

Chrome 44 ve sonraki sürümler

Sekmenin yükleme durumu.

Enum

"unloaded"

"loading"

"complete"

WindowType

Chrome 44 ve sonraki sürümler

Pencerenin türü.

Enum

"normal"

"popup"

"panel"

"app"

"devtools"

ZoomSettings

Sekmedeki yakınlaştırma değişikliklerinin nasıl ve hangi kapsamda ele alınacağını tanımlar.

Özellikler

defaultZoomFactor

number isteğe bağlı

Chrome 43 ve sonraki sürümler

tabs.getZoomSettings çağrılarında geçerli sekmenin varsayılan yakınlaştırma düzeyini döndürmek için kullanılır.
mod

ZoomSettingsMode isteğe bağlı

Yakınlaştırma değişikliklerinin nasıl ele alınacağını (yani sayfanın gerçek ölçeklendirilmesinden hangi öğenin sorumlu olacağını) tanımlar. Varsayılan olarak automatic değerini alır.
kapsam

ZoomSettingsScope isteğe bağlı

Yakınlaştırma değişikliklerinin sayfanın kaynağında kalıcı olup olmayacağını veya yalnızca bu sekmede geçerli olup olmayacağını tanımlar. Varsayılan olarak automatic modunda per-origin, aksi takdirde per-tab değerini alır.

ZoomSettingsMode

Chrome 44 ve sonraki sürümler

Yakınlaştırma değişikliklerinin nasıl ele alınacağını (yani sayfanın gerçek ölçeklendirilmesinden hangi öğenin sorumlu olacağını) tanımlar. Varsayılan olarak automatic değerini alır.

Enum

"otomatik"
Yakınlaştırma değişiklikleri tarayıcı tarafından otomatik olarak yönetilir.

"manual"
Yakınlaştırma değişikliklerinin otomatik olarak işlenmesini geçersiz kılar. onZoomChange etkinliği yine gönderilir ve bu etkinliği dinlemek ve sayfayı manuel olarak ölçeklendirmek uzantının sorumluluğundadır. Bu mod, per-origin yakınlaştırma özelliğini desteklemediğinden scope yakınlaştırma ayarını yoksayar ve per-tab değerini varsayar.

"disabled"
Sekmede tüm yakınlaştırma işlemlerini devre dışı bırakır. Sekme varsayılan yakınlaştırma seviyesine geri döner ve tüm yakınlaştırma değişiklikleri yoksayılır.

ZoomSettingsScope

Chrome 44 ve sonraki sürümler

Yakınlaştırma değişikliklerinin sayfanın kaynağında kalıcı olup olmayacağını veya yalnızca bu sekmede geçerli olup olmayacağını tanımlar. Varsayılan olarak automatic modunda per-origin, aksi takdirde per-tab değerini alır.

Enum

"per-origin"
Yakınlaştırma değişiklikleri, yakınlaştırılmış sayfanın kaynağında kalır. Yani, aynı kaynağa yönlendirilen diğer tüm sekmeler de yakınlaştırılır. Ayrıca, per-origin yakınlaştırma değişiklikleri kaynakla birlikte kaydedilir. Bu nedenle, aynı kaynaktaki diğer sayfalara giderken bunların tümü aynı yakınlaştırma faktörüne 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 geçerli olur ve diğer sekmelerdeki yakınlaştırma değişiklikleri bu sekmenin yakınlaştırma ayarını etkilemez. Ayrıca, per-tab yakınlaştırma değişiklikleri gezinme sırasında sıfırlanır. Sekmelerde gezinirken sayfalar her zaman per-origin yakınlaştırma faktörleriyle yüklenir.

Özellikler

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 ve üzeri sürümler

captureVisibleTab işlevinin saniye başına çağrılabileceği maksimum sayı. captureVisibleTab pahalıdır ve çok sık çağrılmamalıdır.

Değer

TAB_ID_NONE

Chrome 46 ve sonraki sürümler

Tarayıcı sekmesinin bulunmadığını gösteren bir kimlik.

Değer

-1

TAB_INDEX_NONE

Chrome 123 ve üzeri sürümler

Bir tab_strip öğesinde sekme dizini bulunmadığını gösteren dizin.

Değer

-1

Yöntemler

captureVisibleTab()

Promise

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

Belirtilen pencerede etkin olan sekmenin görünür alanını yakalar. Bu yöntemin çağrılabilmesi için uzantının <all_urls> veya activeTab iznine sahip olması gerekir. Bu yöntem, uzantıların normalde erişebildiği sitelere ek olarak chrome:-scheme sayfaları, diğer uzantıların sayfaları ve data: URL'leri gibi normalde kısıtlanmış olan hassas siteleri yakalamasına olanak tanır. Bu hassas siteler yalnızca activeTab izniyle yakalanabilir. Dosya URL'leri yalnızca uzantıya dosya erişimi verilmişse yakalanabilir.

Parametreler

windowId

number isteğe bağlı

Hedef pencere. Varsayılan olarak mevcut pencere kullanılır.
seçenekler

ImageDetails isteğe bağlı
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(dataUrl: string) => void
```
- dataUrl
  
  dize
  
  Yakalanan sekmenin görünür alanının resmini kodlayan bir veri URL'si. Görüntülemek için bir HTML img öğesinin "src" özelliğine atanabilir.

İadeler

Promise<string>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

connect()

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

Belirtilen sekmedeki içerik komut dosyalarına bağlanır. runtime.onConnect etkinliği, geçerli uzantı için belirtilen sekmede çalışan her içerik komut dosyasında tetiklenir. Daha fazla bilgi için Content Script Mesajlaşma başlıklı makaleyi inceleyin.

Parametreler

tabId

sayı
connectInfo

nesne isteğe bağlı
- documentId
  
  dize isteğe bağlı
  
  Chrome 106 ve sonraki sürümler
  
  Sekmedeki tüm çerçeveler yerine documentId ile tanımlanan belirli bir doküman için bir bağlantı noktası açın.
- frameId
  
  number isteğe bağlı
  
  Sekmedeki tüm kareler yerine frameId ile tanımlanan belirli bir kare için bir bağlantı noktası açın.
- ad
  
  dize isteğe bağlı
  
  Bağlantı etkinliğini dinleyen içerik komut dosyaları için onConnect işlevine iletilir.

İadeler

runtime.Port

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()

Promise

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

Yeni bir sekme oluşturur.

Parametreler

createProperties

nesne
- etkin
  
  boole isteğe bağlı
  
  Sekmenin pencerede etkin sekme olup olmayacağı. Pencerenin odaklanıp odaklanmadığını etkilemez (windows.update bölümüne bakın). Varsayılan olarak true değerini alır.
- indeks
  
  number isteğe bağlı
  
  Sekmenin pencerede alması gereken konum. Sağlanan değer, sıfır ile penceredeki sekme sayısı arasında sınırlandırılır.
- openerTabId
  
  number isteğe bağlı
  
  Bu sekmeyi açan sekmenin kimliği. Belirtilirse açan sekme, yeni oluşturulan sekmeyle aynı pencerede olmalıdır.
- sabitlendi
  
  boole isteğe bağlı
  
  Sekmenin sabitlenip sabitlenmeyeceği. Varsayılan olarak false değerine ayarlanır.
- seçildi
  
  boole isteğe bağlı
  
  Kullanımdan kaldırıldı
  
  Lütfen etkin seçeneğini kullanın.
  Sekmenin, pencerede seçili sekme olup olmayacağı. Varsayılan olarak true değerine ayarlanır.
- url
  
  dize isteğe bağlı
  
  Sekmede ilk gidilecek URL. Tam nitelikli URL'ler bir şema (ör. "www.google.com" değil, "http://www.google.com"). Göreli URL'ler, uzantıdaki geçerli sayfaya görelidir. Varsayılan olarak Yeni Sekme sayfası kullanılır.
- windowId
  
  number isteğe bağlı
  
  Yeni sekmenin oluşturulacağı pencere. Varsayılan olarak mevcut pencere kullanılır.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(tab: Tab) => void
```
- sekmesinden
  
  Sekme
  
  Oluşturulan sekme.

İadeler

Promise<Tab>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

detectLanguage()

Promise

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

Sekmedeki içeriğin birincil dilini algılar.

Parametreler

tabId

number isteğe bağlı

Varsayılan olarak geçerli pencerenin etkin sekmesidir.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(language: string) => void
```
- language
  
  dize
  
  en veya fr gibi bir ISO dil kodu. Bu yöntemin desteklediği dillerin tam listesi için kLanguageInfoTable sayfasına bakın. İkinci ila dördüncü sütunlar kontrol edilir ve zh-CN değerinin döndürüldüğü Basitleştirilmiş Çince hariç olmak üzere ilk NULL olmayan değer döndürülür. Bilinmeyen/tanımlanmamış bir dil için und döndürülür.

İadeler

Promise<string>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

discard()

Promise Chrome 54 ve üzeri sürümler

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

Bir sekmeyi bellekten siler. Atılan sekmeler sekme şeridinde görünür durumda kalır ve etkinleştirildiğinde yeniden yüklenir.

Parametreler

tabId

number isteğe bağlı

Atılacak sekmenin kimliği. Belirtilen sekme, etkin olmadığı veya zaten atılmadığı sürece atılır. Atlanırsa tarayıcı en az önemli sekmeyi atar. Atılabilir sekme yoksa bu işlem başarısız olabilir.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(tab?: Tab) => void
```
- sekmesinden
  
  Sekme isteğe bağlı
  
  Silinen sekme (başarılı bir şekilde silindiyse); aksi takdirde tanımlanmaz.

İadeler

Promise<Tab | undefined>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

duplicate()

Promise

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

Sekmeyi kopyalar.

Parametreler

tabId

sayı

Kopyalanacak sekmenin kimliği.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(tab?: Tab) => void
```
- sekmesinden
  
  Sekme isteğe bağlı
  
  Kopyalanan sekmeyle ilgili ayrıntılar. "tabs" izni istenmemişse tabs.Tab nesnesi url, pendingUrl, title ve favIconUrl içermez.

İadeler

Promise<Tab | undefined>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

executeScript()

Promise &leq; MV2 Chrome 91'den beri kullanımdan kaldırıldı

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

Manifest V3'te scripting.executeScript ile değiştirildi.

Bir sayfaya JavaScript kodu ekler. Ayrıntılar için içerik komut dosyaları dokümanının programlı ekleme bölümüne bakın.

Parametreler

tabId

number isteğe bağlı

Komut dosyasının çalıştırılacağı sekmenin kimliğidir. Varsayılan olarak geçerli pencerenin etkin sekmesidir.
ayrıntılar

InjectDetails

Çalıştırılacak komut dosyasının ayrıntıları. Kod veya dosya mülkü ayarlanmalıdır ancak her ikisi aynı anda ayarlanamaz.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(result?: any[]) => void
```
- sonuç
  
  any[] isteğe bağlı
  
  Her enjekte edilen karede komut dosyasının sonucu.

İadeler

Promise<any[] | undefined>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

get()

Promise

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
  
  Sekme

İadeler

Promise<Tab>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getAllInWindow()

Promise &leq; MV2 Desteği sonlandırıldı

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

Lütfen tabs.query {windowId: windowId} kullanın.

Belirtilen penceredeki tüm sekmelerle ilgili ayrıntıları alır.

Parametreler

windowId

number isteğe bağlı

Varsayılan olarak mevcut pencere kullanılır.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(tabs: Tab[]) => void
```
- sekmeler
  
  Sekme[]

İadeler

Promise<Tab[]>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getCurrent()

Promise

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

Bu komut dosyası çağrısının yapıldığı sekmeyi alır. Sekme dışı bir bağlamda (ör. arka plan sayfası veya pop-up görünümü) çağrılırsa undefined döndürür.

Parametreler

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ı

İadeler

Promise<Tab | undefined>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getSelected()

Promise &leq; MV2 Desteği sonlandırıldı

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

Lütfen tabs.query {active: true} kullanın.

Belirtilen pencerede seçili olan sekmeyi alır.

Parametreler

windowId

number isteğe bağlı

Varsayılan olarak mevcut pencere kullanılır.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(tab: Tab) => void
```
- sekmesinden
  
  Sekme

İadeler

Promise<Tab>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getZoom()

Promise

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

Belirtilen sekmenin mevcut yakınlaştırma faktörünü alır.

Parametreler

tabId

number isteğe bağlı

Geçerli yakınlaştırma faktörünü alacağınız sekmenin kimliğidir. Varsayılan olarak geçerli pencerenin etkin sekmesidir.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(zoomFactor: number) => void
```
- zoomFactor
  
  sayı
  
  Sekmenin mevcut yakınlaştırma faktörü.

İadeler

Promise<number>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

getZoomSettings()

Promise

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

Belirtilen bir sekmenin mevcut yakınlaştırma ayarlarını alır.

Parametreler

tabId

number isteğe bağlı

Geçerli yakınlaştırma ayarlarını alacağınız sekmenin kimliği. Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(zoomSettings: ZoomSettings) => void
```
- zoomSettings
  
  ZoomSettings
  
  Sekmenin mevcut yakınlaştırma ayarları.

İadeler

Promise<ZoomSettings>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

goBack()

Promise Chrome 72 ve sonraki sürümler

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

Varsa önceki sayfaya dönün.

Parametreler

tabId

number isteğe bağlı

Geri gidilecek sekmenin kimliğidir. Varsayılan olarak geçerli pencerede seçili sekmedir.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

goForward()

Promise Chrome 72 ve sonraki sürümler

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

Varsa sonraki sayfaya gidin.

Parametreler

tabId

number isteğe bağlı

İleri gidilecek sekmenin kimliğidir. Varsayılan olarak geçerli pencerede seçili sekmedir.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

group()

Promise Chrome 88 ve sonraki sürümler

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

Belirtilen bir gruba bir veya daha fazla sekme ekler. Grup belirtilmezse belirtilen sekmeler yeni oluşturulan bir gruba eklenir.

Parametreler

seçenekler

nesne
- createProperties
  
  nesne isteğe bağlı
  
  Grup oluşturma yapılandırmaları. groupId zaten belirtilmişse kullanılamaz.
  - windowId
    
    number isteğe bağlı
    
    Yeni grubun penceresi. Varsayılan olarak geçerli pencere kullanılır.
- groupId
  
  number isteğe bağlı
  
  Sekmelerin ekleneceği grubun kimliği. Belirtilmemişse yeni bir grup oluşturulur.
- tabIds
  
  sayı | [sayı, ...sayı[]]
  
  Belirtilen gruba eklenecek sekme kimliği veya sekme kimlikleri listesi.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(groupId: number) => void
```
- groupId
  
  sayı
  
  Sekmelerin eklendiği grubun kimliği.

İadeler

Promise<number>

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

highlight()

Promise

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

Belirtilen sekmeleri vurgular ve grubun ilk sekmesine odaklanır. Belirtilen sekme şu anda etkinse hiçbir şey yapmamış gibi görünür.

Parametreler

highlightInfo

nesne
- sekmeler
  
  sayı | sayı[]
  
  Vurgulanacak bir veya daha fazla sekme dizini.
- windowId
  
  number 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
  
  Pencere
  
  Sekmelerinin vurgulandığı pencereyle ilgili ayrıntıları içerir.

İadeler

Promise<windows.Window>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

insertCSS()

Promise &leq; MV2 Chrome 91'den beri kullanımdan kaldırıldı

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

Manifest V3'te scripting.insertCSS ile değiştirildi.

Sayfaya CSS 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 programlı ekleme bölümüne bakın.

Parametreler

tabId

number isteğe bağlı

CSS'nin ekleneceği sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
ayrıntılar

InjectDetails

Eklenecek CSS metninin ayrıntıları. Kod veya dosya mülkü ayarlanmalıdır ancak her ikisi aynı anda ayarlanamaz.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

move()

Promise

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

Bir veya daha fazla sekmeyi penceresinde yeni bir konuma ya da yeni bir pencereye taşır. Sekmelerin yalnızca normal (window.type === "normal") pencerelere ve bu pencerelerden taşınabileceğini unutmayın.

Parametreler

tabIds

sayı | sayı[]

Taşınacak sekme kimliği veya sekme kimlikleri listesi.
moveProperties

nesne
- indeks
  
  sayı
  
  Pencerenin taşınacağı konum. Sekmeyi pencerenin sonuna yerleştirmek için -1 simgesini kullanın.
- windowId
  
  number isteğe bağlı
  
  Varsayılan olarak sekmenin şu anda bulunduğu penceredir.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(tabs: Tab | Tab[]) => void
```
- sekmeler
  
  Sekme | Sekme[]
  
  Taşınan sekmelerle ilgili ayrıntılar.

İadeler

Promise<Tab | Tab[]>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

query()

Promise

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

Belirtilen özelliklere sahip tüm sekmeleri veya özellik belirtilmemişse 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
  
  Sekmelerin sesli olup olmadığı.
- autoDiscardable
  
  boole isteğe bağlı
  
  Chrome 54 ve sonraki sürümler
  
  Kaynaklar azaldığında sekmelerin tarayıcı tarafından otomatik olarak atlanıp atlanamayacağını belirtir.
- currentWindow
  
  boole isteğe bağlı
  
  Sekmelerin geçerli pencerede olup olmadığı.
- silindi
  
  boole isteğe bağlı
  
  Chrome 54 ve sonraki sürümler
  
  Sekmelerin atlanıp atlanmayacağı. Atılan sekme, içeriği bellekten kaldırılmış ancak sekme şeridinde hâlâ görünür olan sekmedir. Bu cihaz tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
- dondurulmuş
  
  boole isteğe bağlı
  
  Beklemede
  
  Sekmelerin dondurulup dondurulmadığı. Dondurulmuş bir sekme, etkinlik işleyiciler veya zamanlayıcılar da dahil olmak üzere görevleri yürütemez. Sekme şeridinde görünür ve içeriği belleğe yüklenir. Etkinleştirildiğinde dondurulması kaldırılır.
- groupId
  
  number isteğe bağlı
  
  Chrome 88 ve sonraki sürümler
  
  Sekmelerin bulunduğu grubun kimliği veya gruplandırılmamış sekmeler için tabGroups.TAB_GROUP_ID_NONE.
- öne çıkarıldı
  
  boole isteğe bağlı
  
  Sekmelerin vurgulanıp vurgulanmayacağı.
- indeks
  
  number isteğe bağlı
  
  Sekmelerin pencerelerindeki konumu.
- lastFocusedWindow
  
  boole isteğe bağlı
  
  Sekmelerin, odaklanan son pencerede olup olmadığı.
- ses kapatıldı
  
  boole isteğe bağlı
  
  Chrome 45 ve sonraki sürümler
  
  Sekmelerin sessiz olup olmadığı.
- sabitlendi
  
  boole isteğe bağlı
  
  Sekmelerin sabitlenip sabitlenmediği.
- durum
  
  TabStatus isteğe bağlı
  
  Sekme yükleme durumu.
- title
  
  dize isteğe bağlı
  
  Sayfa başlıklarını bir kalıpla eşleştirme Uzantı "tabs" iznine sahip değilse bu özellik yoksayılır.
- url
  
  dize | dize[] isteğe bağlı
  
  Sekmeleri bir veya daha fazla URL kalıbıyla eşleştirin. Parça tanımlayıcıları eşleşmiyor. Uzantı "tabs" iznine sahip değilse bu özellik yoksayılır.
- windowId
  
  number isteğe bağlı
  
  Üst pencerenin kimliği veya mevcut pencere için windows.WINDOW_ID_CURRENT.
- windowType
  
  WindowType isteğe bağlı
  
  Sekmelerin bulunduğu pencerenin türü.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(result: Tab[]) => void
```
- sonuç
  
  Sekme[]

İadeler

Promise<Tab[]>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

reload()

Promise

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

Sekmeyi yeniden yükleyin.

Parametreler

tabId

number isteğe bağlı

Yeniden yüklenecek sekmenin kimliğidir. Varsayılan olarak geçerli pencerede seçili sekmedir.
reloadProperties

nesne isteğe bağlı
- bypassCache
  
  boole isteğe bağlı
  
  Yerel önbelleğe alma işleminin 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

Promise<void>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

remove()

Promise

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

Bir veya daha fazla sekmeyi kapatır.

Parametreler

tabIds

sayı | sayı[]

Kapatılacak sekme kimliği veya sekme kimlikleri listesi.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

removeCSS()

Promise Chrome 87 ve sonraki sürümler &leq; MV2 Chrome 91'den beri kullanımdan kaldırıldı

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ı ile bir sayfaya yerleştirilen CSS'yi kaldırır.

Parametreler

tabId

number isteğe bağlı

CSS'nin kaldırılacağı sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
ayrıntılar

DeleteInjectionDetails

Kaldırılacak CSS metninin ayrıntıları. Kod veya dosya mülkü ayarlanmalıdır ancak her ikisi aynı anda ayarlanamaz.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

sendMessage()

Promise

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

Belirtilen sekmedeki içerik komut dosyalarına tek bir mesaj gönderir. Bu mesaj, yanıt geri gönderildiğinde çalıştırılacak isteğe bağlı bir geri çağırma işlevi içerir. runtime.onMessage etkinliği, geçerli uzantı için belirtilen sekmede çalışan her içerik komut dosyasında tetiklenir.

Parametreler

tabId

sayı
mesaj

herhangi

Gönderilecek mesaj. Bu mesaj, JSON'a dönüştürülebilir bir nesne olmalıdır.
seçenekler

nesne isteğe bağlı
- documentId
  
  dize isteğe bağlı
  
  Chrome 106 ve sonraki sürümler
  
  Sekmedeki tüm kareler yerine documentId ile tanımlanan belirli bir dokümana mesaj gönderin.
- frameId
  
  number isteğe bağlı
  
  Sekmedeki tüm kareler yerine frameId ile tanımlanan belirli bir kareye mesaj gönderin.
geri çağırma

işlev isteğe bağlı

Chrome 99 ve üzeri sürümler

callback parametresi şu şekilde görünür:
```
(response: any) => void
```
- gönderin
  
  herhangi
  
  İletinin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken hata oluşursa geri çağırma işlevi bağımsız değişken olmadan çağrılır ve runtime.lastError hata mesajına ayarlanır.

İadeler

Promise<any>

Chrome 99 ve üzeri sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

sendRequest()

Promise &leq; MV2 Desteği sonlandırıldı

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. Bu istek, yanıt geri gönderildiğinde çalıştırılacak isteğe bağlı bir geri çağırma işlevi içerir. 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 üzeri sürümler

callback parametresi şu şekilde görünür:
```
(response: any) => void
```
- gönderin
  
  herhangi
  
  İsteğin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken hata oluşursa geri çağırma işlevi bağımsız değişken olmadan çağrılır ve runtime.lastError hata mesajına ayarlanır.

İadeler

Promise<any>

Chrome 99 ve üzeri sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setZoom()

Promise

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

Belirli bir sekmeyi yakınlaştırır.

Parametreler

tabId

number isteğe bağlı

Yakınlaştırı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 mevcut varsayılan yakınlaştırma faktörüne ayarlar. 0'ten büyük değerler, sekme için bir yakınlaştırma faktörü (varsayılan olmayan) belirtir.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

setZoomSettings()

Promise

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

Belirtilen bir sekme için yakınlaştırma ayarlarını belirler. Bu ayarlar, yakınlaştırma değişikliklerinin nasıl ele alınacağını tanımlar. Bu ayarlar, sekmede gezindiğinizde varsayılan ayarlara sıfırlanır.

Parametreler

tabId

number isteğe bağlı

Yakınlaştırma ayarlarını değiştirecek sekmenin kimliğidir. Varsayılan olarak geçerli pencerenin etkin sekmesidir.
zoomSettings

ZoomSettings

Yakınlaştırma değişikliklerinin nasıl ve hangi kapsamda ele alınacağını tanımlar.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

ungroup()

Promise Chrome 88 ve sonraki sürümler

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

Bir veya daha fazla sekmeyi ilgili gruplarından kaldırır. Boş kalan gruplar silinir.

Parametreler

tabIds

sayı | [sayı, ...sayı[]]

İlgili gruplarından kaldırılacak sekme kimliği veya sekme kimlikleri listesi.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
() => void
```

İadeler

Promise<void>

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

update()

Promise

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

Sekmenin özelliklerini değiştirir. updateProperties içinde belirtilmeyen özellikler değiştirilmez.

Parametreler

tabId

number isteğe bağlı

Varsayılan olarak geçerli penceredeki seçili sekmedir.
updateProperties

nesne
- etkin
  
  boole isteğe bağlı
  
  Sekmenin etkin olup olmayacağı. Pencerenin odaklanıp odaklanmadığını etkilemez (windows.update bölümüne bakın).
- autoDiscardable
  
  boole isteğe bağlı
  
  Chrome 54 ve sonraki sürümler
  
  Kaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak atlanıp atlanmayacağı.
- ö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ümler
  
  Sekmenin sessiz olup olmayacağı.
- openerTabId
  
  number isteğe bağlı
  
  Bu sekmeyi açan sekmenin kimliği. Belirtilirse açan sekme, bu sekmeyle aynı pencerede olmalıdır.
- sabitlendi
  
  boole isteğe bağlı
  
  Sekmenin sabitlenip sabitlenmeyeceği.
- seçildi
  
  boole isteğe bağlı
  
  Kullanımdan kaldırıldı
  
  Lütfen vurgulanan seçeneğini kullanın.
  Sekmenin seçilip seçilmeyeceği.
- url
  
  dize isteğe bağlı
  
  Sekmede gidilecek URL. JavaScript URL'leri desteklenmez. Bunun yerine scripting.executeScript kullanın.
geri çağırma

işlev isteğe bağlı

callback parametresi şu şekilde görünür:
```
(tab?: Tab) => void
```
- sekmesinden
  
  Sekme isteğe bağlı
  
  Güncellenen sekmeyle ilgili ayrıntılar. "tabs" izni istenmemişse tabs.Tab nesnesi url, pendingUrl, title ve favIconUrl içermez.

İadeler

Promise<Tab | undefined>

Chrome 88 ve sonraki sürümler

Sözler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırma işlevleri sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Sözleşme, geri çağırma işlevine iletilen türle çözülür.

Etkinlikler

onActivated

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

Bir penceredeki etkin sekme değiştiğinde tetiklenir. Bu etkinlik tetiklendiğinde sekmenin URL'sinin ayarlanmamış olabileceğini unutmayın. Ancak bir URL ayarlandığında bilgilendirilmek 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

&leq; MV2 Desteği sonlandırıldı

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

Lütfen tabs.onActivated kullanın.

Bir pencerede seçili sekme değiştiğinde tetiklenir. Bu etkinlik tetiklendiğinde sekmenin URL'sinin ayarlanmamış olabileceğini unutmayın. Ancak bir URL ayarlandığında bildirim almak için tabs.onUpdated etkinliklerini dinleyebilirsiniz.

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(tabId: number, selectInfo: object) => void
```
- tabId
  
  sayı
- selectInfo
  
  nesne
  - windowId
    
    sayı
    
    Seçilen sekmenin içinde değiştiği pencerenin kimliği.

onAttached

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

Bir 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. Sekmenin URL'si ve sekme grubu üyeliği, bu etkinlik tetiklendiğinde ayarlanmayabilir. Ancak URL ayarlandığında veya sekme bir sekme grubuna eklendiğinde bildirim almak için onUpdated etkinliklerini dinleyebilirsiniz.

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(tab: Tab) => void
```
- sekmesinden
  
  Sekme

onDetached

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

Bir sekme pencereden ayrıldığında (ör. pencereler arasında taşındığında) tetiklenir.

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(tabId: number, detachInfo: object) => void
```
- tabId
  
  sayı
- detachInfo
  
  nesne
  - oldPosition
    
    sayı
  - oldWindowId
    
    sayı

onHighlightChanged

&leq; MV2 Desteği sonlandırıldı

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
    
    number[]
    
    Pencerede vurgulanan tüm sekmeler.
  - windowId
    
    sayı
    
    Sekmelerinin değiştirildiği pencere.

onHighlighted

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

Bir pencerede vurgulanan veya seçilen sekmeler değiştiğinde tetiklenir.

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(highlightInfo: object) => void
```
- highlightInfo
  
  nesne
  - tabIds
    
    number[]
    
    Pencerede vurgulanan tüm sekmeler.
  - windowId
    
    sayı
    
    Sekmelerinin değiştirildiği pencere.

onMoved

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

Bir sekme pencere içinde taşındığında tetiklenir. Yalnızca bir taşıma etkinliği tetiklenir. Bu etkinlik, kullanıcının doğrudan taşıdığı sekmeyi temsil eder. Manuel olarak taşınan sekmeye yanıt olarak taşınması gereken diğer sekmeler için taşıma etkinlikleri tetiklenmez. Bu etkinlik, bir sekme pencereler arasında taşındığında tetiklenmez. Ayrıntılar için tabs.onDetached bölümüne bakın.

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(tabId: number, moveInfo: object) => void
```
- tabId
  
  sayı
- moveInfo
  
  nesne
  - fromIndex
    
    sayı
  - toIndex
    
    sayı
  - windowId
    
    sayı

onRemoved

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

Bir sekme kapatıldığında tetiklenir.

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(tabId: number, removeInfo: object) => void
```
- tabId
  
  sayı
- removeInfo
  
  nesne
  - isWindowClosing
    
    boolean
    
    Üst penceresi kapalı olduğu için sekme kapatıldığında doğru değerini döndürür.
  - windowId
    
    sayı
    
    Sekmesi kapalı olan pencere.

onReplaced

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

Bir sekme, ön oluşturma veya anında oluşturma nedeniyle başka bir sekmeyle değiştirildiğinde tetiklenir.

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(addedTabId: number, removedTabId: number) => void
```
- addedTabId
  
  sayı
- removedTabId
  
  sayı

onSelectionChanged

&leq; MV2 Desteği sonlandırıldı

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çilen 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ümler
    
    Sekmenin yeni sesli durumu.
  - autoDiscardable
    
    boole isteğe bağlı
    
    Chrome 54 ve sonraki sürümler
    
    Sekmenin yeni otomatik olarak atılabilir durumu.
  - silindi
    
    boole isteğe bağlı
    
    Chrome 54 ve sonraki sürümler
    
    Sekmenin yeni "Silindi" durumu.
  - favIconUrl
    
    dize isteğe bağlı
    
    Sekmenin yeni simge URL'si.
  - dondurulmuş
    
    boole isteğe bağlı
    
    Beklemede
    
    Sekmenin yeni dondurulmuş durumu.
  - groupId
    
    number isteğe bağlı
    
    Chrome 88 ve sonraki sürümler
    
    Sekmenin yeni grubu.
  - mutedInfo
    
    MutedInfo isteğe bağlı
    
    Chrome 46 ve sonraki sürümler
    
    Sekmenin yeni sessiz durumu ve değişikliğin nedeni.
  - sabitlendi
    
    boole isteğe bağlı
    
    Sekmenin yeni sabitlenmiş durumu.
  - durum
    
    TabStatus isteğe bağlı
    
    Sekmenin yükleme durumu.
  - title
    
    dize isteğe bağlı
    
    Chrome 48 ve sonraki sürümler
    
    Sekmenin yeni başlığı.
  - url
    
    dize isteğe bağlı
    
    Değiştiyse sekmenin URL'si.
- sekmesinden
  
  Sekme

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
    
    ZoomSettings