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

chrome.tabs

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öre tabs.query() çağrısı yapmasına olanak tanır tabs.Tab örneklerindeki hassas özellikler: url, pendingUrl, title ve favIconUrl

{
  "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çin tabs.captureVisibleTab() olarak, tabs.executeScript(), tabs.insertCSS() ve tabs.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ı olarak 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.

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

Chrome 46 ve sonraki sürümler 'nı inceleyin.

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

Chrome 46 ve sonraki sürümler 'nı inceleyin.

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 de chrome.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

Chrome 44 ve sonraki sürümler 'nı inceleyin.

Sekmenin yüklenme durumu.

Enum

"unload"

"loading"

"complete"

WindowType

Chrome 44 ve sonraki sürümler 'nı inceleyin.

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 olarak per-origin, aksi halde per-tab değerine ayarlanır.

ZoomSettingsMode

Chrome 44 ve sonraki sürümler 'nı inceleyin.

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

Chrome 44 ve sonraki sürümler 'nı inceleyin.

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

Chrome 92 ve sonraki sürümler 'nı inceleyin.

Saniyede captureVisibleTab için maksimum çağrı sayısı. 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 'nı inceleyin.

Tarayıcı sekmesi olmadığını temsil eden kimlik.

Değer

-1

TAB_INDEX_NONE

Chrome 123 ve sonraki sürümler 'nı inceleyin.

tab_strip içinde bir sekme dizini olmadığını temsil eden dizin.

Değer

-1

Yöntemler

captureVisibleTab()

Söz 'nı inceleyin.

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

runtime.Port

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

Söz 'nı inceleyin.

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 olarak true 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
  
  Sekme
  
  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()

Söz 'nı inceleyin.

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 veya fr 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çin und 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()

Söz Chrome 54 ve sonraki sürümler

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ı
  
  Silinen sekme (başarıyla silindiyse); 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()

Söz 'nı inceleyin.

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
```
- sekmesinden
  
  Sekme isteğe bağlı
  
  Yinelenen sekmeyle ilgili ayrıntılar. "tabs" izni istenmediyse tabs.Tab nesnesi url, pendingUrl, title ve favIconUrl öğelerini içermez.

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

Söz &leq; MV2 Chrome 91'den bu yana desteği sonlandırıldı

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

InjectDetails

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

Söz 'nı inceleyin.

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

Söz &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

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

Söz 'nı inceleyin.

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

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

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

Söz &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ç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
  
  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.

getZoom()

Söz 'nı inceleyin.

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

Söz 'nı inceleyin.

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

Söz Chrome 72 ve sonraki sürümler

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

Söz Chrome 72 ve sonraki sürümler

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

Söz Chrome 88 ve sonraki sürümler

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

Söz 'nı inceleyin.

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

Söz &leq; MV2 Chrome 91'den bu yana desteği sonlandırıldı

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

InjectDetails

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

Söz 'nı inceleyin.

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
```
- sekmeler
  
  Sekme | Sekme[]
  
  Taşınan sekmelerle ilgili ayrıntılar.

İadeler

Söz ver<Sekme | 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.

query()

Söz 'nı inceleyin.

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

Söz 'nı inceleyin.

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

Söz 'nı inceleyin.

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

Söz Chrome 87 ve sonraki sürümler &leq; MV2 Chrome 91'den bu yana desteği sonlandı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ı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

DeleteInjectionDetails

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

Söz 'nı inceleyin.

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ı
- documentId
  
  dize isteğe bağlı
  
  Chrome 106 ve sonraki sürümler 'nı inceleyin.
  
  Sekmedeki tüm kareler yerine documentId tarafından tanımlanan belirli bir dokümana ileti gönderin.
- frameId
  
  sayı isteğe bağlı
  
  Sekmedeki tüm kareler yerine frameId ile tanımlanan belirli bir kareye ileti gönderin.
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()

Söz &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. İ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()

Söz 'nı inceleyin.

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

Söz 'nı inceleyin.

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

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

Söz 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 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()

Söz 'nı inceleyin.

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
```
- sekmesinden
  
  Sekme isteğe bağlı
  
  Güncellenen sekmeyle ilgili ayrıntılar. "tabs" izni istenmediyse tabs.Tab nesnesi url, pendingUrl, title ve favIconUrl öğelerini içermez.

İ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. Sekme URL'sinin bu etkinlik tetiklendiği anda ayarlanmış olmayabileceğini, 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

&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. Sekme URL'sinin bu etkinlik tetiklendiği anda ayarlanmış olmayabileceğini 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 etkinleştiğ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
  
  Sekme

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

&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
    
    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

&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ç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
  
  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