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.

Genel Bakış

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 etmeleri 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.
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.
"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.

Manifest

Aşağıda, manifest her iznin nasıl beyan edileceğine dair örnekler verilmiştir:

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

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

  {
    "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ılar için yaygın 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 örnek, bir uzantının hizmet çalışanının etkin sekmeyi o anda odaklanılan pencereden (veya hiçbir Chrome penceresine odaklanmıyorsa en son odaklanılan pencereden) nasıl alabileceğini gösterir. 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 sekmeyi yoksay

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çili sekmenin içerik komut dosyasına mesaj iletme

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

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

Uzantı örnekleri

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

Türler

MutedInfo

Chrome 46 ve sonraki sürümler

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 kapatılıp kapatılmadığı (ses çalmasının engellenip engellenmediği). 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

Sessize alma durumunun değişmesine neden olan bir etkinlik.

Enum

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

"capture"
Sekme yakalama işlemi başlatıldı 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österilmesiyle 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.

  • donduruldu

    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

    sayı isteğe bağlı

    Sekmenin kimliği. Sekme kimlikleri, tarayıcı oturumunda benzersizdir. Bazı durumlarda (örneğin, sessions API'sini kullanarak yabancı sekmeleri sorgularken) sekmeye kimlik atanmamış olabilir. Bu durumda, 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 kendi penceresindeki sıfır tabanlı dizini.

  • lastAccessed

    sayı

    Chrome 121 ve sonraki sürümler

    Dönemden bu yana geçen milisaniye sayısı olarak sekmeye en son erişildiği zaman.

  • mutedInfo

    MutedInfo isteğe bağlı

    Chrome 46 ve sonraki sürümler

    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 sabitlenip sabitlenmediğini belirtir.

  • seçildi

    boolean

    Desteği sonlandırıldı

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

    Sekmenin seçili olup olmadığı.

  • sessionId

    dize isteğe bağlı

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

  • durum

    TabStatus isteğe bağlı

    Sekmenin yükleme durumu.

  • title

    dize isteğe bağlı

    Sekmenin başlığı. Bu özellik yalnızca uzantının manifest'inde "tabs" izni varsa mevcuttur.

  • url

    dize isteğe bağlı

    Sekmenin ana çerçevesinin kaydedilen son 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 bkz. Tab.pendingUrl.

  • 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

"unload"

"loading"

"complete"

WindowType

Chrome 44 ve sonraki sürümler

Pencerenin türü.

Enum

"normal"

"popup"

"panel"

"uygulama"

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

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

"manual"
Yakınlaştırma değişikliklerinin otomatik olarak işlenmesini geçersiz kılar. onZoomChange etkinliği yine 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 düzeyine geri döner ve yapılan tüm yakınlaştırma değişiklikleri yoksayılır.

ZoomSettingsScope

Chrome 44 ve sonraki sürümler

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 başlangıç noktasıyla birlikte kaydedilir. Diğer bir deyişle, aynı kaynaktaki diğer sayfalara giderken aynı yakınlaştırma faktörüne göre yakınlaştırma yapılır. per-origin kapsamı yalnızca automatic modunda kullanılabilir.

"sekme başına"
Yakınlaştırma değişiklikleri yalnızca bu sekmede geçerli olur 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

Saniyede captureVisibleTab için maksimum çağrı sayısı. 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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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

      sayı 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 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 alacağı konum. Sağlanan değer, sıfır ile penceredeki sekme sayısı arasına sabitlenir.

    • openerTabId

      sayı isteğe bağlı

      Bu sekmeyi açan sekmenin kimliği. Belirtilmişse açıcı sekmesi, yeni oluşturulan sekmeyle aynı pencerede olmalıdır.

    • sabitlendi

      boole isteğe bağlı

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

    • seçildi

      boole isteğe bağlı

      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

      Oluşturulan sekme.

İadeler

  • Promise<Tab>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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

  • geri çağırma

    işlev isteğe bağlı

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

    (language: string) => void

    • language

      dize

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

İadeler

  • Promise<string>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

discard()

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

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ı

      Başarıyla silindiyse silinen sekme; aksi takdirde tanımlanmamıştır.

İadeler

  • Promise<Sekme | tanımsız>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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ı

      Yinelenen 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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

executeScript()

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

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

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

Parametreler

  • tabId

    number isteğe bağlı

    Komut dosyasının çalıştırılacağı sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesini ifade eder.

  • ayrıntılar

    Ç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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

getAllInWindow()

Vaat &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 geçerli pencere kullanılır.

  • geri çağırma

    işlev isteğe bağlı

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

    (tabs: Tab[]) => void

İadeler

  • Promise<Tab[]>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

getSelected()

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

    Chrome 88 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

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

  • Taahhüt<sayı>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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

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

İadeler

  • Promise<ZoomSettings>.

    Chrome 88 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

goBack()

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

Varsa önceki sayfaya geri 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

  • Taahhüt<geçersiz>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

goForward()

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

Varsa bir sonraki sayfaya gidin.

Parametreler

  • tabId

    sayı isteğe bağlı

    İ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

  • Taahhüt<geçersiz>

    Chrome 88 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

group()

Söz veriyorum 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. Belirtilmezse 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>

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

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

      sayı isteğe bağlı

      Sekmeleri içeren pencere.

  • geri çağırma

    işlev isteğe bağlı

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

    (window: Window) => void

    • pencere

      Sekmeleri vurgulanan pencereyle ilgili ayrıntıları içerir.

İadeler

  • Chrome 88 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

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.

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

Parametreler

  • tabId

    sayı isteğe bağlı

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

  • ayrıntılar

    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

  • Taahhüt<geçersiz>

    Chrome 88 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

move()

Söz
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 kimliklerinin 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 şu anda bulunduğu pencere kullanılır.

  • geri çağırma

    işlev isteğe bağlı

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

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

    • sekmeler

      Sekme | Sekme[]

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

İadeler

  • Promise<Tab | Tab[]>

    Chrome 88 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

query()

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

Belirtilen özelliklere sahip tüm sekmeleri veya hiçbir özellik belirtilmezse tüm sekmeleri alır.

Parametreler

  • queryInfo

    nesne

    • etkin

      boole isteğe bağlı

      Sekmelerin pencerelerinde etkin olup olmadığı.

    • audible

      boole isteğe bağlı

      Chrome 45 ve sonraki sürümler

      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ğı. Silinen sekme, içeriği bellekten kaldırılan ancak sekme şeridinde görünmeye devam eden sekmelerdir. 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ştirme sonrasında donduruldu.

    • groupId

      sayı 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ştirin. 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

      sayı 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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

reload()

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

Bir 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 sekmesine ayarlanır.

  • reloadProperties

    nesne isteğe bağlı

    • bypassCache

      boole isteğe bağlı

      Yerel önbelleğe almanın atlanıp atlanmayacağı. Varsayılan olarak false değerine ayarlanır.

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<geçersiz>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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

  • Taahhüt<geçersiz>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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ıyla yerleştirilen CSS sayfasındaki CSS'den kaldırılır.

Parametreler

  • tabId

    sayı isteğe bağlı

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

  • ayrıntılar

    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

  • Taahhüt<geçersiz>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

sendMessage()

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

Belirtilen sekmedeki içerik komut dosyalarına tek bir ileti gönderir. İsteğe bağlı olarak, bir yanıt geri gönderildiğinde geri çağırma yapılır. 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 sonraki sürümler

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

    (response: any) => void

    • gönderin

      herhangi

      Mesajın 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 sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

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. İsteğe bağlı olarak, bir yanıt geri gönderildiğinde geri çağırma işlevi de kullanılır. extension.onRequest etkinliği, geçerli uzantı için belirtilen sekmede çalışan her içerik komut dosyasında tetiklenir.

Parametreler

  • tabId

    sayı

  • istek

    herhangi

  • geri çağırma

    işlev isteğe bağlı

    Chrome 99 ve sonraki sürümler

    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 sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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ırmak için kullanılacak sekmenin kimliği; varsayılan olarak geçerli pencerenin etkin sekmesini ifade eder.

  • 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

  • Taahhüt<geçersiz>

    Chrome 88 ve sonraki sürümler

    Sözler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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

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

  • geri çağırma

    işlev isteğe bağlı

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

    () => void

İadeler

  • Taahhüt<geçersiz>

    Chrome 88 ve sonraki sürümler

    Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.

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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

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

      sayı isteğe bağlı

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

    • sabitlendi

      boole isteğe bağlı

      Sekmenin sabitlenip sabitlenmeyeceği.

    • seçildi

      boole isteğe bağlı

      Kullanımdan kaldırıldı

      Lütfen vurgulananlar özelliğini kullanın.

      Sekmenin seçilip seçilmeyeceği.

    • url

      dize isteğe bağlı

      Sekmenin gidileceği URL. JavaScript URL'leri desteklenmez. Bunun yerine scripting.executeScript 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 yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırma işlevlerini kullanması gerekir.

Etkinlikler

onActivated

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

Bir penceredeki etkin sekme değiştiğinde tetiklenir. Sekme URL'sinin bu etkinlik tetiklendiği sırada ayarlanmamış olabileceğ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 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çili sekmenin içinde yer aldığı pencerenin kimliği.

onAttached

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

Bir sekme pencereye eklendiğinde (ör. pencereler arasında taşındığı için) 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

        numara[]

        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

        numara[]

        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 göre hareket etmesi 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çili sekmenin içinde yer aldığı pencerenin kimliği.

onUpdated

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

Bir sekme güncellendiğinde tetiklenir.

Parametreler

  • geri çağırma

    işlev

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

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

    • tabId

      sayı

    • changeInfo

      nesne

      • audible

        boole isteğe bağlı

        Chrome 45 ve sonraki sürümler

        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 donma durumu.

      • groupId

        sayı 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

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