chrome.tabbladen

Beschrijving

Gebruik de chrome.tabs API om te communiceren met het tabbladsysteem van de browser. U kunt deze API gebruiken om tabbladen in de browser aan te maken, te wijzigen en opnieuw te ordenen.

Overzicht

De Tabs API biedt niet alleen functies voor het bewerken en beheren van tabbladen, maar kan ook de taal van het tabblad detecteren, een schermafbeelding maken en communiceren met de inhoudsscripts van een tabblad.

Machtigingen

Voor de meeste functies zijn geen rechten vereist. Bijvoorbeeld: een nieuw tabblad aanmaken , een tabblad opnieuw laden , naar een andere URL navigeren , enz.

Er zijn drie machtigingen waar ontwikkelaars rekening mee moeten houden bij het werken met de Tabs API.

De toestemming "tabbladen"
Deze machtiging geeft geen toegang tot de chrome.tabs -naamruimte. In plaats daarvan geeft het een extensie de mogelijkheid om tabs.query() aan te roepen voor vier gevoelige eigenschappen op tabs.Tab -instanties: url , pendingUrl , title en favIconUrl .
Hostmachtigingen
Met hostmachtigingen kan een extensie de vier gevoelige tabs.Tab -eigenschappen van een overeenkomend tabblad lezen en raadplegen. Ze kunnen ook rechtstreeks met de overeenkomende tabbladen communiceren via methoden zoals tabs.captureVisibleTab() , tabs.executeScript() , tabs.insertCSS() en tabs.removeCSS() .
De machtiging "activeTab"
activeTab verleent een extensie tijdelijke hostrechten voor het huidige tabblad als reactie op een gebruikersaanroep. In tegenstelling tot hostrechten genereert activeTab geen waarschuwingen.

Manifest

Hieronder staan voorbeelden van hoe u elke machtiging in het manifest kunt declareren: 

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


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


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

Gebruiksscenario's

In de volgende paragrafen worden enkele veelvoorkomende gebruiksgevallen beschreven.

Een extensiepagina openen in een nieuw tabblad

Een veelvoorkomend patroon voor extensies is het openen van een onboardingpagina in een nieuw tabblad wanneer de extensie is geïnstalleerd. Het volgende voorbeeld laat zien hoe u dit doet.

achtergrond.js:

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

Het huidige tabblad ophalen

Dit voorbeeld laat zien hoe de service worker van een extensie het actieve tabblad kan ophalen uit het momenteel actieve venster (of het meest recent actieve venster, als er geen Chrome-vensters actief zijn). Dit kan meestal worden beschouwd als het huidige tabblad van de gebruiker. 

  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);
    });
  }

Het opgegeven tabblad dempen

Dit voorbeeld laat zien hoe een extensie de gedempte status voor een bepaald tabblad kan in- of uitschakelen. 

  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" }`);
    });
  }

Verplaats het huidige tabblad naar de eerste positie wanneer erop wordt geklikt

Dit voorbeeld laat zien hoe je een tabblad kunt verplaatsen terwijl er al dan niet wordt gesleept. Hoewel dit voorbeeld chrome.tabs.move gebruikt, kun je hetzelfde wachtpatroon gebruiken voor andere aanroepen waarbij tabbladen worden gewijzigd terwijl er wordt gesleept. 

  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.");
      }
    });
  }

Een bericht doorgeven aan het inhoudsscript van een geselecteerd tabblad

Dit voorbeeld laat zien hoe de service worker van een extensie kan communiceren met inhoudsscripts in specifieke browsertabbladen met behulp van tabs.sendMessage() . 

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

Voorbeelden van uitbreidingen

Voor meer demo's van Tabs API-extensies kunt u het volgende bekijken:

Typen

MutedInfo

Chroom 46+

De gedempte status van het tabblad en de reden voor de laatste statuswijziging.

Eigenschappen

  • extensie-ID

    string optioneel

    De ID van de extensie die de gedempte status heeft gewijzigd. Wordt niet ingesteld als een extensie niet de reden was dat de gedempte status voor het laatst is gewijzigd.

  • gedempt

    Booleaanse

    Of het tabblad gedempt is (geen geluid afspelen). Het tabblad kan gedempt zijn, zelfs als er geen geluid is afgespeeld of er momenteel geen geluid wordt afgespeeld. Dit is gelijk aan of de audio-indicator 'gedempt' wordt weergegeven.

  • reden

    MutedInfoReason optioneel

    De reden waarom het tabblad is gedempt of niet. Wordt niet ingesteld als de gedempt status van het tabblad nooit is gewijzigd.

MutedInfoReason

Chroom 46+

Een gebeurtenis die een gedempte statuswijziging veroorzaakte.

Enum

"gebruiker"
Een invoeractie van de gebruiker stelt de gedempte status in.

"vastlegging"
Tabbladregistratie is gestart, waardoor een gedempte statuswijziging is afgedwongen.

"verlenging"
Een extensie, geïdentificeerd door het extensionId-veld, stelt de gedempte status in.

Tab

Eigenschappen

  • actief

    Booleaanse

    Of het tabblad actief is in het venster. Dit betekent niet per se dat het venster de focus heeft.

  • hoorbaar

    boolean optioneel

    Chroom 45+

    Of het tabblad de afgelopen seconden geluid heeft geproduceerd (maar mogelijk niet hoorbaar is als het ook gedempt is). Equivalent aan of de indicator 'luidsprekeraudio' zichtbaar is.

  • automatisch wegwerpbaar

    Booleaanse

    Chroom 54+

    Of het tabblad automatisch door de browser kan worden verwijderd wanneer er weinig bronnen beschikbaar zijn.

  • weggegooid

    Booleaanse

    Chroom 54+

    Of het tabblad wordt verwijderd. Een verwijderd tabblad is een tabblad waarvan de inhoud uit het geheugen is verwijderd, maar nog steeds zichtbaar is in de tabbladenstrook. De inhoud wordt opnieuw geladen wanneer het tabblad de volgende keer wordt geactiveerd.

  • favIconUrl

    string optioneel

    De URL van het favicon van het tabblad. Deze eigenschap is alleen aanwezig als de extensie de machtiging "tabs" of hostmachtigingen voor de pagina heeft. Het kan ook een lege tekenreeks zijn als het tabblad wordt geladen.

  • bevroren

    Booleaanse

    Chroom 132+

    Of het tabblad is vastgelopen. Een vastgelopen tabblad kan geen taken uitvoeren, inclusief gebeurtenis-handlers of timers. Het is zichtbaar in de tabbladenstrook en de inhoud ervan wordt in het geheugen geladen. Het wordt weer vrijgegeven bij activering.

  • groeps-ID

    nummer

    Chroom 88+

    De ID van de groep waartoe het tabblad behoort.

  • hoogte

    nummer optioneel

    De hoogte van het tabblad in pixels.

  • gemarkeerd

    Booleaanse

    Of het tabblad gemarkeerd is.

  • id

    nummer optioneel

    De ID van het tabblad. Tabblad-ID's zijn uniek binnen een browsersessie. Onder bepaalde omstandigheden kan een tabblad geen ID toegewezen krijgen, bijvoorbeeld bij het raadplegen van externe tabbladen via de sessions API. In dat geval kan er wel een sessie-ID aanwezig zijn. De tabblad-ID kan ook worden ingesteld op chrome.tabs.TAB_ID_NONE voor apps en devtools-vensters.

  • incognito

    Booleaanse

    Of het tabblad zich in een incognitovenster bevindt.

  • index

    nummer

    De op nul gebaseerde index van het tabblad binnen het venster.

  • laatstgeraadpleegd

    nummer

    Chroom 121+

    Het aantal milliseconden sinds het tijdperk waarin het tabblad voor het laatst actief werd in het venster.

  • gedempteInfo

    MutedInfo optioneel

    Chroom 46+

    De gedempte status van het tabblad en de reden voor de laatste statuswijziging.

  • openerTabId

    nummer optioneel

    De ID van het tabblad dat dit tabblad heeft geopend, indien van toepassing. Deze eigenschap is alleen aanwezig als het tabblad waarmee het is geopend nog bestaat.

  • in afwachting van URL

    string optioneel

    Chroom 79+

    De URL waarnaar het tabblad navigeert, voordat het is vastgelegd. Deze eigenschap is alleen aanwezig als de extensie de machtiging "tabs" heeft of hostmachtigingen voor de pagina heeft en er navigatie in behandeling is.

  • vastgepind

    Booleaanse

    Of het tabblad is vastgezet.

  • gekozen

    Booleaanse

    Verouderd

    Gebruik tabs.Tab.highlighted .

    Of het tabblad geselecteerd is.

  • sessie-ID

    string optioneel

    De sessie-ID die wordt gebruikt om een tabblad eenduidig te identificeren, verkregen via de sessions API.

  • status

    TabStatus optioneel

    De laadstatus van het tabblad.

  • titel

    string optioneel

    De titel van het tabblad. Deze eigenschap is alleen aanwezig als de extensie de machtiging "tabs" heeft of hostmachtigingen voor de pagina.

  • url

    string optioneel

    De laatst toegewezen URL van het hoofdframe van het tabblad. Deze eigenschap is alleen aanwezig als de extensie de machtiging "tabs" heeft of hostmachtigingen voor de pagina. Kan een lege tekenreeks zijn als het tabblad nog niet is toegewezen. Zie ook Tab.pendingUrl .

  • breedte

    nummer optioneel

    De breedte van het tabblad in pixels.

  • venster-ID

    nummer

    De ID van het venster dat het tabblad bevat.

TabStatus

Chroom 44+

De laadstatus van het tabblad.

Enum

"ontladen"

"laden"

"compleet"

WindowType

Chroom 44+

Het type raam.

Enum

"normaal"

"pop-up"

"paneel"

"toepassing"

"ontwikkelaars"

ZoomSettings

Bepaalt hoe zoomwijzigingen in een tabblad worden verwerkt en met welk bereik.

Eigenschappen

  • standaardZoomFactor

    nummer optioneel

    Chroom 43+

    Wordt gebruikt om het standaardzoomniveau voor het huidige tabblad te retourneren bij aanroepen van tabs.getZoomSettings.

  • modus

    ZoomSettingsMode optioneel

    Definieert hoe zoomwijzigingen worden verwerkt, d.w.z. welke entiteit verantwoordelijk is voor de daadwerkelijke schaalaanpassing van de pagina. Standaard is dit automatic .

  • domein

    ZoomSettingsScope optioneel

    Hiermee definieert u of zoomwijzigingen behouden blijven voor de oorsprong van de pagina of alleen van kracht worden op dit tabblad. Standaard wordt dit per-origin toegepast in de automatic modus en anders per-tab .

ZoomSettingsMode

Chroom 44+

Definieert hoe zoomwijzigingen worden verwerkt, d.w.z. welke entiteit verantwoordelijk is voor de daadwerkelijke schaalaanpassing van de pagina. Standaard is dit automatic .

Enum

"automatisch"
Zoomwijzigingen worden automatisch door de browser verwerkt.

"handmatig"
Overschrijft de automatische verwerking van zoomwijzigingen. De onZoomChange -gebeurtenis wordt nog steeds verzonden en het is de verantwoordelijkheid van de extensie om naar deze gebeurtenis te luisteren en de pagina handmatig te schalen. Deze modus ondersteunt geen zoomen per-origin en negeert daarom de zoominstelling van scope en gaat uit van per-tab .

"gehandicapt"
Schakelt alle zoomen in het tabblad uit. Het tabblad keert terug naar het standaard zoomniveau en alle pogingen tot zoomwijzigingen worden genegeerd.

ZoomSettingsScope

Chroom 44+

Hiermee definieert u of zoomwijzigingen behouden blijven voor de oorsprong van de pagina of alleen van kracht worden op dit tabblad. Standaard wordt dit per-origin toegepast in de automatic modus en anders per-tab .

Enum

"per oorsprong"
Zoomwijzigingen blijven behouden in de oorsprong van de ingezoomde pagina; dat wil zeggen dat alle andere tabbladen die naar dezelfde oorsprong navigeren, ook worden ingezoomd. Bovendien worden zoomwijzigingen per-origin opgeslagen bij de oorsprong. Dit betekent dat bij het navigeren naar andere pagina's in dezelfde oorsprong, deze allemaal worden ingezoomd met dezelfde zoomfactor. De reikwijdte per-origin is alleen beschikbaar in de automatic modus.

"per tabblad"
Zoomwijzigingen zijn alleen van toepassing op dit tabblad. Zoomwijzigingen op andere tabbladen hebben geen invloed op de zoomfactor van dit tabblad. Bovendien worden zoomwijzigingen per-tab gereset bij navigatie; pagina's worden bij het navigeren in een tabblad altijd geladen met hun zoomfactor per-origin .

Eigenschappen

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chroom 92+

Het maximale aantal keren dat captureVisibleTab per seconde kan worden aangeroepen. captureVisibleTab is duur en mag niet te vaak worden aangeroepen.

Waarde

2

TAB_ID_NONE

Chroom 46+

Een ID die de afwezigheid van een browsertabblad weergeeft.

Waarde

-1

TAB_INDEX_NONE

Chroom 123+

Een index die de afwezigheid van een tabindex in een tab_strip weergeeft.

Waarde

-1

Methoden

captureVisibleTab()

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

Legt het zichtbare gebied van het momenteel actieve tabblad in het opgegeven venster vast. Om deze methode aan te roepen, moet de extensie de machtiging <all_urls> of de machtiging activeTab hebben. Naast sites waartoe extensies normaal gesproken toegang hebben, stelt deze methode extensies in staat om gevoelige sites vast te leggen die anders beperkt zijn, waaronder chrome:-scheme-pagina's, pagina's van andere extensies en data:-URL's. Deze gevoelige sites kunnen alleen worden vastgelegd met de machtiging activeTab. Bestands-URL's kunnen alleen worden vastgelegd als de extensie bestandstoegang heeft gekregen.

Parameters

  • venster-ID

    nummer optioneel

    Het doelvenster. Standaard is dit het huidige venster .

  • opties

    ImageDetails optioneel

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (dataUrl: string) => void

    • dataUrl

      snaar

      Een data-URL die een afbeelding van het zichtbare gebied van het vastgelegde tabblad codeert. Kan worden toegewezen aan de 'src'-eigenschap van een HTML img element voor weergave.

Retourneren

  • Belofte<string>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

connect()

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

Maakt verbinding met het/de contentscript(s) op het opgegeven tabblad. De gebeurtenis runtime.onConnect wordt geactiveerd in elk contentscript dat op het opgegeven tabblad voor de huidige extensie wordt uitgevoerd. Zie Content Script Messaging voor meer informatie.

Parameters

  • tabbladId

    nummer

  • connectInfo

    object optioneel

    • document-ID

      string optioneel

      Chroom 106+

      Open een poort naar een specifiek document geïdentificeerd door documentId in plaats van alle frames op het tabblad.

    • frame-ID

      nummer optioneel

      Open een poort naar een specifiek frame , geïdentificeerd door frameId in plaats van alle frames op het tabblad.

    • naam

      string optioneel

      Wordt doorgegeven aan onConnect voor inhoudsscripts die luisteren naar de verbindingsgebeurtenis.

Retourneren

  • Een poort die kan worden gebruikt om te communiceren met de inhoudsscripts die op het opgegeven tabblad worden uitgevoerd. De runtime.Port -gebeurtenis van de poort wordt geactiveerd als het tabblad wordt gesloten of niet bestaat.

create()

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

Maakt een nieuw tabblad.

Parameters

  • createProperties

    voorwerp

    • actief

      boolean optioneel

      Of het tabblad het actieve tabblad in het venster moet worden. Heeft geen invloed op de focus van het venster (zie windows.update ). Standaard is dit true .

    • index

      nummer optioneel

      De positie die het lipje in het venster moet innemen. De opgegeven waarde wordt vastgelegd tussen nul en het aantal lipjes in het venster.

    • openerTabId

      nummer optioneel

      De ID van het tabblad dat dit tabblad heeft geopend. Indien opgegeven, moet het tabblad waarmee het is geopend zich in hetzelfde venster bevinden als het nieuw aangemaakte tabblad.

    • vastgepind

      boolean optioneel

      Of het tabblad moet worden vastgezet. Standaardwaarde is false

    • gekozen

      boolean optioneel

      Verouderd

      Gebruik alstublieft actief .

      Of het tabblad het geselecteerde tabblad in het venster moet worden. Standaard is dit true

    • url

      string optioneel

      De URL waarnaar het tabblad in eerste instantie moet navigeren. Volledig gekwalificeerde URL's moeten een schema bevatten (bijv. 'http://www.google.com', niet 'www.google.com'). Relatieve URL's zijn relatief ten opzichte van de huidige pagina binnen de extensie. Standaard is dit de pagina 'Nieuw tabblad'.

    • venster-ID

      nummer optioneel

      Het venster waarin het nieuwe tabblad moet worden gemaakt. Standaard is dit het huidige venster .

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (tab: Tab) => void

    • tabblad

      Tab

      Het aangemaakte tabblad.

Retourneren

  • Belofte< Tab >

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

detectLanguage()

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

Detecteert de primaire taal van de inhoud op een tabblad.

Parameters

  • tabbladId

    nummer optioneel

    Standaard wordt het actieve tabblad van het huidige venster gebruikt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (language: string) => void

    • taal

      snaar

      Een ISO-taalcode zoals en of fr . Zie kLanguageInfoTable voor een volledige lijst met talen die door deze methode worden ondersteund. De tweede tot en met vierde kolom worden gecontroleerd en de eerste niet-NULL-waarde wordt geretourneerd, behalve voor Vereenvoudigd Chinees, waarvoor zh-CN wordt geretourneerd. Voor een onbekende/ongedefinieerde taal wordt und geretourneerd.

Retourneren

  • Belofte<string>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

discard()

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

Verwijdert een tabblad uit het geheugen. Verwijderde tabbladen blijven zichtbaar op de tabbladenstrook en worden opnieuw geladen wanneer ze worden geactiveerd.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het te verwijderen tabblad. Indien opgegeven, wordt het tabblad verwijderd, tenzij het actief is of al verwijderd is. Indien weggelaten, verwijdert de browser het minst belangrijke tabblad. Dit kan mislukken als er geen verwijderbare tabbladen zijn.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (tab?: Tab) => void

    • tabblad

      Tabblad optioneel

      Het verwijderde tabblad, als het succesvol is verwijderd. Anders is het niet gedefinieerd.

Retourneren

  • Belofte< Tab | undefined>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

duplicate()

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

Dupliceert een tabblad.

Parameters

  • tabbladId

    nummer

    De ID van het tabblad dat u wilt dupliceren.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (tab?: Tab) => void

    • tabblad

      Tabblad optioneel

      Details over het gedupliceerde tabblad. De eigenschappen url , pendingUrl , title en favIconUrl worden alleen opgenomen in het tabs.Tab -object als de extensie de machtiging "tabs" of hostmachtigingen voor de pagina heeft.

Retourneren

  • Belofte< Tab | undefined>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

executeScript()

Promise ≤ MV2 Verouderd sinds Chrome 91
 
chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<any[] | undefined>

Vervangen door scripting.executeScript in Manifest V3.

Injecteert JavaScript-code in een pagina. Zie voor meer informatie de sectie over programmatische injectie in de documentatie over contentscripts.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad waarop het script moet worden uitgevoerd. Standaard is dit het actieve tabblad van het huidige venster.

  • details

    InjectDetails

    Details van het uit te voeren script. Ofwel de code ofwel de bestandseigenschap moet worden ingesteld, maar beide kunnen niet tegelijkertijd worden ingesteld.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result?: any[]) => void

    • resultaat

      any[] optioneel

      Het resultaat van het script in elk geïnjecteerd frame.

Retourneren

  • Belofte<any[] | undefined>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

get()

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

Haalt details op over het opgegeven tabblad.

Parameters

  • tabbladId

    nummer

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (tab: Tab) => void

Retourneren

  • Belofte< Tab >

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getAllInWindow()

Belofte ≤ MV2 Verouderd
 
chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
): Promise<Tab[]>

Gebruik tabs.query {windowId: windowId} .

Haalt details op over alle tabbladen in het opgegeven venster.

Parameters

  • venster-ID

    nummer optioneel

    Standaard wordt het huidige venster gebruikt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (tabs: Tab[]) => void

Retourneren

  • Belofte< Tab []>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getCurrent()

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

Haalt het tabblad op van waaruit dit script wordt aangeroepen. Retourneert undefined indien aangeroepen vanuit een niet-tabbladcontext (bijvoorbeeld een achtergrondpagina of pop-upweergave).

Parameters

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (tab?: Tab) => void

Retourneren

  • Belofte< Tab | undefined>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getSelected()

Belofte ≤ MV2 Verouderd
 
chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
): Promise<Tab>

Gebruik tabs.query {active: true} .

Haalt het tabblad op dat is geselecteerd in het opgegeven venster.

Parameters

  • venster-ID

    nummer optioneel

    Standaard wordt het huidige venster gebruikt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (tab: Tab) => void

Retourneren

  • Belofte< Tab >

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getZoom()

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

Haalt de huidige zoomfactor van een opgegeven tabblad op.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad waarvan de huidige zoomfactor moet worden opgehaald. Standaard is dit het actieve tabblad van het huidige venster.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (zoomFactor: number) => void

    • zoomFactor

      nummer

      De huidige zoomfactor van het tabblad.

Retourneren

  • Belofte<nummer>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

getZoomSettings()

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

Haalt de huidige zoominstellingen van een opgegeven tabblad op.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad waarvan de huidige zoominstellingen moeten worden opgehaald. Standaard is dit het actieve tabblad van het huidige venster.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (zoomSettings: ZoomSettings) => void

    • zoominstellingen

      Zoominstellingen

      De huidige zoominstellingen van het tabblad.

Retourneren

  • Belofte< ZoomSettings >

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

goBack()

BelofteChrome 72+
chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
): Promise<void>

Ga terug naar de vorige pagina, indien beschikbaar.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad waarmee u terugnavigeert. Standaard is dit het geselecteerde tabblad van het huidige venster.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

goForward()

BelofteChrome 72+
chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
): Promise<void>

Ga naar de volgende pagina, indien beschikbaar.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad waarmee u vooruit navigeert; standaard is dit het geselecteerde tabblad van het huidige venster.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

group()

BelofteChrome 88+
chrome.tabs.group(
  options: object,
  callback?: function,
): Promise<number>

Voegt een of meer tabbladen toe aan een opgegeven groep. Als er geen groep is opgegeven, voegt u de opgegeven tabbladen toe aan een nieuw gemaakte groep.

Parameters

  • opties

    voorwerp

    • createProperties

      object optioneel

      Configuraties voor het aanmaken van een groep. Kan niet worden gebruikt als de groupId al is opgegeven.

      • venster-ID

        nummer optioneel

        Het venster van de nieuwe groep. Standaard is dit het huidige venster.

    • groeps-ID

      nummer optioneel

      De ID van de groep waaraan de tabbladen moeten worden toegevoegd. Indien niet opgegeven, wordt er een nieuwe groep aangemaakt.

    • tabbladen

      nummer | [nummer, ...nummer[]]

      De tabblad-ID of lijst met tabblad-ID's die aan de opgegeven groep moeten worden toegevoegd.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (groupId: number) => void

    • groeps-ID

      nummer

      De ID van de groep waaraan de tabbladen zijn toegevoegd.

Retourneren

  • Belofte<nummer>

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

highlight()

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

Markeert de opgegeven tabbladen en focust op het eerste tabblad van de groep. Lijkt niets te doen als het opgegeven tabblad momenteel actief is.

Parameters

  • highlightInfo

    voorwerp

    • tabbladen

      nummer | nummer[]

      Eén of meer tabbladen om te markeren.

    • venster-ID

      nummer optioneel

      Het venster met de tabbladen.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (window: Window) => void

    • raam

      Raam

      Bevat details over het venster waarvan de tabbladen zijn gemarkeerd.

Retourneren

  • Promise< windows.Window >

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

insertCSS()

Promise ≤ MV2 Verouderd sinds Chrome 91
 
chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
): Promise<void>

Vervangen door scripting.insertCSS in Manifest V3.

Injecteert CSS in een pagina. Stijlen die met deze methode worden ingevoegd, kunnen worden verwijderd met scripting.removeCSS . Zie voor meer informatie de sectie over programmatische injectie in de documentatie over inhoudsscripts.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad waarin de CSS moet worden ingevoegd. Standaard is dit het actieve tabblad van het huidige venster.

  • details

    InjectDetails

    Details van de in te voegen CSS-tekst. Ofwel de code ofwel de bestandseigenschap moet worden ingesteld, maar beide kunnen niet tegelijkertijd worden ingesteld.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

move()

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

Verplaatst een of meer tabbladen naar een nieuwe positie binnen het venster of naar een nieuw venster. Tabbladen kunnen alleen van en naar normale (window.type === "normal") vensters worden verplaatst.

Parameters

  • tabbladen

    nummer | nummer[]

    De tabblad-ID of lijst met tabblad-ID's die moeten worden verplaatst.

  • moveProperties

    voorwerp

    • index

      nummer

      De positie waarnaar het venster moet worden verplaatst. Gebruik -1 om het tabblad aan het einde van het venster te plaatsen.

    • venster-ID

      nummer optioneel

      Standaard wordt het venster gebruikt waarin het tabblad zich op dat moment bevindt.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

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

    • tabbladen

      Tabblad | Tabblad []

      Details over de verplaatste tabbladen.

Retourneren

  • Belofte< Tab | Tab []>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

query()

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

Haalt alle tabbladen op die over de opgegeven eigenschappen beschikken, of alle tabbladen als er geen eigenschappen zijn opgegeven.

Parameters

  • queryInfo

    voorwerp

    • actief

      boolean optioneel

      Of de tabbladen actief zijn in hun vensters.

    • hoorbaar

      boolean optioneel

      Chroom 45+

      Of de tabbladen hoorbaar zijn.

    • automatisch wegwerpbaar

      boolean optioneel

      Chroom 54+

      Of de tabbladen automatisch door de browser kunnen worden verwijderd wanneer er weinig bronnen beschikbaar zijn.

    • huidig venster

      boolean optioneel

      Of de tabbladen zich in het huidige venster bevinden.

    • weggegooid

      boolean optioneel

      Chroom 54+

      Of de tabbladen worden verwijderd. Een verwijderd tabblad is een tabblad waarvan de inhoud uit het geheugen is verwijderd, maar nog steeds zichtbaar is in de tabbladenstrook. De inhoud wordt opnieuw geladen wanneer het tabblad de volgende keer wordt geactiveerd.

    • bevroren

      boolean optioneel

      Chroom 132+

      Of de tabbladen bevroren zijn. Een bevroren tabblad kan geen taken uitvoeren, inclusief gebeurtenis-handlers of timers. Het is zichtbaar in de tabbladenstrook en de inhoud ervan wordt in het geheugen geladen. Het wordt ontgrendeld bij activering.

    • groeps-ID

      nummer optioneel

      Chroom 88+

      De ID van de groep waarin de tabbladen zich bevinden, of tabGroups.TAB_GROUP_ID_NONE voor niet-gegroepeerde tabbladen.

    • gemarkeerd

      boolean optioneel

      Of de tabbladen gemarkeerd zijn.

    • index

      nummer optioneel

      De positie van de tabbladen binnen hun vensters.

    • laatsteGefocusteVenster

      boolean optioneel

      Of de tabbladen zich in het laatste geselecteerde venster bevinden.

    • gedempt

      boolean optioneel

      Chroom 45+

      Of de tabbladen gedempt zijn.

    • vastgepind

      boolean optioneel

      Of de tabbladen vastgezet zijn.

    • splitViewId

      nummer optioneel

      In behandeling

      De ID van de gesplitste weergave waarin de tabbladen zich bevinden, of tabs.SPLIT_VIEW_ID_NONE voor tabbladen die zich niet in een gesplitste weergave bevinden.

    • status

      TabStatus optioneel

      De laadstatus van het tabblad.

    • titel

      string optioneel

      Paginatitels matchen met een patroon. Deze eigenschap wordt genegeerd als de extensie geen "tabs" of hostrechten voor de pagina heeft.

    • url

      string | string[] optioneel

      Koppel tabbladen aan een of meer URL-patronen . Fragment-ID's worden niet gekoppeld. Deze eigenschap wordt genegeerd als de extensie niet de machtiging "tabs" of hostmachtigingen voor de pagina heeft.

    • venster-ID

      nummer optioneel

      De ID van het bovenliggende venster, of windows.WINDOW_ID_CURRENT voor het huidige venster .

    • vensterType

      WindowType optioneel

      Het type venster waarin de tabbladen zich bevinden.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (result: Tab[]) => void

Retourneren

  • Belofte< Tab []>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

reload()

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

Een tabblad opnieuw laden.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad dat opnieuw moet worden geladen. Standaard is dit het geselecteerde tabblad van het huidige venster.

  • herlaadeigenschappen

    object optioneel

    • bypassCache

      boolean optioneel

      Of lokale caching moet worden omzeild. Standaard is dit false .

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

remove()

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

Sluit één of meer tabbladen.

Parameters

  • tabbladen

    nummer | nummer[]

    De tabblad-ID of lijst met tabblad-ID's die u wilt sluiten.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

removeCSS()

PromiseChrome 87+ ≤ MV2 Verouderd sinds Chrome 91
 
chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
): Promise<void>

Vervangen door scripting.removeCSS in Manifest V3.

Verwijdert CSS uit een pagina die eerder is ingevoegd door een aanroep van scripting.insertCSS .

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad waarvan u de CSS wilt verwijderen. Standaard is dit het actieve tabblad van het huidige venster.

  • Details van de te verwijderen CSS-tekst. Ofwel de code ofwel de bestandseigenschap moet worden ingesteld, maar beide kunnen niet tegelijkertijd worden ingesteld.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

sendMessage()

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

Stuurt één bericht naar de contentscript(s) op het opgegeven tabblad, met een optionele callback die wordt uitgevoerd wanneer er een antwoord wordt teruggestuurd. De gebeurtenis runtime.onMessage wordt geactiveerd in elk contentscript dat op het opgegeven tabblad voor de huidige extensie wordt uitgevoerd.

Parameters

  • tabbladId

    nummer

  • bericht

    elk

    Het te verzenden bericht. Dit bericht moet een JSON-verifieerbaar object zijn.

  • opties

    object optioneel

    • document-ID

      string optioneel

      Chroom 106+

      Stuur een bericht naar een specifiek document geïdentificeerd door documentId in plaats van alle frames in het tabblad.

    • frame-ID

      nummer optioneel

      Stuur een bericht naar een specifiek frame geïdentificeerd door frameId in plaats van alle frames op het tabblad.

  • terugbellen

    functie optioneel

    Chroom 99+

    De callback ziet er als volgt uit: 

    (response: any) => void

    • antwoord

      elk

      Het JSON-responsobject dat door de handler van het bericht wordt verzonden. Als er een fout optreedt tijdens het verbinden met het opgegeven tabblad, wordt de callback aangeroepen zonder argumenten en wordt runtime.lastError ingesteld op het foutbericht.

Retourneren

  • Beloof<elke>

    Chroom 99+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

sendRequest()

Belofte ≤ MV2 Verouderd
 
chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
): Promise<any>

Gebruik runtime.sendMessage .

Stuurt één verzoek naar de contentscript(s) op het opgegeven tabblad, met een optionele callback die wordt uitgevoerd wanneer er een antwoord wordt teruggestuurd. De gebeurtenis extension.onRequest wordt geactiveerd in elk contentscript dat op het opgegeven tabblad voor de huidige extensie wordt uitgevoerd.

Parameters

  • tabbladId

    nummer

  • verzoek

    elk

  • terugbellen

    functie optioneel

    Chroom 99+

    De callback ziet er als volgt uit: 

    (response: any) => void

    • antwoord

      elk

      Het JSON-responsobject dat door de handler van de aanvraag wordt verzonden. Als er een fout optreedt tijdens het verbinden met het opgegeven tabblad, wordt de callback aangeroepen zonder argumenten en wordt runtime.lastError ingesteld op de foutmelding.

Retourneren

  • Beloof<elke>

    Chroom 99+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

setZoom()

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

Zoomt in of uit op een bepaald tabblad.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad waarop u wilt zoomen. Standaard is dit het actieve tabblad van het huidige venster.

  • zoomFactor

    nummer

    De nieuwe zoomfactor. Een waarde van 0 stelt het tabblad in op de huidige standaardzoomfactor. Waarden groter dan 0 specificeren een (mogelijk niet-standaard) zoomfactor voor het tabblad.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

setZoomSettings()

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

Stelt de zoominstellingen voor een bepaald tabblad in, die bepalen hoe zoomwijzigingen worden verwerkt. Deze instellingen worden teruggezet naar de standaardinstellingen wanneer u door het tabblad navigeert.

Parameters

  • tabbladId

    nummer optioneel

    De ID van het tabblad waarvan u de zoominstellingen wilt wijzigen. Standaard is dit het actieve tabblad van het huidige venster.

  • zoominstellingen

    Zoominstellingen

    Bepaalt hoe zoomwijzigingen worden verwerkt en met welk bereik.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

ungroup()

BelofteChrome 88+
chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
): Promise<void>

Verwijdert een of meer tabbladen uit hun respectievelijke groepen. Als groepen leeg raken, worden ze verwijderd.

Parameters

  • tabbladen

    nummer | [nummer, ...nummer[]]

    De tabblad-ID of lijst met tabblad-ID's die uit de respectievelijke groepen moeten worden verwijderd.

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    () => void

Retourneren

  • Belofte<leegte>

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

update()

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

Wijzigt de eigenschappen van een tabblad. Eigenschappen die niet in updateProperties zijn opgegeven, worden niet gewijzigd.

Parameters

  • tabbladId

    nummer optioneel

    Standaard wordt het geselecteerde tabblad van het huidige venster gebruikt.

  • updateProperties

    voorwerp

    • actief

      boolean optioneel

      Of het tabblad actief moet zijn. Heeft geen invloed op de focus van het venster (zie windows.update ).

    • automatisch wegwerpbaar

      boolean optioneel

      Chroom 54+

      Of het tabblad automatisch door de browser moet worden verwijderd wanneer er weinig bronnen beschikbaar zijn.

    • gemarkeerd

      boolean optioneel

      Voegt een tabblad toe aan de huidige selectie of verwijdert het tabblad uit de huidige selectie.

    • gedempt

      boolean optioneel

      Chroom 45+

      Of het tabblad gedempt moet worden.

    • openerTabId

      nummer optioneel

      De ID van het tabblad dat dit tabblad heeft geopend. Indien opgegeven, moet het tabblad waarmee het is geopend zich in hetzelfde venster bevinden als dit tabblad.

    • vastgepind

      boolean optioneel

      Of het tabblad moet worden vastgezet.

    • gekozen

      boolean optioneel

      Verouderd

      Gebruik gemarkeerde .

      Of het tabblad geselecteerd moet worden.

    • url

      string optioneel

      Een URL om naar het tabblad te navigeren. JavaScript-URL's worden niet ondersteund; gebruik in plaats daarvan scripting.executeScript .

  • terugbellen

    functie optioneel

    De callback ziet er als volgt uit: 

    (tab?: Tab) => void

    • tabblad

      Tabblad optioneel

      Details over het bijgewerkte tabblad. De eigenschappen url , pendingUrl , title en favIconUrl worden alleen opgenomen in het tabs.Tab -object als de extensie de machtiging "tabs" of hostmachtigingen voor de pagina heeft.

Retourneren

  • Belofte< Tab | undefined>

    Chroom 88+

    Promises worden alleen ondersteund voor Manifest V3 en hoger. Andere platforms moeten callbacks gebruiken.

Evenementen

onActivated

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

Wordt geactiveerd wanneer het actieve tabblad in een venster verandert. Houd er rekening mee dat de URL van het tabblad mogelijk nog niet is ingesteld op het moment dat deze gebeurtenis wordt geactiveerd, maar u kunt wel naar onUpdated-gebeurtenissen luisteren om een melding te ontvangen wanneer een URL is ingesteld.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (activeInfo: object) => void

    • actieveInfo

      voorwerp

      • tabbladId

        nummer

        De ID van het tabblad dat actief is geworden.

      • venster-ID

        nummer

        De ID van het venster waarin het actieve tabblad is gewijzigd.

onActiveChanged

≤ MV2 Verouderd
 
chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Gebruik tabs.onActivated .

Wordt geactiveerd wanneer het geselecteerde tabblad in een venster verandert. Houd er rekening mee dat de URL van het tabblad mogelijk nog niet is ingesteld op het moment dat deze gebeurtenis wordt geactiveerd, maar u kunt wel naar tabs.onUpdated -gebeurtenissen luisteren om een melding te ontvangen wanneer een URL wordt ingesteld.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • tabbladId

      nummer

    • selectInfo

      voorwerp

      • venster-ID

        nummer

        De ID van het venster waarin het geselecteerde tabblad is gewijzigd.

onAttached

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

Wordt geactiveerd wanneer een tabblad aan een venster wordt gekoppeld, bijvoorbeeld omdat het tussen vensters wordt verplaatst.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • tabbladId

      nummer

    • attachInfo

      voorwerp

      • nieuwe positie

        nummer

      • nieuwVensterID

        nummer

onCreated

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

Wordt geactiveerd wanneer een tabblad wordt aangemaakt. Houd er rekening mee dat de URL van het tabblad en het lidmaatschap van de tabbladgroep mogelijk nog niet zijn ingesteld op het moment dat deze gebeurtenis wordt geactiveerd. U kunt echter wel naar onUpdated-gebeurtenissen luisteren om een melding te ontvangen wanneer een URL wordt ingesteld of het tabblad aan een tabbladgroep wordt toegevoegd.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (tab: Tab) => void

onDetached

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

Wordt geactiveerd wanneer een tabblad van een venster wordt losgekoppeld, bijvoorbeeld omdat het tussen vensters is verplaatst.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • tabbladId

      nummer

    • detachInfo

      voorwerp

      • oude positie

        nummer

      • oudeVensterID

        nummer

onHighlightChanged

≤ MV2 Verouderd
 
chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Gebruik tabs.onHighlighted .

Wordt geactiveerd wanneer de gemarkeerde of geselecteerde tabbladen in een venster veranderen.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (selectInfo: object) => void

    • selectInfo

      voorwerp

      • tabbladen

        nummer[]

        Alle tabbladen in het venster zijn gemarkeerd.

      • venster-ID

        nummer

        Het venster waarvan de tabbladen zijn gewijzigd.

onHighlighted

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

Wordt geactiveerd wanneer de gemarkeerde of geselecteerde tabbladen in een venster veranderen.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (highlightInfo: object) => void

    • highlightInfo

      voorwerp

      • tabbladen

        nummer[]

        Alle tabbladen in het venster zijn gemarkeerd.

      • venster-ID

        nummer

        Het venster waarvan de tabbladen zijn gewijzigd.

onMoved

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

Wordt geactiveerd wanneer een tabblad binnen een venster wordt verplaatst. Er wordt slechts één verplaatsingsgebeurtenis geactiveerd, namelijk het tabblad dat de gebruiker rechtstreeks heeft verplaatst. Verplaatsingsgebeurtenissen worden niet geactiveerd voor de andere tabbladen die moeten worden verplaatst als reactie op het handmatig verplaatste tabblad. Deze gebeurtenis wordt niet geactiveerd wanneer een tabblad tussen vensters wordt verplaatst; zie tabs.onDetached voor meer informatie.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • tabbladId

      nummer

    • moveInfo

      voorwerp

      • vanIndex

        nummer

      • naarIndex

        nummer

      • venster-ID

        nummer

onRemoved

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

Wordt geactiveerd wanneer een tabblad wordt gesloten.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • tabbladId

      nummer

    • verwijderInfo

      voorwerp

      • isWindowClosing

        Booleaanse

        Waar wanneer het tabblad werd gesloten omdat het bovenliggende venster gesloten was.

      • venster-ID

        nummer

        Het venster waarvan het tabblad gesloten is.

onReplaced

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

Wordt geactiveerd wanneer een tabblad wordt vervangen door een ander tabblad vanwege prerendering of instant.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • toegevoegdeTabId

      nummer

    • verwijderdeTabId

      nummer

onSelectionChanged

≤ MV2 Verouderd
 
chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Gebruik tabs.onActivated .

Wordt geactiveerd wanneer het geselecteerde tabblad in een venster verandert.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • tabbladId

      nummer

    • selectInfo

      voorwerp

      • venster-ID

        nummer

        De ID van het venster waarin het geselecteerde tabblad is gewijzigd.

onUpdated

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

Wordt geactiveerd wanneer een tabblad wordt bijgewerkt.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

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

    • tabbladId

      nummer

    • changeInfo

      voorwerp

      • hoorbaar

        boolean optioneel

        Chroom 45+

        De nieuwe hoorbare status van het tabblad.

      • automatisch wegwerpbaar

        boolean optioneel

        Chroom 54+

        De nieuwe status van het tabblad, dat nu automatisch kan worden verwijderd.

      • weggegooid

        boolean optioneel

        Chroom 54+

        De nieuwe verwijderde status van het tabblad.

      • favIconUrl

        string optioneel

        De nieuwe favicon-URL van het tabblad.

      • bevroren

        boolean optioneel

        Chroom 132+

        De nieuwe bevroren status van het tabblad.

      • groeps-ID

        nummer optioneel

        Chroom 88+

        De nieuwe groep van het tabblad.

      • gedempteInfo

        MutedInfo optioneel

        Chroom 46+

        De nieuwe gedempte status van het tabblad en de reden voor de wijziging.

      • vastgepind

        boolean optioneel

        De nieuwe vastgezette status van het tabblad.

      • splitViewId

        nummer optioneel

        In behandeling

        De nieuwe gesplitste weergave van het tabblad.

      • status

        TabStatus optioneel

        De laadstatus van het tabblad.

      • titel

        string optioneel

        Chroom 48+

        De nieuwe titel van het tabblad.

      • url

        string optioneel

        De URL van het tabblad als deze is gewijzigd.

    • tabblad

      Tab

onZoomChange

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

Wordt geactiveerd wanneer er wordt ingezoomd op een tabblad.

Parameters

  • terugbellen

    functie

    De callback ziet er als volgt uit: 

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      voorwerp

      • newZoomFactor

        nummer

      • oudeZoomFactor

        nummer

      • tabbladId

        nummer

      • zoominstellingen

        Zoominstellingen