chrome.tabs

Açıklama

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

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

İzinler

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

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

"Sekmeler" izni

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

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

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

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

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

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

Kullanım alanları

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

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

Uzantılarda sık karşılaşılan bir durum, uzantı yüklendiğinde yeni bir sekmede ilk katılım sayfasının açılmasıdır. Aşağıdaki örnekte bunun nasıl yapılacağı gösterilmektedir.

background.js:

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

Geçerli sekmeyi alma

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

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


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

Belirtilen sekmenin sesini kapatma

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

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


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

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

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

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

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


  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

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

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

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

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

Uzantı örnekleri

Daha fazla Sekmeler API'si uzantısı demosu için aşağıdakilerden birini inceleyin:

Türler

MutedInfo

Chrome 46 ve sonraki sürümler

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

Özellikler

  • extensionId

    dize isteğe bağlı

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

  • ses kapatıldı

    boolean

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

  • neden

    MutedInfoReason isteğe bağlı

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

MutedInfoReason

Chrome 46 ve sonraki sürümler

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

Enum

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

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

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

Tab

Özellikler

  • etkin

    boolean

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

  • audible

    boole isteğe bağlı

    Chrome 45 ve sonraki sürümler

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

  • autoDiscardable

    boolean

    Chrome 54 ve sonraki sürümler

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

  • silindi

    boolean

    Chrome 54 ve sonraki sürümler

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

  • favIconUrl

    dize isteğe bağlı

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

  • dondurulmuş

    boolean

    Beklemede

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

  • groupId

    sayı

    Chrome 88 ve sonraki sürümler

    Sekmenin ait olduğu grubun kimliği.

  • yükseklik

    number isteğe bağlı

    Sekmenin piksel cinsinden yüksekliği.

  • öne çıkarıldı

    boolean

    Sekmenin vurgulanıp vurgulanmadığı.

  • id

    number isteğe bağlı

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

  • gizli

    boolean

    Sekmenin gizli pencerede olup olmadığı.

  • indeks

    sayı

    Sekmenin penceresindeki sıfır tabanlı dizini.

  • lastAccessed

    sayı

    Chrome 121 ve sonraki sürümler

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

  • mutedInfo

    MutedInfo isteğe bağlı

    Chrome 46 ve sonraki sürümler

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

  • openerTabId

    number isteğe bağlı

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

  • pendingUrl

    dize isteğe bağlı

    Chrome 79 ve sonraki sürümler

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

  • sabitlendi

    boolean

    Sekmenin sabitlenmiş olup olmadığı.

  • seçildi

    boolean

    Kullanımdan kaldırıldı

    Lütfen tabs.Tab.highlighted kullanın.

    Sekmenin seçili olup olmadığı.

  • sessionId

    dize isteğe bağlı

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

  • durum

    TabStatus isteğe bağlı

    Sekmenin yükleme durumu.

  • title

    dize isteğe bağlı

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

  • url

    dize isteğe bağlı

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

  • genişlik

    number isteğe bağlı

    Sekmenin piksel cinsinden genişliği.

  • windowId

    sayı

    Sekmeyi içeren pencerenin kimliği.

TabStatus

Chrome 44 ve sonraki sürümler

Sekmenin yükleme durumu.

Enum

"unloaded"

"loading"

"complete"

WindowType

Chrome 44 ve sonraki sürümler

Pencerenin türü.

Enum

"normal"

"popup"

"panel"

"app"

"devtools"

ZoomSettings

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

Özellikler

  • defaultZoomFactor

    number isteğe bağlı

    Chrome 43 ve sonraki sürümler

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

  • mod

    ZoomSettingsMode isteğe bağlı

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

  • kapsam

    ZoomSettingsScope isteğe bağlı

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

ZoomSettingsMode

Chrome 44 ve sonraki sürümler

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

Enum

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

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

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

ZoomSettingsScope

Chrome 44 ve sonraki sürümler

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

Enum

"per-origin"
Yakınlaştırma değişiklikleri, yakınlaştırılmış sayfanın kaynağında kalır. Yani, aynı kaynağa yönlendirilen diğer tüm sekmeler de yakınlaştırılır. Ayrıca, per-origin yakınlaştırma değişiklikleri kaynakla birlikte kaydedilir. Bu nedenle, aynı kaynaktaki diğer sayfalara giderken bunların tümü aynı yakınlaştırma faktörüne yakınlaştırılır. per-origin kapsamı yalnızca automatic modunda kullanılabilir.

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

Özellikler

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 ve üzeri sürümler

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

Değer

2

TAB_ID_NONE

Chrome 46 ve sonraki sürümler

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

Değer

-1

TAB_INDEX_NONE

Chrome 123 ve üzeri sürümler

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

Değer

-1

Yöntemler

captureVisibleTab()

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

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

Parametreler

  • windowId

    number isteğe bağlı

    Hedef pencere. Varsayılan olarak mevcut pencere kullanılır.

  • seçenekler

    ImageDetails isteğe bağlı

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (dataUrl: string) => void

    • dataUrl

      dize

      Yakalanan sekmenin görünür alanının resmini kodlayan bir veri URL'si. Görüntülemek için bir HTML img öğesinin "src" özelliğine atanabilir.

İadeler

  • Promise<string>

    Chrome 88 ve sonraki sürümler

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

connect()

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

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

Parametreler

  • tabId

    sayı

  • connectInfo

    nesne isteğe bağlı

    • documentId

      dize isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Sekmedeki tüm çerçeveler yerine documentId ile tanımlanan belirli bir doküman için bir bağlantı noktası açın.

    • frameId

      number isteğe bağlı

      Sekmedeki tüm kareler yerine frameId ile tanımlanan belirli bir kare için bir bağlantı noktası açın.

    • ad

      dize isteğe bağlı

      Bağlantı etkinliğini dinleyen içerik komut dosyaları için onConnect işlevine iletilir.

İadeler

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

create()

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

Yeni bir sekme oluşturur.

Parametreler

  • createProperties

    nesne

    • etkin

      boole isteğe bağlı

      Sekmenin pencerede etkin sekme olup olmayacağı. Pencerenin odaklanıp odaklanmadığını etkilemez (windows.update bölümüne bakın). Varsayılan olarak true değerini alır.

    • indeks

      number isteğe bağlı

      Sekmenin pencerede alması gereken konum. Sağlanan değer, sıfır ile penceredeki sekme sayısı arasında sınırlandırılır.

    • openerTabId

      number isteğe bağlı

      Bu sekmeyi açan sekmenin kimliği. Belirtilirse açan sekme, yeni oluşturulan sekmeyle aynı pencerede olmalıdır.

    • sabitlendi

      boole isteğe bağlı

      Sekmenin sabitlenip sabitlenmeyeceği. Varsayılan olarak false değerine ayarlanır.

    • seçildi

      boole isteğe bağlı

      Kullanımdan kaldırıldı

      Lütfen etkin seçeneğini kullanın.

      Sekmenin, pencerede seçili sekme olup olmayacağı. Varsayılan olarak true değerine ayarlanır.

    • url

      dize isteğe bağlı

      Sekmede ilk gidilecek URL. Tam nitelikli URL'ler bir şema (ör. "www.google.com" değil, "http://www.google.com"). Göreli URL'ler, uzantıdaki geçerli sayfaya görelidir. Varsayılan olarak Yeni Sekme sayfası kullanılır.

    • windowId

      number isteğe bağlı

      Yeni sekmenin oluşturulacağı pencere. Varsayılan olarak mevcut pencere kullanılır.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (tab: Tab) => void

    • sekmesinden

      Sekme

      Oluşturulan sekme.

İadeler

  • Promise<Tab>

    Chrome 88 ve sonraki sürümler

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

detectLanguage()

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

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

Parametreler

  • tabId

    number isteğe bağlı

    Varsayılan olarak geçerli pencerenin etkin sekmesidir.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (language: string) => void

    • language

      dize

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

İadeler

  • Promise<string>

    Chrome 88 ve sonraki sürümler

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

discard()

Promise Chrome 54 ve üzeri sürümler 
chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (tab?: Tab) => void

    • sekmesinden

      Sekme isteğe bağlı

      Silinen sekme (başarılı bir şekilde silindiyse); aksi takdirde tanımlanmaz.

İadeler

  • Promise<Tab | undefined>

    Chrome 88 ve sonraki sürümler

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

duplicate()

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

Sekmeyi kopyalar.

Parametreler

  • tabId

    sayı

    Kopyalanacak sekmenin kimliği.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (tab?: Tab) => void

    • sekmesinden

      Sekme isteğe bağlı

      Kopyalanan sekmeyle ilgili ayrıntılar. "tabs" izni istenmemişse tabs.Tab nesnesi url, pendingUrl, title ve favIconUrl içermez.

İadeler

  • Promise<Tab | undefined>

    Chrome 88 ve sonraki sürümler

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

executeScript()

Promise &leq; MV2 Chrome 91'den beri kullanımdan kaldırıldı
chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • ayrıntılar

    InjectDetails

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result?: any[]) => void

    • sonuç

      any[] isteğe bağlı

      Her enjekte edilen karede komut dosyasının sonucu.

İadeler

  • Promise<any[] | undefined>

    Chrome 88 ve sonraki sürümler

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

get()

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

Belirtilen sekmeyle ilgili ayrıntıları alır.

Parametreler

  • tabId

    sayı

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (tab: Tab) => void

İadeler

  • Promise<Tab>

    Chrome 88 ve sonraki sürümler

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

getAllInWindow()

Promise &leq; MV2 Desteği sonlandırıldı
chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

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

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

Parametreler

  • windowId

    number isteğe bağlı

    Varsayılan olarak mevcut pencere kullanılır.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (tabs: Tab[]) => void

İadeler

  • Promise<Tab[]>

    Chrome 88 ve sonraki sürümler

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

getCurrent()

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

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

Parametreler

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (tab?: Tab) => void

    • sekmesinden

      Sekme isteğe bağlı

İadeler

  • Promise<Tab | undefined>

    Chrome 88 ve sonraki sürümler

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

getSelected()

Promise &leq; MV2 Desteği sonlandırıldı
chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

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

Belirtilen pencerede seçili olan sekmeyi alır.

Parametreler

  • windowId

    number isteğe bağlı

    Varsayılan olarak mevcut pencere kullanılır.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (tab: Tab) => void

İadeler

  • Promise<Tab>

    Chrome 88 ve sonraki sürümler

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

getZoom()

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (zoomFactor: number) => void

    • zoomFactor

      sayı

      Sekmenin mevcut yakınlaştırma faktörü.

İadeler

  • Promise<number>

    Chrome 88 ve sonraki sürümler

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

getZoomSettings()

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (zoomSettings: ZoomSettings) => void

    • zoomSettings

      ZoomSettings

      Sekmenin mevcut yakınlaştırma ayarları.

İadeler

  • Promise<ZoomSettings>

    Chrome 88 ve sonraki sürümler

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

goBack()

Promise Chrome 72 ve sonraki sürümler 
chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

Varsa önceki sayfaya dönün.

Parametreler

  • tabId

    number isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

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

goForward()

Promise Chrome 72 ve sonraki sürümler 
chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

Varsa sonraki sayfaya gidin.

Parametreler

  • tabId

    number isteğe bağlı

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

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

group()

Promise Chrome 88 ve sonraki sürümler 
chrome.tabs.group(
  options: object,
  callback?: function,
)

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

Parametreler

  • seçenekler

    nesne

    • createProperties

      nesne isteğe bağlı

      Grup oluşturma yapılandırmaları. groupId zaten belirtilmişse kullanılamaz.

      • windowId

        number isteğe bağlı

        Yeni grubun penceresi. Varsayılan olarak geçerli pencere kullanılır.

    • groupId

      number isteğe bağlı

      Sekmelerin ekleneceği grubun kimliği. Belirtilmemişse yeni bir grup oluşturulur.

    • tabIds

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

      Belirtilen gruba eklenecek sekme kimliği veya sekme kimlikleri listesi.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (groupId: number) => void

    • groupId

      sayı

      Sekmelerin eklendiği grubun kimliği.

İadeler

  • Promise<number>

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

highlight()

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

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

Parametreler

  • highlightInfo

    nesne

    • sekmeler

      sayı | sayı[]

      Vurgulanacak bir veya daha fazla sekme dizini.

    • windowId

      number isteğe bağlı

      Sekmeleri içeren pencere.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (window: Window) => void

    • pencere

      Pencere

      Sekmelerinin vurgulandığı pencereyle ilgili ayrıntıları içerir.

İadeler

  • Promise<windows.Window>

    Chrome 88 ve sonraki sürümler

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

insertCSS()

Promise &leq; MV2 Chrome 91'den beri kullanımdan kaldırıldı
chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

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

Sayfaya CSS ekler. Bu yöntemle eklenen stiller scripting.removeCSS ile kaldırılabilir. Ayrıntılar için içerik komut dosyaları dokümanının programlı ekleme bölümüne bakın.

Parametreler

  • tabId

    number isteğe bağlı

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

  • ayrıntılar

    InjectDetails

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

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

move()

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

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

Parametreler

  • tabIds

    sayı | sayı[]

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

  • moveProperties

    nesne

    • indeks

      sayı

      Pencerenin taşınacağı konum. Sekmeyi pencerenin sonuna yerleştirmek için -1 simgesini kullanın.

    • windowId

      number isteğe bağlı

      Varsayılan olarak sekmenin şu anda bulunduğu penceredir.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (tabs: Tab | Tab[]) => void

    • sekmeler

      Sekme | Sekme[]

      Taşınan sekmelerle ilgili ayrıntılar.

İadeler

  • Promise<Tab | Tab[]>

    Chrome 88 ve sonraki sürümler

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

query()

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

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

Parametreler

  • queryInfo

    nesne

    • etkin

      boole isteğe bağlı

      Sekmelerin pencerelerinde etkin olup olmadığı.

    • audible

      boole isteğe bağlı

      Chrome 45 ve sonraki sürümler

      Sekmelerin sesli olup olmadığı.

    • autoDiscardable

      boole isteğe bağlı

      Chrome 54 ve sonraki sürümler

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

    • currentWindow

      boole isteğe bağlı

      Sekmelerin geçerli pencerede olup olmadığı.

    • silindi

      boole isteğe bağlı

      Chrome 54 ve sonraki sürümler

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

    • dondurulmuş

      boole isteğe bağlı

      Beklemede

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

    • groupId

      number isteğe bağlı

      Chrome 88 ve sonraki sürümler

      Sekmelerin bulunduğu grubun kimliği veya gruplandırılmamış sekmeler için tabGroups.TAB_GROUP_ID_NONE.

    • öne çıkarıldı

      boole isteğe bağlı

      Sekmelerin vurgulanıp vurgulanmayacağı.

    • indeks

      number isteğe bağlı

      Sekmelerin pencerelerindeki konumu.

    • lastFocusedWindow

      boole isteğe bağlı

      Sekmelerin, odaklanan son pencerede olup olmadığı.

    • ses kapatıldı

      boole isteğe bağlı

      Chrome 45 ve sonraki sürümler

      Sekmelerin sessiz olup olmadığı.

    • sabitlendi

      boole isteğe bağlı

      Sekmelerin sabitlenip sabitlenmediği.

    • durum

      TabStatus isteğe bağlı

      Sekme yükleme durumu.

    • title

      dize isteğe bağlı

      Sayfa başlıklarını bir kalıpla eşleştirme Uzantı "tabs" iznine sahip değilse bu özellik yoksayılır.

    • url

      dize | dize[] isteğe bağlı

      Sekmeleri bir veya daha fazla URL kalıbıyla eşleştirin. Parça tanımlayıcıları eşleşmiyor. Uzantı "tabs" iznine sahip değilse bu özellik yoksayılır.

    • windowId

      number isteğe bağlı

      Üst pencerenin kimliği veya mevcut pencere için windows.WINDOW_ID_CURRENT.

    • windowType

      WindowType isteğe bağlı

      Sekmelerin bulunduğu pencerenin türü.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (result: Tab[]) => void

İadeler

  • Promise<Tab[]>

    Chrome 88 ve sonraki sürümler

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

reload()

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

Sekmeyi yeniden yükleyin.

Parametreler

  • tabId

    number isteğe bağlı

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

  • reloadProperties

    nesne isteğe bağlı

    • bypassCache

      boole isteğe bağlı

      Yerel önbelleğe alma işleminin atlanıp atlanmayacağı. Varsayılan olarak false değerine ayarlanır.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

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

remove()

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

Bir veya daha fazla sekmeyi kapatır.

Parametreler

  • tabIds

    sayı | sayı[]

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

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

removeCSS()

Promise Chrome 87 ve sonraki sürümler &leq; MV2 Chrome 91'den beri kullanımdan kaldırıldı
chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

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

Daha önce scripting.insertCSS çağrısı ile bir sayfaya yerleştirilen CSS'yi kaldırır.

Parametreler

  • tabId

    number isteğe bağlı

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

  • ayrıntılar

    DeleteInjectionDetails

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

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

sendMessage()

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

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

Parametreler

  • tabId

    sayı

  • mesaj

    herhangi

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

  • seçenekler

    nesne isteğe bağlı

    • documentId

      dize isteğe bağlı

      Chrome 106 ve sonraki sürümler

      Sekmedeki tüm kareler yerine documentId ile tanımlanan belirli bir dokümana mesaj gönderin.

    • frameId

      number isteğe bağlı

      Sekmedeki tüm kareler yerine frameId ile tanımlanan belirli bir kareye mesaj gönderin.

  • geri çağırma

    işlev isteğe bağlı

    Chrome 99 ve üzeri sürümler

    callback parametresi şu şekilde görünür: 

    (response: any) => void

    • gönderin

      herhangi

      İletinin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken hata oluşursa geri çağırma işlevi bağımsız değişken olmadan çağrılır ve runtime.lastError hata mesajına ayarlanır.

İadeler

  • Promise<any>

    Chrome 99 ve üzeri sürümler

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

sendRequest()

Promise &leq; MV2 Desteği sonlandırıldı
chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)

Lütfen runtime.sendMessage kullanın.

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

Parametreler

  • tabId

    sayı

  • istek

    herhangi

  • geri çağırma

    işlev isteğe bağlı

    Chrome 99 ve üzeri sürümler

    callback parametresi şu şekilde görünür: 

    (response: any) => void

    • gönderin

      herhangi

      İsteğin işleyicisi tarafından gönderilen JSON yanıt nesnesi. Belirtilen sekmeye bağlanırken hata oluşursa geri çağırma işlevi bağımsız değişken olmadan çağrılır ve runtime.lastError hata mesajına ayarlanır.

İadeler

  • Promise<any>

    Chrome 99 ve üzeri sürümler

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

setZoom()

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • zoomFactor

    sayı

    Yeni yakınlaştırma faktörü. 0 değeri, sekmeyi mevcut varsayılan yakınlaştırma faktörüne ayarlar. 0'ten büyük değerler, sekme için bir yakınlaştırma faktörü (varsayılan olmayan) belirtir.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

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

setZoomSettings()

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • zoomSettings

    ZoomSettings

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

    Chrome 88 ve sonraki sürümler

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

ungroup()

Promise Chrome 88 ve sonraki sürümler 
chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
)

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

Parametreler

  • tabIds

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

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

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    () => void

İadeler

  • Promise<void>

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

update()

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • updateProperties

    nesne

    • etkin

      boole isteğe bağlı

      Sekmenin etkin olup olmayacağı. Pencerenin odaklanıp odaklanmadığını etkilemez (windows.update bölümüne bakın).

    • autoDiscardable

      boole isteğe bağlı

      Chrome 54 ve sonraki sürümler

      Kaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak atlanıp atlanmayacağı.

    • öne çıkarıldı

      boole isteğe bağlı

      Sekmeyi mevcut seçime ekler veya mevcut seçimden kaldırır.

    • ses kapatıldı

      boole isteğe bağlı

      Chrome 45 ve sonraki sürümler

      Sekmenin sessiz olup olmayacağı.

    • openerTabId

      number isteğe bağlı

      Bu sekmeyi açan sekmenin kimliği. Belirtilirse açan sekme, bu sekmeyle aynı pencerede olmalıdır.

    • sabitlendi

      boole isteğe bağlı

      Sekmenin sabitlenip sabitlenmeyeceği.

    • seçildi

      boole isteğe bağlı

      Kullanımdan kaldırıldı

      Lütfen vurgulanan seçeneğini kullanın.

      Sekmenin seçilip seçilmeyeceği.

    • url

      dize isteğe bağlı

      Sekmede gidilecek URL. JavaScript URL'leri desteklenmez. Bunun yerine scripting.executeScript kullanın.

  • geri çağırma

    işlev isteğe bağlı

    callback parametresi şu şekilde görünür: 

    (tab?: Tab) => void

    • sekmesinden

      Sekme isteğe bağlı

      Güncellenen sekmeyle ilgili ayrıntılar. "tabs" izni istenmemişse tabs.Tab nesnesi url, pendingUrl, title ve favIconUrl içermez.

İadeler

  • Promise<Tab | undefined>

    Chrome 88 ve sonraki sürümler

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

Etkinlikler

onActivated

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

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (activeInfo: object) => void

    • activeInfo

      nesne

      • tabId

        sayı

        Etkin hale gelen sekmenin kimliği.

      • windowId

        sayı

        Etkin sekmenin içinde değiştiği pencerenin kimliği.

onActiveChanged

&leq; MV2 Desteği sonlandırıldı
chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Lütfen tabs.onActivated kullanın.

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (tabId: number, selectInfo: object) => void

    • tabId

      sayı

    • selectInfo

      nesne

      • windowId

        sayı

        Seçilen sekmenin içinde değiştiği pencerenin kimliği.

onAttached

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

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (tabId: number, attachInfo: object) => void

    • tabId

      sayı

    • attachInfo

      nesne

      • newPosition

        sayı

      • newWindowId

        sayı

onCreated

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

Bir sekme oluşturulduğunda tetiklenir. Sekmenin URL'si ve sekme grubu üyeliği, bu etkinlik tetiklendiğinde ayarlanmayabilir. Ancak URL ayarlandığında veya sekme bir sekme grubuna eklendiğinde bildirim almak için onUpdated etkinliklerini dinleyebilirsiniz.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (tab: Tab) => void

onDetached

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

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (tabId: number, detachInfo: object) => void

    • tabId

      sayı

    • detachInfo

      nesne

      • oldPosition

        sayı

      • oldWindowId

        sayı

onHighlightChanged

&leq; MV2 Desteği sonlandırıldı
chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Lütfen tabs.onHighlighted kullanın.

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (selectInfo: object) => void

    • selectInfo

      nesne

      • tabIds

        number[]

        Pencerede vurgulanan tüm sekmeler.

      • windowId

        sayı

        Sekmelerinin değiştirildiği pencere.

onHighlighted

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

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (highlightInfo: object) => void

    • highlightInfo

      nesne

      • tabIds

        number[]

        Pencerede vurgulanan tüm sekmeler.

      • windowId

        sayı

        Sekmelerinin değiştirildiği pencere.

onMoved

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

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (tabId: number, moveInfo: object) => void

    • tabId

      sayı

    • moveInfo

      nesne

      • fromIndex

        sayı

      • toIndex

        sayı

      • windowId

        sayı

onRemoved

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

Bir sekme kapatıldığında tetiklenir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (tabId: number, removeInfo: object) => void

    • tabId

      sayı

    • removeInfo

      nesne

      • isWindowClosing

        boolean

        Üst penceresi kapalı olduğu için sekme kapatıldığında doğru değerini döndürür.

      • windowId

        sayı

        Sekmesi kapalı olan pencere.

onReplaced

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

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (addedTabId: number, removedTabId: number) => void

    • addedTabId

      sayı

    • removedTabId

      sayı

onSelectionChanged

&leq; MV2 Desteği sonlandırıldı
chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Lütfen tabs.onActivated kullanın.

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (tabId: number, selectInfo: object) => void

    • tabId

      sayı

    • selectInfo

      nesne

      • windowId

        sayı

        Seçilen sekmenin içinde değiştiği pencerenin kimliği.

onUpdated

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

Bir sekme güncellendiğinde tetiklenir.

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (tabId: number, changeInfo: object, tab: Tab) => void

    • tabId

      sayı

    • changeInfo

      nesne

      • audible

        boole isteğe bağlı

        Chrome 45 ve sonraki sürümler

        Sekmenin yeni sesli durumu.

      • autoDiscardable

        boole isteğe bağlı

        Chrome 54 ve sonraki sürümler

        Sekmenin yeni otomatik olarak atılabilir durumu.

      • silindi

        boole isteğe bağlı

        Chrome 54 ve sonraki sürümler

        Sekmenin yeni "Silindi" durumu.

      • favIconUrl

        dize isteğe bağlı

        Sekmenin yeni simge URL'si.

      • dondurulmuş

        boole isteğe bağlı

        Beklemede

        Sekmenin yeni dondurulmuş durumu.

      • groupId

        number isteğe bağlı

        Chrome 88 ve sonraki sürümler

        Sekmenin yeni grubu.

      • mutedInfo

        MutedInfo isteğe bağlı

        Chrome 46 ve sonraki sürümler

        Sekmenin yeni sessiz durumu ve değişikliğin nedeni.

      • sabitlendi

        boole isteğe bağlı

        Sekmenin yeni sabitlenmiş durumu.

      • durum

        TabStatus isteğe bağlı

        Sekmenin yükleme durumu.

      • title

        dize isteğe bağlı

        Chrome 48 ve sonraki sürümler

        Sekmenin yeni başlığı.

      • url

        dize isteğe bağlı

        Değiştiyse sekmenin URL'si.

    • sekmesinden

      Sekme

onZoomChange

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

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

Parametreler

  • geri çağırma

    işlev

    callback parametresi şu şekilde görünür: 

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      nesne

      • newZoomFactor

        sayı

      • oldZoomFactor

        sayı

      • tabId

        sayı

      • zoomSettings

        ZoomSettings