chrome.tabs

Açıklama

Tarayıcının sekme sistemiyle etkileşim kurmak için chrome.tabs API'sini kullanın. Bu API'yi kullanarak tarayıcıda sekmeler oluşturabilir, değiştirebilir ve yeniden düzenleyebilirsiniz.

Genel Bakış

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

İzinler

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

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

"Sekmeler" izni
Bu izin, chrome.tabs ad alanına erişim vermez. Bunun yerine, tabs.query() işlevini tabs.Tab örneklerindeki dört hassas özellik (url, pendingUrl, title ve favIconUrl) için çağırma izni verir.
Ana makine izinleri
Ana makine izinleri, bir uzantının eşleşen sekmenin dört hassas tabs.Tab özelliğini okumasına ve sorgulamasına olanak tanır. Ayrıca tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() ve tabs.removeCSS() gibi yöntemleri kullanarak doğrudan eşleşen sekmelerle etkileşimde bulunabilirler.
"activeTab" izni
activeTab, kullanıcı isteğine yanıt olarak geçerli sekmede geçici ana makine izni verir. Ana makine izinlerinin aksine, activeTab herhangi bir uyarı tetiklemez.

Manifest

Aşağıda, her iznin manifest dosyasında 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 sekmede açma

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

background.js:

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

Geçerli sekmeyi alma

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

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


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

Belirtilen sekmenin sesini kapatma

Bu örnekte, bir uzantının belirli bir sekmenin 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 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 düzenini kullanabilirsiniz.

  chrome.tabs.onActivated.addListener(moveToFirstPosition);

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


  chrome.tabs.onActivated.addListener(moveToFirstPositionMV2);

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

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

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

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

Uzantı örnekleri

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

Türler

MutedInfo

Chrome 46 veya daha yeni bir sürüm

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

Özellikler

  • extensionId

    dize isteğe bağlı

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

  • ses kapatıldı

    boolean

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

  • neden

    MutedInfoReason isteğe bağlı

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

MutedInfoReason

Chrome 46 veya daha yeni bir sürüm

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

Enum

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

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

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

Tab

Özellikler

  • etkin

    boolean

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

  • audible

    boolean isteğe bağlı

    Chrome 45 ve sonraki sürümler

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

  • autoDiscardable

    boolean

    Chrome 54 veya daha yeni bir sürüm

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

  • silindi

    boolean

    Chrome 54 veya daha yeni bir sürüm

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

  • favIconUrl

    dize isteğe bağlı

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

  • dondurulmuş

    boolean

    Chrome 132 veya daha yeni bir sürüm

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

  • groupId

    sayı

    Chrome 88 ve sonraki sürümler

    Sekmenin ait olduğu grubun kimliği.

  • yükseklik

    number isteğe bağlı

    Sekmenin piksel cinsinden yüksekliği.

  • öne çıkarıldı

    boolean

    Sekmenin vurgulanıp vurgulanmadığı.

  • id

    number isteğe bağlı

    Sekmenin kimliği. Sekme kimlikleri, tarayıcı oturumlarında benzersizdir. Bazı durumlarda bir sekmeye kimlik atanmayabilir. Örneğin, sessions API'si kullanılarak yabancı sekmeler sorgulanırken oturum kimliği mevcut olabilir. Sekme kimliği, uygulamalar ve geliştirici araçları pencereleri için de chrome.tabs.TAB_ID_NONE olarak ayarlanabilir.

  • gizli

    boolean

    Sekmenin gizli pencerede olup olmadığı.

  • indeks

    sayı

    Sekmenin penceresindeki sıfır tabanlı dizini.

  • lastAccessed

    sayı

    Chrome 121 ve sonraki sürümler

    Sekmenin, penceresinde en son etkin hale geldiği zaman (sıfır zamanından itibaren geçen milisaniye sayısı).

  • mutedInfo

    MutedInfo isteğe bağlı

    Chrome 46 veya daha yeni bir sürüm

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

  • openerTabId

    number isteğe bağlı

    Bu sekmeyi açan sekmenin kimliği (varsa). Bu özellik yalnızca açıcı sekme hala varsa bulunur.

  • pendingUrl

    dize isteğe bağlı

    Chrome 79 veya daha yeni bir sürüm

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

  • sabitlendi

    boolean

    Sekmenin sabitlenip sabitlenmediği

  • seçili

    boolean

    Kullanımdan kaldırıldı

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

    Sekmenin seçilip seçilmediği.

  • sessionId

    dize isteğe bağlı

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

  • durum

    TabStatus isteğe bağlı

    Sekmenin yükleme durumu.

  • title

    dize isteğe bağlı

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

  • url

    dize isteğe bağlı

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

  • genişlik

    number isteğe bağlı

    Sekmenin piksel cinsinden genişliği.

  • windowId

    sayı

    Sekmeyi içeren pencerenin kimliği.

TabStatus

Chrome 44 veya daha yeni bir sürüm

Sekmenin yükleme durumu.

Enum

"unloaded"

"loading"

"complete"

WindowType

Chrome 44 veya daha yeni bir sürüm

Pencerenin türü.

Enum

"normal"

"popup"

"panel"

"app"

"devtools"

ZoomSettings

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

Özellikler

  • defaultZoomFactor

    number isteğe bağlı

    Chrome 43 veya daha yeni bir sürüm

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

  • mod

    ZoomSettingsMode isteğe bağlı

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

  • kapsam

    ZoomSettingsScope isteğe bağlı

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

ZoomSettingsMode

Chrome 44 veya daha yeni bir sürüm

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

Enum

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

"manual"
Yakınlaştırma değişikliklerinin otomatik olarak işlenmesini geçersiz kılar. onZoomChange etkinliği gönderilmeye devam eder. Bu etkinliği dinlemek ve sayfayı manuel olarak ölçeklendirmek uzantının sorumluluğundadır. Bu modda per-origin yakınlaştırma desteklenmez. Bu nedenle, scope yakınlaştırma ayarı yoksayılır ve per-tab varsayılır.

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

ZoomSettingsScope

Chrome 44 veya daha yeni bir sürüm

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

Enum

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

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

Özellikler

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 veya daha yeni bir sürüm

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

Değer

2

TAB_ID_NONE

Chrome 46 veya daha yeni bir sürüm

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

Değer

-1

TAB_INDEX_NONE

Chrome 123 veya daha yeni bir sürüm

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

Değer

-1

Yöntemler

captureVisibleTab()

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

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

Parametreler

  • windowId

    number isteğe bağlı

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

  • seçenekler

    ImageDetails isteğe bağlı

  • callback

    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üleme için bir HTML img öğesinin "src" özelliğine atanabilir.

İadeler

  • Promise<string>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

connect()

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

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

Parametreler

  • tabId

    sayı

  • connectInfo

    object isteğe bağlı

    • documentId

      dize isteğe bağlı

      Chrome 106 ve sonraki sürümler

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

    • frameId

      number isteğe bağlı

      Sekmedeki tüm çerçeveler yerine frameId ile tanımlanan belirli bir çerçeveye bağlantı noktası açın.

    • ad

      dize isteğe bağlı

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

İadeler

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

create()

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

Yeni bir sekme oluşturur.

Parametreler

  • createProperties

    nesne

    • etkin

      boolean isteğe bağlı

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

    • indeks

      number isteğe bağlı

      Sekmenin pencerede alması gereken konum. Sağlanan değer, sıfır ile penceredeki sekme sayısı arasında bir değere sabitlenir.

    • openerTabId

      number isteğe bağlı

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

    • sabitlendi

      boolean isteğe bağlı

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

    • seçili

      boolean isteğe bağlı

      Kullanımdan kaldırıldı

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

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

    • url

      dize isteğe bağlı

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

    • windowId

      number isteğe bağlı

      Yeni sekmenin oluşturulacağı pencere. Varsayılan olarak geçerli pencere seçilir.

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

detectLanguage()

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

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

Parametreler

  • tabId

    number isteğe bağlı

    Varsayılan olarak geçerli pencerenin etkin sekmesi seçilir.

  • callback

    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öntem tarafından desteklenen dillerin tam listesi için kLanguageInfoTable'ı inceleyin. İkinci ila dördüncü sütunlar kontrol edilir ve zh-CN döndürülen 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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

discard()

Promise Chrome 54+ 
chrome.tabs.discard(
  tabId?: number,
  callback?: function,
): Promise<Tab | undefined>

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • callback

    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 silinen sekme; aksi takdirde tanımsız.

İadeler

  • Promise<Tab | undefined>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

duplicate()

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

Sekmeyi kopyalar.

Parametreler

  • tabId

    sayı

    Kopyalanacak sekmenin kimliği.

  • callback

    işlev isteğe bağlı

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

    (tab?: Tab) => void

    • sekmesinden

      Sekme isteğe bağlı

      Yinelenen sekme hakkında ayrıntılar. url, pendingUrl, title ve favIconUrl özellikleri yalnızca uzantının "tabs" izni varsa veya sayfa için ana makine izinleri varsa tabs.Tab nesnesine dahil edilir.

İadeler

  • Promise<Tab | undefined>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

executeScript()

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

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

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

Parametreler

  • tabId

    number isteğe bağlı

    Komut dosyasının çalıştırılacağı sekmenin kimliği. Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.

  • ayrıntılar

    InjectDetails

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

  • callback

    işlev isteğe bağlı

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

    (result?: any[]) => void

    • sonuç

      any[] isteğe bağlı

      Her eklenen karede komut dosyasının sonucu.

İadeler

  • Promise<any[] | undefined>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

get()

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

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

Parametreler

  • tabId

    sayı

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getAllInWindow()

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

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 seçilir.

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getCurrent()

Promise 
chrome.tabs.getCurrent(
  callback?: function,
): Promise<Tab | undefined>

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

Parametreler

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getSelected()

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

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 geçerli pencere seçilir.

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getZoom()

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • callback

    işlev isteğe bağlı

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

    (zoomFactor: number) => void

    • zoomFactor

      sayı

      Sekmenin geçerli yakınlaştırma faktörü.

İadeler

  • Promise<number>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

getZoomSettings()

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

goBack()

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

Varsa önceki sayfaya dönün.

Parametreler

  • tabId

    number isteğe bağlı

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

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

goForward()

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

group()

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

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

Parametreler

  • seçenekler

    nesne

    • createProperties

      object isteğe bağlı

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

      • windowId

        number isteğe bağlı

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

    • groupId

      number isteğe bağlı

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

    • tabIds

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

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

  • callback

    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>

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

highlight()

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

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

Parametreler

  • highlightInfo

    nesne

    • sekmeler

      number | number[]

      Vurgulanacak bir veya daha fazla sekme dizini.

    • windowId

      number isteğe bağlı

      Sekmeleri içeren pencere.

  • callback

    işlev isteğe bağlı

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

    (window: Window) => void

    • pencere

      Pencere

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

İadeler

  • Promise<windows.Window>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

insertCSS()

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

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 programatik yerleştirme 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 sekmesi kullanılır.

  • ayrıntılar

    InjectDetails

    Eklenecek CSS metninin ayrıntıları. Kod veya dosya özelliği ayarlanmalıdır ancak ikisi aynı anda ayarlanamaz.

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

move()

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

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

Parametreler

  • tabIds

    number | number[]

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

  • moveProperties

    nesne

    • indeks

      sayı

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

    • windowId

      number isteğe bağlı

      Varsayılan olarak sekmenin bulunduğu pencere kullanılır.

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

query()

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

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

Parametreler

  • queryInfo

    nesne

    • etkin

      boolean isteğe bağlı

      Sekmelerin pencerelerinde etkin olup olmadığı.

    • audible

      boolean isteğe bağlı

      Chrome 45 ve sonraki sürümler

      Sekmelerin sesli olup olmadığı.

    • autoDiscardable

      boolean isteğe bağlı

      Chrome 54 veya daha yeni bir sürüm

      Kaynaklar azaldığında sekmelerin tarayıcı tarafından otomatik olarak atılıp atılamayacağı.

    • currentWindow

      boolean isteğe bağlı

      Sekmelerin geçerli pencerede olup olmadığı.

    • silindi

      boolean isteğe bağlı

      Chrome 54 veya daha yeni bir sürüm

      Sekmelerin atılıp atılmayacağı. Atılan sekme, içeriği bellekten kaldırılmış ancak sekme şeridinde görünmeye devam eden sekmedir. İçeriği, bir sonraki etkinleştirme işleminde yeniden yüklenir.

    • dondurulmuş

      boolean isteğe bağlı

      Chrome 132 veya daha yeni bir sürüm

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

    • groupId

      number isteğe bağlı

      Chrome 88 ve sonraki sürümler

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

    • öne çıkarıldı

      boolean isteğe bağlı

      Sekmelerin vurgulanıp vurgulanmayacağı.

    • indeks

      number isteğe bağlı

      Sekmelerin pencerelerindeki konumu.

    • lastFocusedWindow

      boolean isteğe bağlı

      Sekmelerin en son odaklanılan pencerede olup olmadığı.

    • ses kapatıldı

      boolean isteğe bağlı

      Chrome 45 ve sonraki sürümler

      Sekmelerin sesi kapatılıp kapatılmadığı.

    • sabitlendi

      boolean isteğe bağlı

      Sekmelerin sabitlenip sabitlenmediği

    • splitViewId

      number isteğe bağlı

      Beklemede

      Sekmelerin bulunduğu bölünmüş görünümün kimliği veya bölünmüş görünümde olmayan sekmeler için tabs.SPLIT_VIEW_ID_NONE.

    • durum

      TabStatus isteğe bağlı

      Sekme yükleme durumu.

    • title

      dize isteğe bağlı

      Sayfa başlıklarını bir kalıpla eşleştirin. Uzantının "tabs" izni veya sayfa için ana makine izinleri yoksa bu özellik yok sayılır.

    • url

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

      Sekmeleri bir veya daha fazla URL kalıbıyla eşleştirin. Parça tanımlayıcılar eşleştirilmez. Uzantının "tabs" izni veya sayfa için ana makine izinleri yoksa bu özellik yok sayılır.

    • windowId

      number isteğe bağlı

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

    • windowType

      WindowType isteğe bağlı

      Sekmelerin bulunduğu pencerenin türü.

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

reload()

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

Sekmeyi yeniden yükleyin.

Parametreler

  • tabId

    number isteğe bağlı

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

  • reloadProperties

    object isteğe bağlı

    • bypassCache

      boolean isteğe bağlı

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

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

remove()

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

Bir veya daha fazla sekmeyi kapatır.

Parametreler

  • tabIds

    number | number[]

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

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdı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,
): Promise<void>

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

Daha önce scripting.insertCSS çağrısıyla eklenmiş CSS'yi sayfadan 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 sekmesi kullanılır.

  • ayrıntılar

    DeleteInjectionDetails

    Kaldırılacak CSS metninin ayrıntıları. Kod veya dosya özelliği ayarlanmalıdır ancak ikisi aynı anda ayarlanamaz.

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

sendMessage()

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

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

Parametreler

  • tabId

    sayı

  • mesaj

    herhangi

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

  • seçenekler

    object isteğe bağlı

    • documentId

      dize isteğe bağlı

      Chrome 106 ve sonraki sürümler

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

    • frameId

      number isteğe bağlı

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

  • callback

    işlev isteğe bağlı

    Chrome 99 veya daha yeni bir sürüm

    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 bir hata oluşursa geri çağırma bağımsız değişken olmadan çağrılır ve runtime.lastError hata mesajına ayarlanır.

İadeler

  • Promise<any>

    Chrome 99 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

sendRequest()

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

Lütfen runtime.sendMessage kullanın.

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

Parametreler

  • tabId

    sayı

  • istek

    herhangi

  • callback

    işlev isteğe bağlı

    Chrome 99 veya daha yeni bir sürüm

    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 bir hata oluşursa geri çağırma bağımsız değişken olmadan çağrılır ve runtime.lastError hata mesajına ayarlanır.

İadeler

  • Promise<any>

    Chrome 99 veya daha yeni bir sürüm

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setZoom()

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

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

Parametreler

  • tabId

    number isteğe bağlı

    Yakınlaştırılacak sekmenin kimliği. Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.

  • zoomFactor

    sayı

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

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

setZoomSettings()

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

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

Parametreler

  • tabId

    number isteğe bağlı

    Yakınlaştırma ayarlarının değiştirileceği sekmenin kimliği. Varsayılan olarak geçerli pencerenin etkin sekmesi kullanılır.

  • zoomSettings

    ZoomSettings

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

  • callback

    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

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

ungroup()

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

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

Parametreler

  • tabIds

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

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

  • callback

    işlev isteğe bağlı

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

    () => void

İadeler

  • Promise<void>

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

update()

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

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

Parametreler

  • tabId

    number isteğe bağlı

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

  • updateProperties

    nesne

    • etkin

      boolean isteğe bağlı

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

    • autoDiscardable

      boolean isteğe bağlı

      Chrome 54 veya daha yeni bir sürüm

      Kaynaklar azaldığında sekmenin tarayıcı tarafından otomatik olarak atılıp atılmayacağı.

    • öne çıkarıldı

      boolean isteğe bağlı

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

    • ses kapatıldı

      boolean isteğe bağlı

      Chrome 45 ve sonraki sürümler

      Sekmenin sesi kapatılıp kapatılmayacağı.

    • openerTabId

      number isteğe bağlı

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

    • sabitlendi

      boolean isteğe bağlı

      Sekmenin sabitlenip sabitlenmeyeceği.

    • seçili

      boolean isteğe bağlı

      Kullanımdan kaldırıldı

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

      Sekmenin seçilip seçilmeyeceği.

    • url

      dize isteğe bağlı

      Sekmenin yönlendirileceği URL. JavaScript URL'leri desteklenmez. Bunun yerine scripting.executeScript kullanın.

  • callback

    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 sekme hakkında ayrıntılar. url, pendingUrl, title ve favIconUrl özellikleri yalnızca uzantının "tabs" izni varsa veya sayfa için ana makine izinleri varsa tabs.Tab nesnesine dahil edilir.

İadeler

  • Promise<Tab | undefined>

    Chrome 88 ve sonraki sürümler

    Promises yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformlarda geri çağırmalar kullanılmalıdır.

Etkinlikler

onActivated

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

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

Parametreler

  • callback

    işlev

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

    (activeInfo: object) => void

    • activeInfo

      nesne

      • tabId

        sayı

        Etkin hale gelen sekmenin kimliği.

      • windowId

        sayı

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

onActiveChanged

&leq; MV2 Kullanımdan kaldırıldı
chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Lütfen tabs.onActivated kullanın.

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

Parametreler

  • callback

    işlev

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

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

    • tabId

      sayı

    • selectInfo

      nesne

      • windowId

        sayı

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

onAttached

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

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

Parametreler

  • callback

    işlev

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

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

    • tabId

      sayı

    • attachInfo

      nesne

      • newPosition

        sayı

      • newWindowId

        sayı

onCreated

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

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

Parametreler

  • callback

    işlev

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

    (tab: Tab) => void

onDetached

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

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

Parametreler

  • callback

    işlev

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

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

    • tabId

      sayı

    • detachInfo

      nesne

      • oldPosition

        sayı

      • oldWindowId

        sayı

onHighlightChanged

&leq; MV2 Kullanımdan kaldı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

  • callback

    işlev

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

    (selectInfo: object) => void

    • selectInfo

      nesne

      • tabIds

        number[]

        Penceredeki tüm vurgulanmış sekmeler.

      • windowId

        sayı

        Sekmeleri değişen pencere.

onHighlighted

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

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

Parametreler

  • callback

    işlev

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

    (highlightInfo: object) => void

    • highlightInfo

      nesne

      • tabIds

        number[]

        Penceredeki tüm vurgulanmış sekmeler.

      • windowId

        sayı

        Sekmeleri değişen pencere.

onMoved

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

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

Parametreler

  • callback

    işlev

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

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

    • tabId

      sayı

    • moveInfo

      nesne

      • fromIndex

        sayı

      • toIndex

        sayı

      • windowId

        sayı

onRemoved

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

Bir sekme kapatıldığında tetiklenir.

Parametreler

  • callback

    işlev

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

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

    • tabId

      sayı

    • removeInfo

      nesne

      • isWindowClosing

        boolean

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

      • windowId

        sayı

        Sekmesi kapatılan pencere.

onReplaced

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

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

Parametreler

  • callback

    işlev

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

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

    • addedTabId

      sayı

    • removedTabId

      sayı

onSelectionChanged

&leq; MV2 Kullanımdan kaldırıldı
chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Lütfen tabs.onActivated kullanın.

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

Parametreler

  • callback

    işlev

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

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

    • tabId

      sayı

    • selectInfo

      nesne

      • windowId

        sayı

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

onUpdated

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

Bir sekme güncellendiğinde tetiklenir.

Parametreler

  • callback

    işlev

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

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

    • tabId

      sayı

    • changeInfo

      nesne

      • audible

        boolean isteğe bağlı

        Chrome 45 ve sonraki sürümler

        Sekmenin yeni sesli durumu.

      • autoDiscardable

        boolean isteğe bağlı

        Chrome 54 veya daha yeni bir sürüm

        Sekmenin yeni otomatik olarak silinebilir durumu.

      • silindi

        boolean isteğe bağlı

        Chrome 54 veya daha yeni bir sürüm

        Sekmenin yeni silinmiş durumu.

      • favIconUrl

        dize isteğe bağlı

        Sekmenin yeni site simgesi URL'si.

      • dondurulmuş

        boolean isteğe bağlı

        Chrome 132 veya daha yeni bir sürüm

        Sekmenin yeni dondurulmuş durumu.

      • groupId

        number isteğe bağlı

        Chrome 88 ve sonraki sürümler

        Sekmenin yeni grubu.

      • mutedInfo

        MutedInfo isteğe bağlı

        Chrome 46 veya daha yeni bir sürüm

        Sekmenin yeni sessize alınmış durumu ve değişikliğin nedeni.

      • sabitlendi

        boolean isteğe bağlı

        Sekmenin yeni sabitlenmiş durumu.

      • splitViewId

        number isteğe bağlı

        Beklemede

        Sekmenin yeni bölünmüş görünümü.

      • durum

        TabStatus isteğe bağlı

        Sekmenin yükleme durumu.

      • title

        dize isteğe bağlı

        Chrome 48 veya daha yeni bir sürüm

        Sekmenin yeni başlığı.

      • url

        dize isteğe bağlı

        Değişmişse sekmenin URL'si.

    • sekmesinden

      Sekme

onZoomChange

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

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

Parametreler

  • callback

    işlev

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

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      nesne

      • newZoomFactor

        sayı

      • oldZoomFactor

        sayı

      • tabId

        sayı

      • zoomSettings

        ZoomSettings