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

chrome.tabs

Açıklama

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

Tabs API yalnızca sekmeleri değiştirme ve yönetme özellikleri sunmakla kalmaz, aynı zamanda sekmenin dilini algılayabilir, ekran görüntüsü alabilir ve sekmenin içerik komut dosyalarıyla iletişim kurabilir.

İzinler

Çoğu özellik için herhangi bir izin gerekmez. Örneğin: Yeni sekme oluşturma, bir sekmeyi yeniden yükleme, başka bir URL'ye gezinme vb.

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

"Sekmeler" izni

Bu izin, chrome.tabs ad alanına erişim sağlamaz. Bunun yerine, bir uzantının tabs.Tab örneklerindeki şu dört hassas özelliğe karşı tabs.query() öğesini çağırmasını sağlar: url, pendingUrl, title vefavIconUrl.

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

Ana makine izinleri

Ana makine izinleri, bir uzantının eşleşen sekmenin dört hassas tabs.Tab özelliğini okumasına ve sorgulamasına olanak tanır. Ayrıca tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() ve tabs.removeCSS() gibi yöntemler kullanarak eşleşen sekmelerle doğrudan etkileşime geçebilirler.

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

"activeTab" izni

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

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

Kullanım alanları

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

Uzantı sayfasını yeni sekmede açma

Uzantılar için yaygın olarak kullanılan bir kalıp, uzantı yüklendiğinde yeni bir sekmede ilk katılım sayfası açmaktır. Aşağıdaki örnekte bunun nasıl yapılacağı gösterilmektedir.

background.js:

chrome.runtime.onInstalled.addListener(({reason}) => {
  if (reason === 'install') {
    chrome.tabs.create({
      url: "onboarding.html"
    });
  }
});

Geçerli sekmeyi al

Bu örnekte, bir uzantının hizmet çalışanının etkin sekmeyi o anda odaklanılan pencereden (veya hiç Chrome penceresi odaklanılmamışsa en son odaklanılan pencereden) nasıl alabileceği gösterilmektedir. Bu, genellikle kullanıcının geçerli sekmesi olarak düşünülebilir.

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

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

Belirtilen sekmeyi yoksay

Bu örnekte, uzantının belirli bir sekme için sessize alma durumunu nasıl açıp kapatabileceği gösterilmektedir.

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

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

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

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

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

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

  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

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

Seçili sekmenin içerik komut dosyasına bir mesaj iletin

Bu örnekte, bir uzantının hizmet çalışanının tabs.sendMessage() kullanarak belirli tarayıcı sekmelerindeki içerik komut dosyalarıyla nasıl iletişim kurabileceği gösterilmektedir.

function sendMessageToActiveTab(message) {
  const [tab] = await chrome.tabs.query({ active: true, lastFocusedWindow: true });
  const response = await chrome.tabs.sendMessage(tab.id, message);
  // TODO: Do something with the response.
}

Uzantı örnekleri

Diğer Tabs API uzantıları demoları için aşağıdakilerden herhangi birini inceleyin:

Türler

MutedInfo

Chrome 46 ve sonraki sürümler

Sekmenin sessize alınmış durumu ve son durum değişikliğinin nedeni.

Özellikler

extensionId

string isteğe bağlı

Sessize alınma durumunu değiştiren uzantının kimliği. Sessize alma durumunun son değiştirilme nedeni uzantı değilse ayarlanmaz.
ses kapatıldı

boolean

Sekmenin sesinin kapatılıp kapatılmadığı (ses çalmasının engellenip engellenmediği). Sekmenin sesi çalınmasa veya şu anda ses çalmıyor olsa bile kapatılabilir. "Sesi kapalı" ses göstergesinin gösterilip gösterilmediğini belirten eşdeğerdir.
neden

MutedInfoReason isteğe bağlı

Sekmenin sesinin kapatılma veya açılma nedeni. Sekmenin sessize alma durumu hiç değiştirilmemişse ayarlanmaz.

MutedInfoReason

Chrome 46 ve sonraki sürümler

Sesi kapatılmış durum değişikliğine neden olan bir etkinlik.

Enum

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

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

"extension"
ExtensionId alanıyla tanımlanan bir uzantı, sesi kapalı durumunu ayarlar.

Tab

Özellikler

etkin

boolean

Sekmenin penceresinde etkin olup olmadığı. Pencerenin odaklandığı anlamına gelmez.
audible

boole isteğe bağlı

Chrome 45 ve sonraki sürümler

Sekmenin son birkaç saniye içinde ses üretip üretmediği (ancak sessize alınmışsa duyulmayabilir). "Hoparlör sesi" göstergesinin gösterilip gösterilmediğiyle aynı etkiye sahiptir.
autoDiscardable

boolean

Chrome 54 ve sonraki sürümler

Kaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak silinip silinemeyeceği.
silindi

boolean

Chrome 54 ve sonraki sürümler

Sekmenin silinip silinmediği. Silinen sekme, içeriği bellekten kaldırılan, ancak sekme şeridinde görünmeye devam eden bir sekmedir. Tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
favIconUrl

string isteğe bağlı

Sekmenin favori simgesinin URL'si. Bu özellik yalnızca uzantının manifesti "tabs" iznini içeriyorsa kullanılabilir. Sekme yükleniyorsa boş bir dize de olabilir.
groupId

sayı

Chrome 88 ve sonraki sürümler

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

numara isteğe bağlı

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

boolean

Sekmenin vurgulu olup olmadığı.
id

numara isteğe bağlı

Sekmenin kimliği. Sekme kimlikleri, tarayıcı oturumunda benzersizdir. Bazı durumlarda bir sekmeye kimlik atanmayabilir. Örneğin, sessions API'sini kullanarak yabancı sekmeleri sorgularken bir oturum kimliği mevcut olabilir. Sekme kimliği, uygulamalar ve geliştirme araçları pencereleri için de chrome.tabs.TAB_ID_NONE olarak ayarlanabilir.
gizli

boolean

Sekmenin gizli pencerede olup olmadığı.
indeks

sayı

Sekmenin penceresi içindeki sıfır tabanlı dizini.
lastAccessed

numara isteğe bağlı

Chrome 121 ve sonraki sürümler

Dönemden beri geçen milisaniye sayısı olarak, sekmeye en son ne zaman erişildiği.
mutedInfo

MutedInfo isteğe bağlı

Chrome 46 ve sonraki sürümler

Sekmenin sessize alınmış durumu ve son durum değişikliğinin nedeni.
openerTabId

numara isteğe bağlı

Varsa, bu sekmeyi açan sekmenin kimliği. Bu özellik yalnızca açılış sekmesi hâlâ mevcutsa mevcuttur.
pendingUrl

string isteğe bağlı

Chrome 79 ve sonraki sürümler

Sekmenin taahhüt edilmeden önce gittiği URL. Bu özellik yalnızca uzantının manifest dosyası "tabs" iznini içeriyorsa ve bekleyen bir gezinme işlemi varsa kullanılabilir.
sabitlendi

boolean

Sekmenin sabitlenip sabitlenmediği.
seçili

boolean

Kullanımdan kaldırıldı

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

string isteğe bağlı

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

TabStatus isteğe bağlı

Sekmenin yükleme durumu.
title

string isteğe bağlı

Sekmenin başlığı. Bu özellik yalnızca uzantının manifesti "tabs" iznini içeriyorsa kullanılabilir.
url

string isteğe bağlı

Sekmenin ana çerçevesinin son kaydedilen URL'si. Bu özellik yalnızca uzantının manifesti, "tabs" iznini içeriyorsa mevcuttur ve sekme henüz taahhütte bulunmadıysa boş bir dize olabilir. Ayrıca bkz. Tab.pendingUrl.
genişlik

numara isteğe bağlı

Sekmenin piksel cinsinden genişliği.
windowId

sayı

Sekmeyi içeren pencerenin kimliği.

TabStatus

Chrome 44 ve sonraki sürümler

Sekmenin yükleme durumu.

Enum

"complete"

WindowType

Chrome 44 ve sonraki sürümler

Pencerenin türü.

Enum

"normal"

"popup"

"panel":

"devtools"

ZoomSettings

Bir sekmedeki yakınlaştırma değişikliklerinin nasıl ve hangi kapsamda işleneceğini tanımlar.

Özellikler

defaultZoomFactor

numara isteğe bağlı

Chrome 43 ve sonraki sürümler

tab.getZoomSettings için yapılan çağrılarda geçerli sekme için varsayılan yakınlaştırma düzeyini döndürmek üzere kullanılır.
mod

ZoomSettingsMode isteğe bağlı

Yakınlaştırma değişikliklerinin nasıl işleneceğini (yani sayfanın gerçek ölçeklendirmesinden hangi varlığın sorumlu olduğunu) tanımlar; varsayılan olarak automatic değerini alır.
kapsam

ZoomSettingsScope isteğe bağlı

Yakınlaştırma değişikliklerinin sayfanın kaynağı için mi geçerli olacağını yoksa yalnızca bu sekmede mi geçerli olacağını tanımlar; automatic modundayken varsayılan olarak per-origin, aksi halde per-tab değerini alır.

ZoomSettingsMode

Chrome 44 ve sonraki sürümler

Yakınlaştırma değişikliklerinin nasıl işleneceğini (yani sayfanın gerçek ölçeklendirmesinden hangi varlığın sorumlu olduğunu) tanımlar; varsayılan olarak automatic değerini alır.

Enum

"auto"
Yakınlaştırma değişiklikleri tarayıcı tarafından otomatik olarak işlenir.

"manual"
Yakınlaştırma değişikliklerinin otomatik olarak işlenmesini geçersiz kılar. onZoomChange etkinliği dağıtılmaya devam eder ve bu etkinliği dinlemek ve sayfayı manuel olarak ölçeklendirmek uzantının sorumluluğundadır. Bu mod, per-origin yakınlaştırmasını desteklemediğinden scope yakınlaştırma ayarını yok sayar ve per-tab olduğunu varsayar.

"disabled"
Sekmedeki tüm yakınlaştırmayı devre dışı bırakır. Sekme, varsayılan yakınlaştırma düzeyine döner ve denenen tüm yakınlaştırma değişiklikleri yok sayılır.

ZoomSettingsScope

Chrome 44 ve sonraki sürümler

Yakınlaştırma değişikliklerinin sayfanın kaynağı için mi geçerli olacağını yoksa yalnızca bu sekmede mi geçerli olacağını tanımlar; automatic modundayken varsayılan olarak per-origin, aksi halde per-tab değerini alır.

Enum

"kaynak başına"
Yakınlaştırma değişiklikleri, yakınlaştırılan sayfanın kaynağında da kalır. Yani aynı kaynağa giden diğer tüm sekmeler de yakınlaştırılır. Ayrıca, per-origin yakınlaştırma değişikliği kaynak ile birlikte kaydedilir, yani aynı kaynaktaki diğer sayfalara gidildiğinde tümü aynı yakınlaştırma faktörüne göre yakınlaştırılır. per-origin kapsamı yalnızca automatic modunda kullanılabilir.

"sekme başına"
Yakınlaştırma değişiklikleri yalnızca bu sekmede etkili olur ve diğer sekmelerdeki yakınlaştırma değişiklikleri bu sekmenin yakınlaştırmasını etkilemez. Ayrıca, per-tab yakınlaştırma değişiklikleri gezinme sırasında sıfırlanır; bir sekmede gezinirken sayfalar her zaman per-origin yakınlaştırma faktörleriyle yüklenir.

Özellikler

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 ve sonraki sürümler

captureVisibleTab işlevinin saniyede maksimum çağrılma sayısı. captureVisibleTab pahalı olduğundan çok sık aranmamalıdır.

Değer

TAB_ID_NONE

Chrome 46 ve sonraki sürümler

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

Değer

-1

TAB_INDEX_NONE

Chrome 123 ve sonraki sürümler

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

Değer

-1

Yöntemler

captureVisibleTab()

Söz

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

Belirtilen pencerede etkin olan sekmenin görünür alanını yakalar. Bu yöntemi çağırmak için uzantının <all_urls> veya activeTab iznine sahip olması gerekir. Bu yöntem, uzantıların normalde erişebildiği sitelere ek olarak, uzantıların başka bir şekilde kısıtlanmış olan hassas siteleri yakalamalarına olanak tanır. Örneğin, chrome:-şema sayfaları, diğer uzantıların sayfaları ve "URL'ler" verileri. Bu hassas siteler yalnızca ActiveTab izniyle yakalanabilir. Dosya URL'leri, yalnızca uzantıya dosya erişim izni verilmişse yakalanabilir.

Parametreler

windowId

numara isteğe bağlı

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

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

Functions (isteğe bağlı)

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

İlerlemeler

Söz<dize>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

connect()

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

Belirtilen sekmedeki içerik komut dosyalarına bağlanır. runtime.onConnect etkinliği, geçerli uzantı için belirtilen sekmede çalışan her bir içerik komut dosyasında tetiklenir. Daha fazla ayrıntı için Content Komut Dosyası Mesajlaşması bölümüne bakın.

Parametreler

tabId

sayı
connectInfo

isteğe bağlı
- documentId
  
  string isteğe bağlı
  
  Chrome 106 ve sonraki sürümler
  
  Sekmedeki tüm çerçeveler yerine documentId tarafından tanımlanan belirli bir dokümana bağlantı noktası açın.
- frameId
  
  numara isteğe bağlı
  
  Sekmedeki tüm kareler yerine frameId tarafından tanımlanan belirli bir çerçeveye bağlantı noktası açın.
- ad
  
  string isteğe bağlı
  
  Bağlantı etkinliğini dinleyen içerik komut dosyaları için onConnect'e iletilir.

İlerlemeler

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

Söz

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

Yeni sekme oluşturur.

Parametreler

createProperties

nesne
- etkin
  
  boole isteğe bağlı
  
  Sekmenin pencerede etkin sekme olup olmayacağı. Pencerenin odaklanıp odaklanmamasını etkilemez (bkz. windows.update). Varsayılan olarak true değerine ayarlanır.
- indeks
  
  numara isteğe bağlı
  
  Sekmenin pencerede bulunması gereken konum. Sağlanan değer, sıfır ile penceredeki sekme sayısı arasına sabitlenir.
- openerTabId
  
  numara isteğe bağlı
  
  Bu sekmeyi açan sekmenin kimliği. Belirtilirse, açıcı sekmesi, yeni oluşturulan sekmeyle aynı pencerede olmalıdır.
- sabitlendi
  
  boole isteğe bağlı
  
  Sekmenin sabitlenip sabitlenmeyeceğini belirler. Varsayılan olarak false değerine ayarlanır
- seçili
  
  boole isteğe bağlı
  
  Kullanımdan kaldırıldı
  
  Lütfen etkin ayarını kullanın.
  Sekmenin pencerede seçili sekme olup olmayacağı. Varsayılan olarak true değerine ayarlanır
- url
  
  string isteğe bağlı
  
  Sekmenin başlangıçta gidilecek URL'si. Tam nitelikli URL'ler bir şema (ör. 'www.google.com' değil, 'http://www.google.com'). Göreli URL'ler, uzantı içindeki geçerli sayfaya göre değişir. Varsayılan olarak Yeni Sekme Sayfası kullanılır.
- windowId
  
  numara isteğe bağlı
  
  Yeni sekmenin oluşturulacağı pencere. Varsayılan olarak geçerli pencere kullanılır.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<Tab>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

detectLanguage()

Söz

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

Bir sekmedeki içeriğin birincil dilini algılar.

Parametreler

tabId

numara isteğe bağlı

Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Söz<dize>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

discard()

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

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

Bir sekmeyi bellekten siler. Silinen sekmeler, sekme şeridinde görünmeye devam eder ve etkinleştirildiklerinde yeniden yüklenir.

Parametreler

tabId

numara isteğe bağlı

Silinecek sekmenin kimliği. Belirtilirse sekme etkin değilse veya silinmiş değilse silinir. Atlanırsa, tarayıcı en önemsiz sekmeyi siler. Silinebilir sekme yoksa bu işlem başarısız olabilir.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Vaat<Sekme|undefined>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

duplicate()

Söz

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

Bir sekmenin kopyasını oluşturur.

Parametreler

tabId

sayı

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

Functions (isteğe bağlı)

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

İlerlemeler

Vaat<Sekme|undefined>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

executeScript()

Söz &leq; MV2 Chrome 91 sürümünden itibaren kullanımdan kaldırıldı

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

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

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

Parametreler

tabId

numara isteğe bağlı

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

InjectDetails

Çalıştırılacak komut dosyasının ayrıntıları. Kod veya dosya özelliği ayarlanmalıdır, ancak her ikisi de aynı anda ayarlanamaz.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Vaat<herhangi biri[]|tanımsız>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

get()

Söz

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

Belirtilen sekmeyle ilgili ayrıntıları getirir.

Parametreler

tabId

sayı
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<Tab>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getAllInWindow()

Söz &leq; MV2 Kullanımdan kaldırıldı

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

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

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

Parametreler

windowId

numara isteğe bağlı

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

Functions (isteğe bağlı)

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

İlerlemeler

Promise<Tab[]>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getCurrent()

Söz

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

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

Parametreler

geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
(tab?: Tab)=>void
```
- sekmesinden
  
  Sekme isteğe bağlı

İlerlemeler

Vaat<Sekme|undefined>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getSelected()

Söz &leq; MV2 Kullanımdan kaldırıldı

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

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

Belirtilen pencerede seçilen sekmeyi getirir.

Parametreler

windowId

numara isteğe bağlı

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

Functions (isteğe bağlı)

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

İlerlemeler

Promise<Tab>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getZoom()

Söz

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

Belirtilen bir sekmenin geçerli yakınlaştırma faktörünü alır.

Parametreler

tabId

numara isteğe bağlı

Geçerli yakınlaştırma faktörünün alınacağı sekme kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Vaat<sayı>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

getZoomSettings()

Söz

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

Belirtilen bir sekmenin geçerli yakınlaştırma ayarlarını alır.

Parametreler

tabId

numara isteğe bağlı

Geçerli yakınlaştırma ayarlarının alınacağı sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<ZoomSettings>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

goBack()

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

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

Varsa önceki sayfaya geri gitme.

Parametreler

tabId

numara isteğe bağlı

Geri gidilecek sekmenin kimliği; varsayılan olarak geçerli pencerenin seçili sekmesidir.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<void>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

goForward()

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

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

Varsa sonraki sayfaya gidin.

Parametreler

tabId

numara isteğe bağlı

İleri gidilecek sekmenin kimliği; varsayılan olarak geçerli pencerenin seçili sekmesidir.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<void>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

group()

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

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

Belirtilen gruba bir veya daha fazla sekme ekler ya da herhangi bir grup belirtilmezse belirtilen sekmeleri yeni oluşturulan bir gruba ekler.

Parametreler

seçenekler

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

Functions (isteğe bağlı)

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

İlerlemeler

Vaat<sayı>

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

highlight()

Söz

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

Belirtilen sekmeleri vurgular ve ilk gruba odaklanır. Belirtilen sekme şu anda etkinse hiçbir şey yapmıyor gibi görünecek.

Parametreler

highlightInfo

nesne
- sekmeler
  
  numara|sayı[]
  
  Vurgulanacak bir veya daha fazla sekme dizini.
- windowId
  
  numara isteğe bağlı
  
  Sekmeleri içeren pencere.
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
(window: Window)=>void
```
- pencere
  
  Pencere
  
  Sekmeleri vurgulanmış pencereyle ilgili ayrıntıları içerir.

İlerlemeler

Söz<windows.Window>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

insertCSS()

Söz &leq; MV2 Chrome 91 sürümünden itibaren kullanımdan kaldırıldı

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

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

CSS'yi bir sayfaya ekler. Bu yöntemle eklenen stiller scripting.removeCSS ile kaldırılabilir. Ayrıntılar için içerik komut dosyaları dokümanının programatik yerleştirme bölümüne bakın.

Parametreler

tabId

numara isteğe bağlı

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

InjectDetails

Eklenecek CSS metninin ayrıntıları. Kod veya dosya özelliği ayarlanmalıdır, ancak her ikisi de aynı anda ayarlanamaz.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<void>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

move()

Söz

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

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

Parametreler

tabIds

numara|sayı[]

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

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

Functions (isteğe bağlı)

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

İlerlemeler

Söz verme<Sekme|Sekme[]>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

query()

Söz

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

Belirtilen özelliklere sahip tüm sekmeleri veya herhangi bir özellik belirtilmediyse tüm sekmeleri alır.

Parametreler

queryInfo

nesne
- etkin
  
  boole isteğe bağlı
  
  Sekmelerin pencerelerinde etkin olup olmadığı.
- audible
  
  boole isteğe bağlı
  
  Chrome 45 ve sonraki sürü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 silinip silinemeyeceği.
- currentWindow
  
  boole isteğe bağlı
  
  Sekmelerin geçerli pencerede olup olmadığı.
- silindi
  
  boole isteğe bağlı
  
  Chrome 54 ve sonraki sürümler
  
  Sekmelerin silinip silinmeyeceği. Silinen sekme, içeriği bellekten kaldırılan, ancak sekme şeridinde görünmeye devam eden bir sekmedir. Tekrar etkinleştirildiğinde içeriği yeniden yüklenir.
- groupId
  
  numara isteğe bağlı
  
  Chrome 88 ve sonraki sürümler
  
  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 vurgulu olup olmadığı.
- indeks
  
  numara isteğe bağlı
  
  Sekmelerin pencereleri içindeki konumu.
- lastFocusedWindow
  
  boole isteğe bağlı
  
  Sekmelerin son odaklanılan pencerede olup olmadığı.
- ses kapatıldı
  
  boole isteğe bağlı
  
  Chrome 45 ve sonraki sürümler
  
  Sekmelerin sesinin kapatılıp kapatılmadığı.
- sabitlendi
  
  boole isteğe bağlı
  
  Sekmelerin sabitlenip sabitlenmediği.
- status
  
  TabStatus isteğe bağlı
  
  Sekme yükleme durumu.
- title
  
  string isteğe bağlı
  
  Sayfa başlıklarını bir kalıpla eşleştirin. Uzantının "tabs" izni yoksa bu özellik yoksayılır.
- url
  
  string|string[] optional
  
  Sekmeleri bir veya daha fazla URL kalıbıyla eşleştirin. Parça tanımlayıcılar eşleşmiyor. Uzantının "tabs" izni yoksa bu özellik yoksayılır.
- windowId
  
  numara isteğe bağlı
  
  Üst pencerenin kimliği veya geçerli pencere için windows.WINDOW_ID_CURRENT.
- windowType
  
  WindowType isteğe bağlı
  
  Sekmelerin bulunduğu pencerenin türü.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<Tab[]>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

reload()

Söz

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

Bir sekmeyi yeniden yükleyin.

Parametreler

tabId

numara isteğe bağlı

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

isteğe bağlı
- bypassCache
  
  boole isteğe bağlı
  
  Yerel önbelleğe almanın atlanıp atlanmayacağı. Varsayılan olarak false değerine ayarlanır.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<void>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

remove()

Söz

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

Bir veya daha fazla sekmeyi kapatır.

Parametreler

tabIds

numara|sayı[]

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

Functions (isteğe bağlı)

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

İlerlemeler

Promise<void>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

removeCSS()

Söz Chrome 87+ &leq; MV2 Chrome 91'den itibaren kullanımdan kaldırıldı

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Manifest V3'te scripting.removeCSS ile değiştirilmiştir.

Daha önce scripting.insertCSS çağrısıyla yerleştirilen bir sayfa CSS'sinden kaldırılır.

Parametreler

tabId

numara isteğe bağlı

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

DeleteInjectionDetails

Kaldırılacak CSS metninin ayrıntıları. Kod veya dosya özelliği ayarlanmalıdır, ancak her ikisi de aynı anda ayarlanamaz.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<void>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

sendMessage()

Söz

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

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

Parametreler

tabId

sayı
mesaj

Tümü

Gönderilecek ileti. Bu ileti, JSON öğesine uygun bir nesne olmalıdır.
seçenekler

isteğe bağlı
- documentId
  
  string isteğe bağlı
  
  Chrome 106 ve sonraki sürümler
  
  Sekmedeki tüm çerçeveler yerine documentId tarafından tanımlanan belirli bir dokümana ileti gönderin.
- frameId
  
  numara isteğe bağlı
  
  Sekmedeki tüm kareler yerine frameId tarafından tanımlanan belirli bir kareye mesaj gönderin.
geri çağırma

Functions (isteğe bağlı)

Chrome 99 ve sonraki sürümler

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

İlerlemeler

Söz<herhangi>

Chrome 99 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

sendRequest()

Söz &leq; MV2 Kullanımdan kaldırıldı

chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)

Lütfen runtime.sendMessage hesabını kullanın.

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

Parametreler

tabId

sayı
istek

Tümü
geri çağırma

Functions (isteğe bağlı)

Chrome 99 ve sonraki sürümler

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

İlerlemeler

Söz<herhangi>

Chrome 99 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setZoom()

Söz

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

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

Parametreler

tabId

numara isteğe bağlı

Yakınlaştırma yapılacak sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
zoomFactor

sayı

Yeni yakınlaştırma faktörü. 0 değeri, sekmeyi geçerli varsayılan yakınlaştırma faktörüne ayarlar. 0 değerinden büyük değerler, sekme için (muhtemelen varsayılan olmayan) bir yakınlaştırma faktörü belirtir.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<void>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

setZoomSettings()

Söz

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

Yakınlaştırma değişikliklerinin nasıl kullanılacağını tanımlayan, belirtilen bir sekme için yakınlaştırma ayarlarını belirler. Sekmeye gidildiğinde bu ayarlar varsayılanlara sıfırlanır.

Parametreler

tabId

numara isteğe bağlı

Yakınlaştırma ayarlarının değiştirileceği sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesidir.
zoomSettings

ZoomSettings

Yakınlaştırma değişikliklerinin nasıl ve hangi kapsamda işleneceğini tanımlar.
geri çağırma

Functions (isteğe bağlı)

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

İlerlemeler

Promise<void>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

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 gruplardan kaldırır. Boş hale gelen gruplar silinir.

Parametreler

tabIds

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

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

Functions (isteğe bağlı)

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

İlerlemeler

Promise<void>

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

update()

Söz

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

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

Parametreler

tabId

numara isteğe bağlı

Varsayılan olarak geçerli pencerenin seçili sekmesi kullanılır.
updateProperties

nesne
- etkin
  
  boole isteğe bağlı
  
  Sekmenin etkin olup olmayacağı. Pencerenin odaklanıp odaklanmamasını etkilemez (bkz. windows.update).
- autoDiscardable
  
  boole isteğe bağlı
  
  Chrome 54 ve sonraki sürümler
  
  Kaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak silinip silinmeyeceği.
- öne çıkarıldı
  
  boole isteğe bağlı
  
  Sekmeyi mevcut seçime ekler veya mevcut seçimden kaldırır.
- ses kapatıldı
  
  boole isteğe bağlı
  
  Chrome 45 ve sonraki sürümler
  
  Sekmenin sesinin kapatılıp kapatılmayacağı.
- openerTabId
  
  numara isteğe bağlı
  
  Bu sekmeyi açan sekmenin kimliği. Belirtilirse, açıcı sekmesi bu sekmeyle aynı pencerede olmalıdır.
- sabitlendi
  
  boole isteğe bağlı
  
  Sekmenin sabitlenip sabitlenmeyeceğini belirler.
- seçili
  
  boole isteğe bağlı
  
  Kullanımdan kaldırıldı
  
  Lütfen vurgulu özelliğini kullanın.
  Sekmenin seçili olup olmayacağı.
- url
  
  string isteğe bağlı
  
  Sekmenin gidilecek URL'si. JavaScript URL'leri desteklenmez. Bunun yerine scripting.executeScript kullanın.
geri çağırma

Functions (isteğe bağlı)

callback parametresi şu şekilde görünür:
```
(tab?: Tab)=>void
```
- 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çermiyor.

İlerlemeler

Vaat<Sekme|undefined>

Chrome 88 ve sonraki sürümler

Vaatler, Manifest V3 ve sonraki sürümlerde desteklenir ancak geriye dönük uyumluluk için geri çağırmalar sağlanır. Aynı işlev çağrısında ikisini birden kullanamazsınız. Vaat, geri çağırmaya iletilen aynı türle çözümlenir.

Etkinlikler

onActivated

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

Bir penceredeki etkin sekme değiştiğinde tetiklenir. Bu etkinlik tetiklendiğinde sekmenin URL'sinin ayarlanamayabileceğini unutmayın. Ancak bir URL ayarlandığında bildirim almak için onUpdated etkinliklerini dinleyebilirsiniz.

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(activeInfo: object)=>void
```
- activeInfo
  
  nesne
  - tabId
    
    sayı
    
    Etkin hale gelen sekmenin kimliği.
  - windowId
    
    sayı
    
    Etkin sekmenin içinde değiştiği pencerenin kimliği.

onActiveChanged

&leq; MV2 Kullanımdan kaldırıldı

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

Lütfen tabs.onActivated hesabını kullanın.

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

Parametreler

geri çağırma

işlev

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

onAttached

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

Sekme bir pencereye eklendiğinde (ör. pencereler arasında taşındığında) tetiklenir.

Parametreler

geri çağırma

işlev

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

onCreated

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

Bir sekme oluşturulduğunda tetiklenir. Bu etkinlik tetiklendiği sırada sekmenin URL'sinin ve sekme grubu üyeliğinin ayarlanamayabileceğini unutmayın. Ancak bir URL oluşturulduğunda veya sekme bir sekme grubuna eklendiğinde bildirim almak için onUpdated etkinliklerini dinleyebilirsiniz.

Parametreler

geri çağırma

işlev

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

onDetached

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

Sekme, pencereden ayrıldığında (örneğin, pencereler arasında taşındığında) tetiklenir.

Parametreler

geri çağırma

işlev

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

onHighlightChanged

&leq; MV2 Kullanımdan kaldırıldı

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

Lütfen tabs.onHighlighted hesabını kullanın.

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

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(selectInfo: object)=>void
```
- selectInfo
  
  nesne
  - tabIds
    
    numara[]
    
    Penceredeki vurgulanan tüm sekmeler.
  - windowId
    
    sayı
    
    Sekmeleri değişen pencere.

onHighlighted

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

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

Parametreler

geri çağırma

işlev

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

onMoved

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

Sekme bir pencere içinde taşındığında tetiklenir. Kullanıcının doğrudan taşıdığı sekmeyi temsil eden yalnızca bir taşıma etkinliği tetiklenir. Manuel olarak taşınan sekmeye yanıt olarak taşınması gereken diğer sekmeler için taşıma etkinlikleri tetiklenmez. Bir sekme pencereler arasında taşındığında bu etkinlik tetiklenmez. Ayrıntılar için bkz. tabs.onDetached.

Parametreler

geri çağırma

işlev

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

onRemoved

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

Bir sekme kapatıldığında tetiklenir.

Parametreler

geri çağırma

işlev

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

onReplaced

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

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

Parametreler

geri çağırma

işlev

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

onSelectionChanged

&leq; MV2 Kullanımdan kaldırıldı

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

Lütfen tabs.onActivated hesabını kullanın.

Bir pencerede seçili sekme değiştiğinde tetiklenir.

Parametreler

geri çağırma

işlev

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

onUpdated

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

Bir sekme güncellendiğinde tetiklenir.

Parametreler

geri çağırma

işlev

callback parametresi şu şekilde görünür:
```
(tabId: number,changeInfo: object,tab: Tab)=>void
```
- tabId
  
  sayı
- changeInfo
  
  nesne
  - audible
    
    boole isteğe bağlı
    
    Chrome 45 ve sonraki sürümler
    
    Sekmenin yeni duyulabilir 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
    
    string isteğe bağlı
    
    Sekmenin yeni favori simgesi URL'si.
  - groupId
    
    numara 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 yoksayılma durumu ve değişikliğin nedeni.
  - sabitlendi
    
    boole isteğe bağlı
    
    Sekmenin yeni sabitlenmiş durumu.
  - status
    
    TabStatus isteğe bağlı
    
    Sekmenin yükleme durumu.
  - title
    
    string isteğe bağlı
    
    Chrome 48 ve sonraki sürümler
    
    Sekmenin yeni başlığı.
  - url
    
    string 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