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'sini kullanın. Bu API'yi kullanarak tarayıcıda sekmeler oluşturabilir, bunları değiştirebilir ve yeniden düzenleyebilirsiniz.

Tabs API, sekmeleri değiştirme ve yönetme özelliklerinin yanı sıra sekmenin dilini algılayabilir, ekran görüntüsü alabilir ve sekmenin içerik komut dosyalarıyla iletişim kurabilir.

İzinler

Çoğu özellik için 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 etmesi gereken üç izin vardır.

"Sekmeler" izni

Bu izin, chrome.tabs ad alanına erişim vermez. Bunun yerine, tabs.query() işlevini tabs.Tab örneklerindeki dört hassas özellik (url, pendingUrl, title ve favIconUrl) için çağırma izni verir.

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

Ana makine izinleri

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

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

"activeTab" izni

activeTab, kullanıcı isteğine yanıt olarak geçerli sekme için geçici ana makine izni verir. Ana makine izinlerinin aksine, activeTab herhangi bir uyarı tetiklemez.

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

Kullanım alanları

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

Uzantı sayfasını yeni sekmede açma

Uzantılar için yaygın bir model, uzantı yüklendiğinde yeni sekmede bir oryantasyon sayfası açmaktır. Bunu nasıl yapacağınız aşağıdaki örnekte gösterilmektedir.

background.js:

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

Geçerli sekmeyi alma

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

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

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

Belirtilen sekmenin sesini kapatma

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

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

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

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

Bu örnekte, sürükleme işlemi devam ederken veya etmezken bir sekmenin nasıl taşınacağı gösterilmektedir. Bu örnekte chrome.tabs.move kullanılsa da sürükleme işlemi devam ederken sekmeleri değiştiren diğer aramalar 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 bir 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 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

dize isteğe bağlı

Sessize alma durumunu değiştiren uzantının kimliği. Uzantı, sessize alma durumunun en son değiştirilme nedeni değilse ayarlanmaz.
ses kapatıldı

boolean

Sekmenin sesi kapatılıp kapatılmadığı (ses çalmasının engellenip engellenmediği). Sekme, ses çalmamış veya şu anda ses çalmıyor olsa bile sessize alınmış olabilir. "Sessiz" ses göstergesinin gösterilip gösterilmediğine eşdeğerdir.
neden

MutedInfoReason isteğe bağlı

Sekmenin sessize alınma veya sessizden çıkarma nedeni. Sekmenin yoksayma durumu hiç değiştirilmediyse ayarlanmaz.

MutedInfoReason

Chrome 46 ve sonraki sürümler

Sessize alma durumunda değişikliğe neden olan bir etkinlik.

Enum

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

"capture"
Sekme yakalama başlatıldığı için sessiz durum değişikliği zorlandı.

"extension"
extensionId alanı tarafından tanımlanan bir uzantı, sessize alma durumunu ayarladı.

Tab

Özellikler

etkin

boolean

Sekmenin penceresinde etkin olup olmadığı. Pencerenin odaklanmış olduğu anlamına gelmez.
audible

boolean isteğe bağlı

Chrome 45 ve sonraki sürümler

Sekmenin son birkaç saniye içinde ses üretip üretmediği (ancak sekme sessize alınmışsa ses duyulmayabilir). "Konuşmacı sesi" göstergesinin gösterilip gösterilmediğine eşdeğerdir.
autoDiscardable

boolean

Chrome 54 veya daha yeni bir sürüm

Kaynaklar azaldığında tarayıcının sekmeyi otomatik olarak atıp atamayacağı.
silindi

boolean

Chrome 54 veya daha yeni bir sürüm

Sekmenin silinip silinmediği. Atılan sekme, içeriği bellekten kaldırılmış ancak sekme şeridinde görünmeye devam eden sekmedir. İçeriği, bir sonraki etkinleştirme işleminde yeniden yüklenir.
favIconUrl

dize isteğe bağlı

Sekmenin site simgesinin URL'si. Bu özellik yalnızca uzantının "tabs" izni varsa veya sayfa için ana makine izinleri varsa bulunur. Sekme yükleniyorsa boş bir dize de olabilir.
dondurulmuş

boolean

Chrome 132 veya daha yeni bir sürüm

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

sayı

Chrome 88 ve sonraki sürümler

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

number isteğe bağlı

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

boolean

Sekmenin vurgulanıp vurgulanmadığı.
id

number isteğe bağlı

Sekmenin kimliği. Sekme kimlikleri, tarayıcı oturumlarında benzersizdir. Bazı durumlarda bir sekmeye kimlik atanmayabilir. Örneğin, sessions API'si kullanılarak yabancı sekmeler sorgulanırken oturum kimliği mevcut olabilir. 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 penceresindeki sıfır tabanlı dizini.
lastAccessed

sayı

Chrome 121 ve sonraki sürümler

Sekmenin, penceresinde en son etkin hale geldiği zaman (sıfır zamanından itibaren geçen milisaniye sayısı).
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

number isteğe bağlı

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

dize isteğe bağlı

Chrome 79 veya daha yeni bir sürüm

Sekmenin, kaydedilmeden önce yönlendirildiği URL. Bu özellik yalnızca uzantının "tabs" izni varsa veya sayfa için ana makine izinleri varsa ve bekleyen bir gezinme işlemi varsa bulunur.
sabitlendi

boolean

Sekmenin sabitlenip sabitlenmediği
seçili

boolean

Kullanımdan kaldırıldı

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

dize isteğe bağlı

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

TabStatus isteğe bağlı

Sekmenin yükleme durumu.
title

dize isteğe bağlı

Sekmenin başlığı. Bu özellik yalnızca uzantının "tabs" izni varsa veya sayfa için ana makine izinleri varsa bulunur.
url

dize isteğe bağlı

Sekmenin ana çerçevesinin son kaydedilen URL'si. Bu özellik yalnızca uzantının "tabs" izni varsa veya sayfa için ana makine izinleri varsa bulunur. Sekme henüz kaydedilmediyse boş bir dize olabilir. Ayrıca Tab.pendingUrl başlıklı makaleyi inceleyin.
genişlik

number isteğe bağlı

Sekmenin piksel cinsinden genişliği.
windowId

sayı

Sekmeyi içeren pencerenin kimliği.

TabStatus

Chrome 44 veya daha yeni bir sürüm

Sekmenin yükleme durumu.

Enum

"unloaded"

"loading"

"complete"

WindowType

Chrome 44 veya daha yeni bir sürüm

Pencerenin türü.

Enum

"normal"

"popup"

"panel"

"app"

"devtools"

ZoomSettings

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

Özellikler

defaultZoomFactor

number isteğe bağlı

Chrome 43 veya daha yeni bir sürüm

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

ZoomSettingsMode isteğe bağlı

Yakınlaştırma değişikliklerinin nasıl işleneceğini tanımlar. Örneğin, sayfanın gerçek ölçeklendirilmesinden hangi öğe sorumludur? Varsayılan değer automatic'dır.
kapsam

ZoomSettingsScope isteğe bağlı

Yakınlaştırma değişikliklerinin sayfanın kaynağı için kalıcı olup olmayacağını veya yalnızca bu sekmede geçerli olup olmayacağını tanımlar. automatic modundayken varsayılan olarak per-origin, aksi takdirde per-tab olur.

ZoomSettingsMode

Chrome 44 veya daha yeni bir sürüm

Yakınlaştırma değişikliklerinin nasıl işleneceğini tanımlar. Örneğin, sayfanın gerçek ölçeklendirilmesinden hangi öğe sorumludur? Varsayılan değer automatic'dı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 gönderilmeye devam eder. Bu etkinliği dinlemek ve sayfayı manuel olarak ölçeklendirmek uzantının sorumluluğundadır. Bu modda per-origin yakınlaştırma desteklenmez. Bu nedenle, scope yakınlaştırma ayarı yoksayılır ve per-tab varsayılır.

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

ZoomSettingsScope

Chrome 44 veya daha yeni bir sürüm

Yakınlaştırma değişikliklerinin sayfanın kaynağı için kalıcı olup olmayacağını veya yalnızca bu sekmede geçerli olup olmayacağını tanımlar. automatic modundayken varsayılan olarak per-origin, aksi takdirde per-tab olur.

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 gidilen diğer tüm sekmeler de yakınlaştırılır. Ayrıca, per-origin yakınlaştırma değişiklikleri kaynakla birlikte kaydedilir. Bu nedenle, aynı kaynaktaki diğer sayfalara gidildiğinde tüm sayfalar aynı yakınlaştırma faktörüyle yakınlaştırılır. per-origin kapsamı yalnızca automatic modunda kullanılabilir.

"Sekme başına"
Yakınlaştırma değişiklikleri yalnızca bu sekmede geçerli olur ve diğer sekmelerdeki yakınlaştırma değişiklikleri bu sekmenin yakınlaştı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 veya daha yeni bir sürüm

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

Değer

TAB_ID_NONE

Chrome 46 ve sonraki sürümler

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

Değer

-1

TAB_INDEX_NONE

Chrome 123 veya daha yeni bir sürüm

Bir tab_strip'te sekme dizininin olmadığını gösteren bir dizin.

Değer

-1

Yöntemler

captureVisibleTab()

chrome.tabs.captureVisibleTab(
  windowId?: number,
  options?: ImageDetails,
): Promise<string>

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

Parametreler

windowId

number isteğe bağlı

Hedef pencere. Varsayılan olarak geçerli pencere seçilir.
seçenekler

ImageDetails isteğe bağlı

İadeler

Promise<string>

Chrome 88 ve sonraki sürümler

connect()

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

Belirtilen sekmedeki içerik komut dosyalarına bağlanır. runtime.onConnect etkinliği, mevcut uzantı için belirtilen sekmede çalışan her içerik komut dosyasında tetiklenir. Daha fazla bilgi için Content Script Messaging (İçerik Komut Dosyası Mesajlaşması) başlıklı makaleyi inceleyin.

Parametreler

tabId

sayı
connectInfo

object isteğe bağlı
- documentId
  
  dize isteğe bağlı
  
  Chrome 106 veya daha yeni bir sürüm
  
  Sekmedeki tüm çerçeveler yerine documentId ile tanımlanan belirli bir dokümana bağlantı noktası açın.
- frameId
  
  number isteğe bağlı
  
  Sekmedeki tüm çerçeveler yerine frameId ile tanımlanan belirli bir çerçeveye bağlantı noktası açın.
- ad
  
  dize isteğe bağlı
  
  Bağlantı etkinliğini dinleyen içerik komut dosyaları için onConnect'e iletilir.

İadeler

runtime.Port

Belirtilen sekmede çalışan içerik komut dosyalarıyla iletişim kurmak için kullanılabilecek bir bağlantı noktası. Sekme kapatılırsa veya mevcut değilse bağlantı noktasının runtime.Port etkinliği tetiklenir.

create()

chrome.tabs.create(
  createProperties: object,
): Promise<Tab>

Yeni bir sekme oluşturur.

Parametreler

createProperties

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

İadeler

Promise<Tab>

Chrome 88 ve sonraki sürümler

detectLanguage()

chrome.tabs.detectLanguage(
  tabId?: number,
): Promise<string>

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

Parametreler

tabId

number isteğe bağlı

Varsayılan olarak geçerli pencerenin etkin sekmesi gösterilir.

İadeler

Promise<string>

Chrome 88 ve sonraki sürümler

discard()

Chrome 54 veya daha yeni bir sürüm

chrome.tabs.discard(
  tabId?: number,
): Promise<Tab | undefined>

Sekmeyi bellekten kaldırır. Kaldırılan sekmeler, sekme şeridinde görünmeye devam eder ve etkinleştirildiğinde yeniden yüklenir.

Parametreler

tabId

number isteğe bağlı

Atılacak sekmenin kimliği. Belirtilirse sekme etkin olmadığı veya zaten atılmadığı sürece atılır. Atlanırsa tarayıcı, en az önemli sekmeyi siler. Bu işlem, atılabilir sekme yoksa başarısız olabilir.

İadeler

Promise<Tab | undefined>

Chrome 88 ve sonraki sürümler

duplicate()

chrome.tabs.duplicate(
  tabId: number,
): Promise<Tab | undefined>

Sekmeyi kopyalar.

Parametreler

tabId

sayı

Kopyalanacak sekmenin kimliği.

İadeler

Promise<Tab | undefined>

Chrome 88 ve sonraki sürümler

get()

chrome.tabs.get(
  tabId: number,
): Promise<Tab>

Belirtilen sekme hakkındaki ayrıntıları alır.

Parametreler

tabId

sayı

İadeler

Promise<Tab>

Chrome 88 ve sonraki sürümler

getCurrent()

chrome.tabs.getCurrent(): Promise<Tab | undefined>

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

İadeler

Promise<Tab | undefined>

Chrome 88 ve sonraki sürümler

getZoom()

chrome.tabs.getZoom(
  tabId?: number,
): Promise<number>

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

Parametreler

tabId

number isteğe bağlı

Geçerli yakınlaştırma faktörünün alınacağı sekmenin kimliği. Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.

İadeler

Promise<number>

Chrome 88 ve sonraki sürümler

getZoomSettings()

chrome.tabs.getZoomSettings(
  tabId?: number,
): Promise<ZoomSettings>

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

Parametreler

tabId

number isteğe bağlı

Mevcut yakınlaştırma ayarlarının alınacağı sekmenin kimliği. Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.

İadeler

Promise<ZoomSettings>

Chrome 88 ve sonraki sürümler

goBack()

Chrome 72 veya daha yeni bir sürüm

chrome.tabs.goBack(
  tabId?: number,
): Promise<void>

Varsa önceki sayfaya dönün.

Parametreler

tabId

number isteğe bağlı

Geri dönülecek sekmenin kimliği. Varsayılan olarak geçerli pencerenin seçili sekmesi kullanılır.

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

goForward()

Chrome 72 veya daha yeni bir sürüm

chrome.tabs.goForward(
  tabId?: number,
): Promise<void>

Varsa sonraki sayfaya gitmek için kullanılır.

Parametreler

tabId

number isteğe bağlı

İleri gitmek için sekmenin kimliği; varsayılan olarak geçerli pencerenin seçili sekmesi kullanılır.

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

group()

Chrome 88 ve sonraki sürümler

chrome.tabs.group(
  options: object,
): Promise<number>

Belirtilen gruba bir veya daha fazla sekme ekler. Grup belirtilmemişse verilen sekmeleri yeni oluşturulan bir gruba ekler.

Parametreler

seçenekler

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

İadeler

Promise<number>

highlight()

chrome.tabs.highlight(
  highlightInfo: object,
): Promise<windows.Window>

Belirtilen sekmeleri vurgular ve grubun ilkine odaklanır. Belirtilen sekme şu anda etkinse hiçbir şey yapmıyormuş gibi görünür.

Parametreler

highlightInfo

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

İadeler

Promise<windows.Window>

Chrome 88 ve sonraki sürümler

move()

chrome.tabs.move(
  tabIds: number | number[],
  moveProperties: object,
): Promise<Tab | Tab[]>

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

Parametreler

tabIds

number | number[]

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

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

İadeler

Promise<Tab | Tab[]>

Chrome 88 ve sonraki sürümler

query()

chrome.tabs.query(
  queryInfo: object,
): Promise<Tab[]>

Belirtilen özelliklere sahip tüm sekmeleri veya özellik belirtilmemişse tüm sekmeleri alır.

Parametreler

queryInfo

nesne
- etkin
  
  boolean isteğe bağlı
  
  Sekmelerin pencerelerinde etkin olup olmadığı.
- audible
  
  boolean isteğe bağlı
  
  Chrome 45 ve sonraki sürümler
  
  Sekmelerin sesli olup olmadığı.
- autoDiscardable
  
  boolean isteğe bağlı
  
  Chrome 54 veya daha yeni bir sürüm
  
  Kaynaklar azaldığında sekmelerin tarayıcı tarafından otomatik olarak atılıp atılamayacağı.
- currentWindow
  
  boolean isteğe bağlı
  
  Sekmelerin geçerli pencerede olup olmadığı.
- silindi
  
  boolean isteğe bağlı
  
  Chrome 54 veya daha yeni bir sürüm
  
  Sekmelerin silinip silinmeyeceği. Atılan sekme, içeriği bellekten kaldırılmış ancak sekme şeridinde görünmeye devam eden sekmedir. İçeriği, bir sonraki etkinleştirme işleminde yeniden yüklenir.
- dondurulmuş
  
  boolean isteğe bağlı
  
  Chrome 132 veya daha yeni bir sürüm
  
  Sekmelerin dondurulup dondurulmadığı Dondurulmuş bir sekme, etkinlik işleyiciler veya zamanlayıcılar da dahil olmak üzere görevleri yürütemez. Sekme şeridinde görünür ve içeriği belleğe yüklenir. Etkinleştirildiğinde dondurulması kaldırılır.
- groupId
  
  number isteğe bağlı
  
  Chrome 88 ve sonraki sürümler
  
  Sekmelerin bulunduğu grubun kimliği veya gruplandırılmamış sekmeler için tabGroups.TAB_GROUP_ID_NONE.
- öne çıkarıldı
  
  boolean isteğe bağlı
  
  Sekmelerin vurgulanıp vurgulanmayacağı.
- indeks
  
  number isteğe bağlı
  
  Sekmelerin pencerelerindeki konumu.
- lastFocusedWindow
  
  boolean isteğe bağlı
  
  Sekmelerin en son odaklanılan pencerede olup olmadığı.
- ses kapatıldı
  
  boolean isteğe bağlı
  
  Chrome 45 ve sonraki sürümler
  
  Sekmelerin sesi kapatılıp kapatılmadığı.
- sabitlendi
  
  boolean isteğe bağlı
  
  Sekmelerin sabitlenip sabitlenmediği
- splitViewId
  
  number isteğe bağlı
  
  Chrome 140 veya daha yeni bir sürüm
  
  Sekmelerin bulunduğu bölünmüş görünümün kimliği veya bölünmüş görünümde olmayan sekmeler için tabs.SPLIT_VIEW_ID_NONE.
- 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 veya sayfa için ana makine izinleri yoksa bu özellik yok sayı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 veya sayfa için ana makine izinleri yoksa bu özellik yok sayılır.
- windowId
  
  number 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ü.

İadeler

Promise<Tab[]>

Chrome 88 ve sonraki sürümler

reload()

chrome.tabs.reload(
  tabId?: number,
  reloadProperties?: object,
): Promise<void>

Sekmeyi yeniden yükleyin.

Parametreler

tabId

number isteğe bağlı

Yeniden yüklenecek sekmenin kimliği. Varsayılan olarak geçerli pencerenin seçili sekmesi kullanılır.
reloadProperties

object isteğe bağlı
- bypassCache
  
  boolean isteğe bağlı
  
  Yerel önbelleğin atlanıp atlanmayacağı. Varsayılan olarak false değerine ayarlanır.

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

remove()

chrome.tabs.remove(
  tabIds: number | number[],
): Promise<void>

Bir veya daha fazla sekmeyi kapatır.

Parametreler

tabIds

number | number[]

Kapatılacak sekme kimliği veya sekme kimliklerinin listesi.

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

sendMessage()

chrome.tabs.sendMessage(
  tabId: number,
  message: any,
  options?: object,
): Promise<any>

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

Parametreler

tabId

sayı
mesaj

herhangi

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

object isteğe bağlı
- documentId
  
  dize isteğe bağlı
  
  Chrome 106 veya daha yeni bir sürüm
  
  Sekmedeki tüm kareler yerine documentId ile tanımlanan belirli bir dokümana mesaj gönderme
- frameId
  
  number isteğe bağlı
  
  Sekmedeki tüm kareler yerine frameId ile tanımlanan belirli bir kareye mesaj gönderme.

İadeler

Promise<any>

Chrome 99 veya daha yeni bir sürüm

setZoom()

chrome.tabs.setZoom(
  tabId?: number,
  zoomFactor: number,
): Promise<void>

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

Parametreler

tabId

number isteğe bağlı

Yakınlaştırılacak sekmenin kimliği. Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılı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 (varsayılan olmayan) bir yakınlaştırma faktörü belirtir.

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

setZoomSettings()

chrome.tabs.setZoomSettings(
  tabId?: number,
  zoomSettings: ZoomSettings,
): Promise<void>

Belirli bir sekmenin yakınlaştırma ayarlarını belirler. Bu ayarlar, yakınlaştırma değişikliklerinin nasıl işleneceğini tanımlar. Bu ayarlar, sekmede gezinildiğinde varsayılan değerlere sıfırlanır.

Parametreler

tabId

number 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 sekmesi kullanılır.
zoomSettings

ZoomSettings

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

İadeler

Promise<void>

Chrome 88 ve sonraki sürümler

ungroup()

Chrome 88 ve sonraki sürümler

chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
): Promise<void>

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

Parametreler

tabIds

number | [number, ...number[]]

İlgili gruplardan kaldırılacak sekme kimliği veya sekme kimliklerinin listesi.

İadeler

Promise<void>

update()

chrome.tabs.update(
  tabId?: number,
  updateProperties: object,
): Promise<Tab | undefined>

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

Parametreler

tabId

number isteğe bağlı

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

nesne
- etkin
  
  boolean isteğe bağlı
  
  Sekmenin etkin olup olmayacağı. Pencerenin odaklanıp odaklanmadığını etkilemez (windows.update bölümüne bakın).
- autoDiscardable
  
  boolean isteğe bağlı
  
  Chrome 54 veya daha yeni bir sürüm
  
  Kaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak atılıp atılmayacağı.
- öne çıkarıldı
  
  boolean isteğe bağlı
  
  Sekmeyi mevcut seçime ekler veya mevcut seçimden kaldırır.
- ses kapatıldı
  
  boolean isteğe bağlı
  
  Chrome 45 ve sonraki sürümler
  
  Sekmenin sesi kapatılıp kapatılmayacağı.
- openerTabId
  
  number isteğe bağlı
  
  Bu sekmeyi açan sekmenin kimliği. Belirtilirse açıcı sekme, bu sekmeyle aynı pencerede olmalıdır.
- sabitlendi
  
  boolean isteğe bağlı
  
  Sekmenin sabitlenip sabitlenmeyeceği.
- seçili
  
  boolean isteğe bağlı
  
  Kullanımdan kaldırıldı
  
  Lütfen vurgulanmış seçeneğini kullanın.
  Sekmenin seçilip seçilmeyeceği.
- url
  
  dize isteğe bağlı
  
  Sekmenin yönlendirileceği URL. JavaScript URL'leri desteklenmez. Bunun yerine scripting.executeScript kullanın.

İadeler

Promise<Tab | undefined>

Chrome 88 ve sonraki sürümler

Etkinlikler

onActivated

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

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

Parametreler

callback

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 değiştiği pencerenin kimliği.

onAttached

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

Bir sekme bir pencereye eklendiğinde (ör. pencereler arasında taşındığı için) tetiklenir.

Parametreler

callback

işlev

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

onCreated

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

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

Parametreler

callback

işlev

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

onDetached

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

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

Parametreler

callback

işlev

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

onHighlighted

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

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

Parametreler

callback

işlev

callback parametresi şu şekilde görünür:
```
(highlightInfo: object) => void
```
- highlightInfo
  
  nesne
  - tabIds
    
    number[]
    
    Penceredeki tüm vurgulanmış 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. Taşıma etkinlikleri, manuel olarak taşınan sekmeye yanıt olarak taşınması gereken diğer sekmeler için tetiklenmez. Bu etkinlik, bir sekme pencereler arasında taşındığında tetiklenmez. Ayrıntılar için tabs.onDetached bölümüne bakın.

Parametreler

callback

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

callback

işlev

callback parametresi şu şekilde görünür:
```
(tabId: number, removeInfo: object) => void
```
- tabId
  
  sayı
- removeInfo
  
  nesne
  - isWindowClosing
    
    boolean
    
    Üst penceresi kapatıldığı 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,
)

Önceden oluşturma veya anında yükleme nedeniyle bir sekme başka bir sekmeyle değiştirildiğinde tetiklenir.

Parametreler

callback

işlev

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

onUpdated

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

Bir sekme güncellendiğinde tetiklenir.

Parametreler

callback

işlev

callback parametresi şu şekilde görünür:
```
(tabId: number, changeInfo: object, tab: Tab) => void
```
- tabId
  
  sayı
- changeInfo
  
  nesne
  - audible
    
    boolean isteğe bağlı
    
    Chrome 45 ve sonraki sürümler
    
    Sekmenin yeni sesli durumu.
  - autoDiscardable
    
    boolean isteğe bağlı
    
    Chrome 54 veya daha yeni bir sürüm
    
    Sekmenin yeni otomatik olarak silinebilir durumu.
  - silindi
    
    boolean isteğe bağlı
    
    Chrome 54 veya daha yeni bir sürüm
    
    Sekmenin yeni silinmiş durumu.
  - favIconUrl
    
    dize isteğe bağlı
    
    Sekmenin yeni site simgesi URL'si.
  - dondurulmuş
    
    boolean isteğe bağlı
    
    Chrome 132 veya daha yeni bir sürüm
    
    Sekmenin yeni dondurulmuş durumu.
  - groupId
    
    number isteğe bağlı
    
    Chrome 88 ve sonraki sürümler
    
    Sekmenin yeni grubu.
  - mutedInfo
    
    MutedInfo isteğe bağlı
    
    Chrome 46 ve sonraki sürümler
    
    Sekmenin yeni sessize alınma durumu ve değişikliğin nedeni.
  - sabitlendi
    
    boolean isteğe bağlı
    
    Sekmenin yeni sabitlenmiş durumu.
  - splitViewId
    
    number isteğe bağlı
    
    Chrome 140 veya daha yeni bir sürüm
    
    Sekmenin yeni bölünmüş görünümü.
  - durum
    
    TabStatus isteğe bağlı
    
    Sekmenin yükleme durumu.
  - title
    
    dize isteğe bağlı
    
    Chrome 48 veya daha yeni bir sürüm
    
    Sekmenin yeni başlığı.
  - url
    
    dize isteğe bağlı
    
    Değişmişse sekmenin URL'si.
- sekmesinden
  
  Sekme

onZoomChange

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

Bir sekme yakınlaştırıldığında tetiklenir.

Parametreler

callback

işlev

callback parametresi şu şekilde görünür:
```
(ZoomChangeInfo: object) => void
```
- ZoomChangeInfo
  
  nesne
  - newZoomFactor
    
    sayı
  - oldZoomFactor
    
    sayı
  - tabId
    
    sayı
  - zoomSettings
    
    ZoomSettings

chrome.tabs Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Açıklama

İzinler

Kullanım alanları

Uzantı sayfasını yeni sekmede açma

Geçerli sekmeyi alma

Belirtilen sekmenin sesini kapatma

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

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

Uzantı örnekleri

Türler

MutedInfo

Özellikler

MutedInfoReason

Enum

Tab

Özellikler

TabStatus

Enum

WindowType

Enum

ZoomSettings

Özellikler

ZoomSettingsMode

Enum

ZoomSettingsScope

Enum

Özellikler

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Değer

TAB_ID_NONE

Değer

TAB_INDEX_NONE

Değer

Yöntemler

captureVisibleTab()

Parametreler

İadeler

connect()

Parametreler

İadeler

create()

Parametreler

İadeler

detectLanguage()

Parametreler

İadeler

discard()

Parametreler

İadeler

duplicate()

Parametreler

İadeler

get()

Parametreler

İadeler

getCurrent()

İadeler

getZoom()

Parametreler

İadeler

getZoomSettings()

Parametreler

İadeler

goBack()

Parametreler

İadeler

goForward()

Parametreler

İadeler

group()

Parametreler

İadeler

highlight()

Parametreler

İadeler

move()

Parametreler

İadeler

query()

chrome.tabs