chrome.tabs

refresh date: 2026-09-25 robots: noindex

Beschrijving

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

Overzicht

De Tabs API biedt niet alleen functies om tabbladen te manipuleren en te beheren, maar kan ook de taal van het tabblad herkennen, een screenshot maken en communiceren met de contentscripts van een tabblad.

Rechten

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

Er zijn 3 rechten waar ontwikkelaars rekening mee moeten houden als ze met de Tabs API werken.

Het recht 'tabs'
Deze rechten geven geen toegang tot de naamruimte chrome.tabs. In plaats daarvan geeft het een extensie de mogelijkheid om tabs.query() aan te roepen voor 4 gevoelige property's op tabs.Tab-instanties: url, pendingUrl, title en favIconUrl.
Hostrechten
Hostrechten geven een extensie toestemming om de 4 gevoelige property's van een overeenkomend tabblad te lezen en er query's op uit te voeren. tabs.Tab Ze kunnen ook rechtstreeks communiceren met de overeenkomende tabbladen via methoden zoals tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() en tabs.removeCSS().
Het recht activeTab
activeTab geeft een extensie tijdelijke hostrechten voor het huidige tabblad als reactie op een aanroep door een gebruiker. In tegenstelling tot hostrechten activeert activeTab geen waarschuwingen.

Manifest

Hieronder staan voorbeelden van hoe je elk recht declareert in het manifest:

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


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


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

Toepassingen

In de volgende gedeelten worden enkele veelvoorkomende use cases beschreven.

Een extensiepagina openen op een nieuw tabblad

Een veelvoorkomend patroon voor extensies is om een introductiepagina te openen in een nieuw tabblad wanneer de extensie wordt geïnstalleerd. In het volgende voorbeeld ziet u hoe u dit doet.

background.js:

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

Het huidige tabblad ophalen

In dit voorbeeld zie je hoe de serviceworker van een extensie het actieve tabblad kan ophalen uit het venster dat op dat moment de focus heeft (of het venster dat het laatst de focus had, als er geen Chrome-vensters de focus hebben). Dit is meestal 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 geluid van het aangegeven tabblad uitzetten

In dit voorbeeld zie je hoe een extensie de dempingsstatus voor een bepaald tabblad kan aan- of uitzetten.

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

Het huidige tabblad naar de eerste positie verplaatsen als erop wordt geklikt

In dit voorbeeld zie je hoe je een tabblad verplaatst terwijl er wel of niet wordt gesleept. In dit voorbeeld wordt chrome.tabs.move gebruikt, maar je kunt hetzelfde wachtpatroon gebruiken voor andere aanroepen die tabbladen wijzigen terwijl er een sleepactie wordt uitgevoerd.

  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 contentscript van een geselecteerd tabblad

In dit voorbeeld zie je hoe de serviceworker van een extensie kan communiceren met contentscripts in specifieke browsertabbladen met 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 extensies

Ga naar een van de volgende bronnen voor meer demo's van extensies voor de Tabs API:

Typen

MutedInfo

Chrome 46+

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

Eigenschappen

  • extensionId

    tekenreeks optioneel

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

  • gedempt

    booleaans

    Of het geluid van het tabblad is uitgezet (er kan geen geluid worden afgespeeld). Het tabblad kan worden gedempt, zelfs als er geen geluid is afgespeeld of op dit moment geen geluid wordt afgespeeld. Komt overeen met of de audio-indicator Gedempt wordt getoond.

  • reden

    MutedInfoReason optioneel

    De reden waarom het geluid van het tabblad is aan- of uitgezet. Niet ingesteld als de dempingsstatus van het tabblad nooit is gewijzigd.

MutedInfoReason

Chrome 46+

Een gebeurtenis die een wijziging in de status van de meldingen heeft veroorzaakt.

Enum

"user"
Een gebruikersinvoeractie heeft de status Uitgezet ingesteld.

"capture"
Tabbladopname is gestart, waardoor de status is gewijzigd in gedempt.

"extension"
Een extensie, aangegeven door het veld extensionId, heeft de gedempte status ingesteld.

Tab

Eigenschappen

  • actief

    booleaans

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

  • audible

    booleaans optioneel

    Chrome 45+

    Of het tabblad de afgelopen seconden geluid heeft geproduceerd (maar het is misschien niet te horen als het ook is gedempt). Dit komt overeen met of de indicator voor de audio van de spreker wordt getoond.

  • autoDiscardable

    booleaans

    Chrome 54+

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

  • verwijderd

    booleaans

    Chrome 54+

    Of het tabblad is beëindigd. Een verwijderd tabblad is een tabblad waarvan de content uit het geheugen is verwijderd, maar dat nog steeds zichtbaar is in de tabbladstrook. De content wordt opnieuw geladen als de extensie weer wordt geactiveerd.

  • favIconUrl

    tekenreeks optioneel

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

  • vastgelopen

    booleaans

    Chrome 132+

    Of het tabblad is vastgezet. Een vastgezet tabblad kan geen taken uitvoeren, waaronder gebeurtenishandlers of timers. Het is zichtbaar in de tabbladstrip en de content is geladen in het geheugen. De link wordt ontdooid bij activering.

  • groupId

    getal

    Chrome 88+

    De ID van de groep waartoe het tabblad behoort.

  • hoogte

    number optioneel

    De hoogte van het tabblad in pixels.

  • gemarkeerd

    booleaans

    Of het tabblad is gemarkeerd.

  • id

    number optioneel

    De ID van het tabblad. Tabblad-ID's zijn uniek binnen een browsersessie. In sommige omstandigheden krijgt een tabblad geen ID, bijvoorbeeld als je externe tabbladen opvraagt via de sessions API. In dat geval kan er een sessie-ID aanwezig zijn. De tabblad-ID kan ook worden ingesteld op chrome.tabs.TAB_ID_NONE voor apps en devtools-vensters.

  • incognito

    booleaans

    Of het tabblad zich in een incognitovenster bevindt.

  • index

    getal

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

  • lastAccessed

    getal

    Chrome 121 of hoger

    De laatste keer dat het tabblad actief werd in het venster, als het aantal milliseconden sinds het tijdperk.

  • mutedInfo

    MutedInfo optioneel

    Chrome 46+

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

  • openerTabId

    number optioneel

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

  • pendingUrl

    tekenreeks optioneel

    Chrome 79+

    De URL waarnaar het tabblad navigeert, voordat deze is vastgelegd. Deze property is alleen aanwezig als de extensie het recht "tabs" heeft of hostrechten heeft voor de pagina en er een navigatie in behandeling is.

  • vastgezet

    booleaans

    Of het tabblad is vastgezet.

  • geselecteerd

    booleaans

    Beëindigd

    Gebruik tabs.Tab.highlighted.

    Of het tabblad is geselecteerd.

  • sessionId

    tekenreeks optioneel

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

  • splitViewId

    number optioneel

    Chrome 140+

    De ID van de gesplitste weergave waartoe het tabblad behoort.

  • status

    TabStatus optioneel

    De laadstatus van het tabblad.

  • titel

    tekenreeks optioneel

    De titel van het tabblad. Deze property is alleen aanwezig als de extensie het recht "tabs" heeft of hostrechten voor de pagina heeft.

  • url

    tekenreeks optioneel

    De laatste vastgelegde URL van het hoofdframe van het tabblad. Deze property is alleen aanwezig als de extensie het recht "tabs" heeft of hostrechten voor de pagina heeft. Kan een lege tekenreeks zijn als het tabblad nog niet is vastgelegd. Ga ook naar Tab.pendingUrl.

  • breedte

    number optioneel

    De breedte van het tabblad in pixels.

  • windowId

    getal

    De ID van het venster met het tabblad.

TabStatus

Chrome 44+

De laadstatus van het tabblad.

Enum

"unloaded"

"loading"

"complete"

WindowType

Chrome 44+

Het type venster.

Enum

"normal"

"popup"

"panel"

"app"

"devtools"

ZoomSettings

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

Eigenschappen

  • defaultZoomFactor

    number optioneel

    Chrome 43+

    Wordt gebruikt om het standaard zoomniveau voor het huidige tabblad te retourneren in aanroepen naar tabs.getZoomSettings.

  • modus

    ZoomSettingsMode optioneel

    Definieert hoe zoomwijzigingen worden verwerkt, d.w.z. welke entiteit verantwoordelijk is voor de daadwerkelijke schaling van de pagina. De standaardwaarde is automatic.

  • bereik

    ZoomSettingsScope optioneel

    Bepaalt of zoomwijzigingen blijven gelden voor de oorsprong van de pagina of alleen van kracht worden op dit tabblad. De standaardwaarde is per-origin in de modus automatic en anders per-tab.

ZoomSettingsMode

Chrome 44+

Definieert hoe zoomwijzigingen worden verwerkt, d.w.z. welke entiteit verantwoordelijk is voor de daadwerkelijke schaling van de pagina. De standaardwaarde is automatic.

Enum

"automatic"
Zoomwijzigingen worden automatisch verwerkt door de browser.

"manual"
Overschrijft de automatische verwerking van zoomwijzigingen. De gebeurtenis onZoomChange wordt nog steeds verzonden. Het is de verantwoordelijkheid van de extensie om naar deze gebeurtenis te luisteren en de pagina handmatig te schalen. Deze modus ondersteunt per-origin-zoomen niet. De zoominstelling scope wordt daarom genegeerd en er wordt uitgegaan van per-tab.

"disabled"
Zet alle zoomfuncties op het tabblad uit. Het tabblad wordt teruggezet naar het standaard zoomniveau en alle pogingen om het zoomniveau te wijzigen, worden genegeerd.

ZoomSettingsScope

Chrome 44+

Bepaalt of zoomwijzigingen blijven gelden voor de oorsprong van de pagina of alleen van kracht worden op dit tabblad. De standaardwaarde is per-origin in de modus automatic en anders per-tab.

Enum

per-origin
Zoomwijzigingen blijven behouden in de oorsprong van de ingezoomde pagina, d.w.z. alle andere tabbladen die naar dezelfde oorsprong zijn genavigeerd, worden ook ingezoomd. Bovendien worden wijzigingen in de zoomfactor van per-origin opgeslagen met de oorsprong. Dit betekent dat als je naar andere pagina's met dezelfde oorsprong navigeert, ze allemaal worden ingezoomd met dezelfde zoomfactor. Het bereik per-origin is alleen beschikbaar in de modus automatic.

per-tab
Zoomwijzigingen worden alleen doorgevoerd op dit tabblad en zoomwijzigingen op andere tabbladen hebben geen invloed op het zoomen op dit tabblad. Ook worden per-tab zoomwijzigingen gereset bij navigatie. Als je naar een tabblad navigeert, worden pagina's altijd geladen met de per-origin zoomfactoren.

Eigenschappen

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92+

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

Waarde

2

SPLIT_VIEW_ID_NONE

Chrome 140+

Een ID die de afwezigheid van een gesplitst tabblad vertegenwoordigt.

Waarde

-1

TAB_ID_NONE

Chrome 46+

Een ID die de afwezigheid van een browsertabblad vertegenwoordigt.

Waarde

-1

TAB_INDEX_NONE

Chrome 123 of hoger

Een index die de afwezigheid van een tabbladindex in een tabbladstrook vertegenwoordigt.

Waarde

-1

Methoden

captureVisibleTab()

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

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

Parameters

  • windowId

    number optioneel

    Het doelvenster. De standaardwaarde is het huidige venster.

  • opties

    ImageDetails optioneel

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (dataUrl: string) => void

    • dataUrl

      tekenreeks

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

Retourzendingen

  • Promise<string>

    Chrome 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 de contentscripts op het aangegeven tabblad. De gebeurtenis runtime.onConnect wordt geactiveerd in elk contentscript dat wordt uitgevoerd op het aangegeven tabblad voor de huidige extensie. Ga naar Content Script Messaging voor meer informatie.

Parameters

  • tabId

    getal

  • connectInfo

    object optioneel

    • documentId

      tekenreeks optioneel

      Chrome 106+

      Open een poort naar een specifiek document dat wordt aangegeven door documentId in plaats van alle frames op het tabblad.

    • frameId

      number optioneel

      Open een poort naar een specifiek frame dat wordt aangegeven door frameId in plaats van alle frames op het tabblad.

    • name

      tekenreeks optioneel

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

Retourzendingen

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

create()

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

Maakt een nieuw tabblad.

Parameters

  • createProperties

    object

    • actief

      booleaans optioneel

      Of het tabblad het actieve tabblad in het venster moet worden. Heeft geen invloed op of het venster de focus heeft (zie windows.update). De standaardwaarde is true.

    • index

      number optioneel

      De positie die het tabblad in het venster moet innemen. De ingevoerde waarde wordt vastgezet op een waarde tussen nul en het aantal tabbladen in het venster.

    • openerTabId

      number optioneel

      De ID van het tabblad dat dit tabblad heeft geopend. Als dit is opgegeven, moet het tabblad van de opener zich in hetzelfde venster bevinden als het nieuwe tabblad.

    • vastgezet

      booleaans optioneel

      Of het tabblad moet worden vastgezet. Standaard is false

    • geselecteerd

      booleaans optioneel

      Beëindigd

      Gebruik active.

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

    • splitWithTabId

      number optioneel

      Chrome 155+

      De ID van een bestaand tabblad waarmee je een gesplitste weergave wilt maken. Als je dit opgeeft, moet het tabblad Splitsen met aan de volgende voorwaarden voldoen:

      • Het mag geen tabblad zijn dat al is gesplitst.
      • Het moet in hetzelfde venster staan als het nieuwe tabblad.
      • Als windowId is ingevoerd, moet dit hetzelfde zijn als de venster-ID van het tabblad waarmee het scherm wordt gedeeld.
      • Als index is ingevoerd, moet dit een index zijn die grenst aan het tabblad waarmee wordt gesplitst. Dit heeft invloed op de relatieve positionering van het nieuwe tabblad.
    • url

      tekenreeks 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 in de extensie. Standaard wordt de pagina Nieuw tabblad ingesteld.

    • windowId

      number optioneel

      Het venster waarin het nieuwe tabblad moet worden gemaakt. De standaardwaarde is het huidige venster.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (tab: Tab) => void

    • tab

      Tab

      Het tabblad Maken.

Retourzendingen

  • Promise<Tab>

    Chrome 88+

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

createSplit()

Promise Chrome 155+ 
chrome.tabs.createSplit(
  tabIds: [number, number],
  callback?: function,
): Promise<number>

Splitst 2 bestaande tabbladen in een gesplitste weergave.

Parameters

  • tabIds

    [number, number]

    Een array van precies 2 tabblad-ID's die je wilt koppelen in een gesplitste weergave. Alle tabbladen moeten aan de volgende voorwaarden voldoen:

    Ze moeten aan elkaar grenzen. Ze mogen nog niet in een gesplitste weergave staan. De statussen windowId, pinned en groupId moeten overeenkomen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (splitViewId: number) => void

    • splitViewId

      getal

      De ID van de nieuwe gesplitste weergave met de aangegeven tabbladen.

Retourzendingen

  • Promise<number>

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

detectLanguage()

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

Detecteert de primaire taal van de content op een tabblad.

Parameters

  • tabId

    number optioneel

    Standaard is dit het actieve tabblad van het huidige venster.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (language: string) => void

    • taal

      tekenreeks

      Een ISO-taalcode, zoals en of fr. Ga naar kLanguageInfoTable voor een volledige lijst met talen die door deze methode worden ondersteund. De 2e tot en met de 4e 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.

Retourzendingen

  • Promise<string>

    Chrome 88+

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

discard()

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

Verwijdert een tabblad uit het geheugen. Beëindigde tabbladen zijn nog steeds zichtbaar op de tabbladstrook en worden opnieuw geladen als ze worden geactiveerd.

Parameters

  • tabId

    number optioneel

    De ID van het tabblad dat moet worden verwijderd. Als je dit opgeeft, wordt het tabblad verwijderd, tenzij het actief is of al is verwijderd. Als je dit weglaat, verwijdert de browser het minst belangrijke tabblad. Dit kan mislukken als er geen tabbladen zijn die kunnen worden verwijderd.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (tab?: Tab) => void

    • tab

      Tab optioneel

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

Retourzendingen

  • Promise<Tab | undefined>

    Chrome 88+

    Wordt opgelost nadat de bewerking is afgerond.

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

duplicate()

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

Dupliceert een tabblad.

Parameters

  • tabId

    getal

    De ID van het tabblad dat je wilt dupliceren.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (tab?: Tab) => void

    • tab

      Tab optioneel

      Details over het gedupliceerde tabblad. De property's url, pendingUrl, title en favIconUrl worden alleen opgenomen in het object tabs.Tab als de extensie het recht "tabs" of hostrechten voor de pagina heeft.

Retourzendingen

  • Promise<Tab | undefined>

    Chrome 88+

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

executeScript()

Promise &leq; MV2 Beëindigd 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. Ga naar het gedeelte programmatic injection van het document over contentscripts voor meer informatie.

Parameters

  • tabId

    number optioneel

    De ID van het tabblad waarin het script moet worden uitgevoerd. De standaardwaarde is het actieve tabblad van het huidige venster.

  • details

    InjectDetails

    Details van het script dat moet worden uitgevoerd. De code of de bestandseigenschap moet worden ingesteld, maar beide mogen niet tegelijkertijd worden ingesteld.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result?: any[]) => void

    • resultaat

      any[] optioneel

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

Retourzendingen

  • Promise<any[] | undefined>

    Chrome 88+

    Wordt opgelost nadat alle JavaScript is uitgevoerd.

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

get()

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

Hiermee worden gegevens over het aangegeven tabblad opgehaald.

Parameters

  • tabId

    getal

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (tab: Tab) => void

Retourzendingen

  • Promise<Tab>

    Chrome 88+

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

getAllInWindow()

Promise &leq; MV2 Beëindigd
chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
): Promise<Tab[]>

Gebruik tabs.query {windowId: windowId}.

Krijgt informatie over alle tabbladen in het aangegeven venster.

Parameters

  • windowId

    number optioneel

    De standaardwaarde is het huidige venster.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (tabs: Tab[]) => void

    • tabbladen

      Tab[]

Retourzendingen

  • Promise<Tab[]>

    Chrome 88+

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

getCurrent()

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

Haalt het tabblad op van waaruit deze scriptaanroep wordt gedaan. Retourneert undefined als de aanroep wordt gedaan vanuit een niet-tabbladcontext (bijvoorbeeld een achtergrondpagina of pop-upweergave).

Parameters

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (tab?: Tab) => void

    • tab

      Tab optioneel

Retourzendingen

  • Promise<Tab | undefined>

    Chrome 88+

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

getSelected()

Promise &leq; MV2 Beëindigd
chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
): Promise<Tab>

Gebruik tabs.query {active: true}.

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

Parameters

  • windowId

    number optioneel

    De standaardwaarde is het huidige venster.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (tab: Tab) => void

Retourzendingen

  • Promise<Tab>

    Chrome 88+

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

getZoom()

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

Haalt de huidige zoomfactor van een opgegeven tabblad op.

Parameters

  • tabId

    number optioneel

    De ID van het tabblad waarvan je de huidige zoomfactor wilt ophalen. De standaardwaarde is het actieve tabblad van het huidige venster.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (zoomFactor: number) => void

    • zoomFactor

      getal

      De huidige zoomfactor van het tabblad.

Retourzendingen

  • Promise<number>

    Chrome 88+

    Lost op met de huidige zoomfactor van het tabblad nadat deze is opgehaald.

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

getZoomSettings()

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

Haalt de huidige zoominstellingen van een opgegeven tabblad op.

Parameters

  • tabId

    number optioneel

    De ID van het tabblad waarvan je de huidige zoominstellingen wilt ophalen. De standaardinstelling is het actieve tabblad van het huidige venster.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (zoomSettings: ZoomSettings) => void

    • zoomSettings

      ZoomSettings

      De huidige zoominstellingen van het tabblad.

Retourzendingen

  • Promise<ZoomSettings>

    Chrome 88+

    Voert de omzetting uit met de huidige zoominstellingen van het tabblad.

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

goBack()

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

Ga terug naar de vorige pagina, als die beschikbaar is.

Parameters

  • tabId

    number optioneel

    De ID van het tabblad om terug te navigeren. De standaardinstelling is het geselecteerde tabblad van het huidige venster.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 88+

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

goForward()

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

Ga naar de volgende pagina, als die beschikbaar is.

Parameters

  • tabId

    number optioneel

    De ID van het tabblad om vooruit te navigeren. De standaardinstelling is het geselecteerde tabblad van het huidige venster.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 88+

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

group()

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

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

Parameters

  • opties

    object

    • createProperties

      object optioneel

      Configuraties om een groep te maken. Kan niet worden gebruikt als groupId al is ingevoerd.

      • windowId

        number optioneel

        Het venster van de nieuwe groep. De standaardwaarde is het huidige venster.

    • groupId

      number optioneel

      De ID van de groep waaraan je de tabbladen wilt toevoegen. Als u niets opgeeft, wordt er een nieuwe groep gemaakt.

    • tabIds

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

      De tabblad-ID of lijst met tabblad-ID's die je aan de aangegeven groep wilt toevoegen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (groupId: number) => void

    • groupId

      getal

      De ID van de groep waaraan de tabbladen zijn toegevoegd.

Retourzendingen

  • Promise<number>

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

highlight()

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

Markeert de aangegeven tabbladen en plaatst de focus op het eerste tabblad van de groep. Er gebeurt niets als het aangegeven tabblad op dat moment actief is.

Parameters

  • highlightInfo

    object

    • tabbladen

      number | number[]

      Een of meer tabbladindexen om te markeren.

    • windowId

      number optioneel

      Het venster met de tabbladen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (window: Window) => void

    • venster

      Venster

      Bevat informatie over het venster waarvan de tabbladen zijn gemarkeerd.

Retourzendingen

  • Promise<windows.Window>

    Chrome 88+

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

insertCSS()

Promise &leq; MV2 Beëindigd 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 zijn ingevoegd, kunnen worden verwijderd met scripting.removeCSS. Ga naar het gedeelte programmatic injection van het document over contentscripts voor meer informatie.

Parameters

  • tabId

    number optioneel

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

  • details

    InjectDetails

    Details van de CSS-tekst die u wilt invoegen. De code of de bestandseigenschap moet worden ingesteld, maar beide mogen niet tegelijkertijd worden ingesteld.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 88+

    Wordt opgelost als alle CSS is ingevoegd.

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

move()

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

Verplaatst een of meer tabbladen naar een nieuwe positie in het venster of naar een nieuw venster. Je kunt tabbladen alleen verplaatsen naar en van normale vensters (window.type === "normal").

Parameters

  • tabIds

    number | number[]

    De tabblad-ID of lijst met tabblad-ID's die je wilt verplaatsen.

  • moveProperties

    object

    • index

      getal

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

    • windowId

      number optioneel

      Standaard is dit het venster waarin het tabblad zich op dat moment bevindt.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

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

    • tabbladen

      Tab | Tab[]

      Details over de verplaatste tabbladen.

Retourzendingen

  • Promise<Tab | Tab[]>

    Chrome 88+

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

query()

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

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

Parameters

  • queryInfo

    object

    • actief

      booleaans optioneel

      Of de tabbladen actief zijn in de vensters.

    • audible

      booleaans optioneel

      Chrome 45+

      Of de tabbladen hoorbaar zijn.

    • autoDiscardable

      booleaans optioneel

      Chrome 54+

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

    • currentWindow

      booleaans optioneel

      Of de tabbladen zich in het huidige venster bevinden.

    • verwijderd

      booleaans optioneel

      Chrome 54+

      Of de tabbladen worden verwijderd. Een verwijderd tabblad is een tabblad waarvan de content uit het geheugen is verwijderd, maar dat nog steeds zichtbaar is in de tabbladstrook. De content wordt opnieuw geladen als de extensie weer wordt geactiveerd.

    • vastgelopen

      booleaans optioneel

      Chrome 132+

      Of de tabbladen zijn bevroren. Een vastgezet tabblad kan geen taken uitvoeren, waaronder gebeurtenishandlers of timers. Het is zichtbaar in de tabbladstrip en de content is geladen in het geheugen. De link wordt ontdooid bij activering.

    • groupId

      number optioneel

      Chrome 88+

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

    • gemarkeerd

      booleaans optioneel

      Of de tabbladen zijn gemarkeerd.

    • index

      number optioneel

      De positie van de tabbladen in de vensters.

    • lastFocusedWindow

      booleaans optioneel

      Of de tabbladen zich in het laatste gefocuste venster bevinden.

    • gedempt

      booleaans optioneel

      Chrome 45+

      Of de tabbladen op stil staan.

    • vastgezet

      booleaans optioneel

      Of de tabbladen zijn vastgezet.

    • splitViewId

      number optioneel

      Chrome 140+

      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

      tekenreeks optioneel

      Paginatitels vergelijken met een patroon. Deze property wordt genegeerd als de extensie niet het recht "tabs" of hostrechten voor de pagina heeft.

    • url

      string | string[] optioneel

      Tabbladen matchen met een of meer URL-patronen. Fragment-ID's worden niet gematcht. Deze property wordt genegeerd als de extensie niet het recht "tabs" of hostrechten voor de pagina heeft.

    • windowId

      number optioneel

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

    • windowType

      WindowType optioneel

      Het type venster waarin de tabbladen zich bevinden.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (result: Tab[]) => void

    • resultaat

      Tab[]

Retourzendingen

  • Promise<Tab[]>

    Chrome 88+

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

reload()

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

Een tabblad opnieuw laden.

Parameters

  • tabId

    number optioneel

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

  • reloadProperties

    object optioneel

    • bypassCache

      booleaans optioneel

      Of lokale caching moet worden overgeslagen. De standaardwaarde is false.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 88+

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

remove()

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

Sluit een of meer tabbladen.

Parameters

  • tabIds

    number | number[]

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

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 88+

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

removeCSS()

Promise Chrome 87+ &leq; MV2 Beëindigd sinds Chrome 91
chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
): Promise<void>

Vervangen door scripting.removeCSS in Manifest V3.

Verwijdert CSS van een pagina die eerder is geïnjecteerd door een aanroep van scripting.insertCSS.

Parameters

  • tabId

    number optioneel

    De ID van het tabblad waaruit de CSS moet worden verwijderd. De standaardwaarde is het actieve tabblad van het huidige venster.

  • Details van de CSS-tekst die je wilt verwijderen. De code of de bestandseigenschap moet worden ingesteld, maar beide mogen niet tegelijkertijd worden ingesteld.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 88+

    Wordt opgelost als alle CSS is verwijderd.

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

sendMessage()

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

Stuurt één bericht naar de contentscripts op het aangegeven tabblad. De gebeurtenis runtime.onMessage wordt geactiveerd in elk contentscript dat wordt uitgevoerd op het aangegeven tabblad voor de huidige extensie.

Parameters

  • tabId

    getal

  • bericht

    alle

    Het bericht dat je wilt sturen. Dit bericht moet een json-object zijn.

  • opties

    object optioneel

    • documentId

      tekenreeks optioneel

      Chrome 106+

      Stuur een bericht naar een specifiek document dat wordt aangegeven door documentId in plaats van naar alle frames op het tabblad.

    • frameId

      number optioneel

      Stuur een bericht naar een specifiek frame dat wordt aangegeven door frameId in plaats van naar alle frames op het tabblad.

  • callback

    functie optioneel

    Chrome 99 of hoger

    De parameter callback ziet er zo uit: 

    (response: any) => void

    • reactie

      alle

      Het JSON-antwoordobject dat is gestuurd door de verwerker van het bericht.

Retourzendingen

  • Promise<any>

    Chrome 99 of hoger

    Promise die wordt opgelost met de reactie van het contentscript. Als er een fout optreedt tijdens het maken van verbinding met het opgegeven tabblad, wordt de promise afgewezen.

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

sendRequest()

Promise &leq; MV2 Beëindigd
chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
): Promise<any>

Gebruik runtime.sendMessage.

Stuurt één verzoek naar de contentscripts op het aangegeven tabblad, met een optionele callback die wordt uitgevoerd als er een reactie wordt teruggestuurd. De gebeurtenis extension.onRequest wordt geactiveerd in elk contentscript dat wordt uitgevoerd op het aangegeven tabblad voor de huidige extensie.

Parameters

  • tabId

    getal

  • verzoek

    alle

  • callback

    functie optioneel

    Chrome 99 of hoger

    De parameter callback ziet er zo uit: 

    (response: any) => void

    • reactie

      alle

      Het json-reactieobject dat is gestuurd door de verwerker van het verzoek. Als er een fout optreedt tijdens het maken van verbinding met het opgegeven tabblad, wordt de promise afgewezen.

Retourzendingen

  • Promise<any>

    Chrome 99 of hoger

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

setZoom()

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

Zoomt in op een opgegeven tabblad.

Parameters

  • tabId

    number optioneel

    De ID van het tabblad waarop je wilt zoomen. De standaardinstelling is het actieve tabblad van het huidige venster.

  • zoomFactor

    getal

    De nieuwe zoomfactor. De waarde 0 stelt het tabblad in op de huidige standaard zoomfactor. Waarden hoger dan 0 geven een (mogelijk niet-standaard) zoomfactor voor het tabblad aan.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 88+

    Wordt opgelost nadat de zoomfactor is gewijzigd.

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

setZoomSettings()

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

Hiermee stel je de zoominstellingen in voor een bepaald tabblad. Deze bepalen hoe zoomwijzigingen worden verwerkt. Deze instellingen worden gereset naar de standaardwaarden als je naar het tabblad gaat.

Parameters

  • tabId

    number optioneel

    De ID van het tabblad waarvoor je de zoominstellingen wilt wijzigen. De standaardinstelling is het actieve tabblad van het huidige venster.

  • zoomSettings

    ZoomSettings

    Bepaalt hoe zoomwijzigingen worden verwerkt en op welk niveau.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

    Chrome 88+

    Dit wordt opgelost nadat de zoominstellingen zijn gewijzigd.

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

ungroup()

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

Verwijdert een of meer tabbladen uit de respectieve groepen. Als groepen leeg worden, worden ze verwijderd.

Parameters

  • tabIds

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

    De tabblad-ID of lijst met tabblad-ID's die je uit de respectieve groepen wilt verwijderen.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

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

unsplit()

Promise Chrome 155+ 
chrome.tabs.unsplit(
  splitViewId: number,
  callback?: function,
): Promise<void>

Hiermee worden de tabbladen in een gesplitste weergave gescheiden in onafhankelijke tabbladen.

Parameters

  • splitViewId

    getal

    De ID van de gesplitste weergave die je wilt scheiden.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    () => void

Retourzendingen

  • Promise<void>

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

update()

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

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

Parameters

  • tabId

    number optioneel

    Standaard wordt het geselecteerde tabblad van het huidige venster gebruikt.

  • updateProperties

    object

    • actief

      booleaans optioneel

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

    • autoDiscardable

      booleaans optioneel

      Chrome 54+

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

    • gemarkeerd

      booleaans optioneel

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

    • gedempt

      booleaans optioneel

      Chrome 45+

      Of het geluid van het tabblad moet worden uitgezet.

    • openerTabId

      number optioneel

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

    • vastgezet

      booleaans optioneel

      Of het tabblad moet worden vastgezet.

    • geselecteerd

      booleaans optioneel

      Beëindigd

      Gebruik gemarkeerd.

      Of het tabblad moet worden geselecteerd.

    • url

      tekenreeks optioneel

      Een URL waarnaar het tabblad moet navigeren. JavaScript-URL's worden niet ondersteund. Gebruik in plaats daarvan scripting.executeScript.

  • callback

    functie optioneel

    De parameter callback ziet er zo uit: 

    (tab?: Tab) => void

    • tab

      Tab optioneel

      Details over het geüpdatete tabblad. De property's url, pendingUrl, title en favIconUrl worden alleen opgenomen in het object tabs.Tab als de extensie het recht "tabs" of hostrechten voor de pagina heeft.

Retourzendingen

  • Promise<Tab | undefined>

    Chrome 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 als het actieve tabblad in een venster verandert. De URL van het tabblad is misschien niet ingesteld op het moment dat deze gebeurtenis wordt geactiveerd, maar je kunt luisteren naar onUpdated-gebeurtenissen om een melding te krijgen wanneer een URL wordt ingesteld.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (activeInfo: object) => void

    • activeInfo

      object

      • tabId

        getal

        De ID van het tabblad dat actief is geworden.

      • windowId

        getal

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

onActiveChanged

&leq; MV2 Beëindigd
chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Gebruik tabs.onActivated.

Wordt geactiveerd als het geselecteerde tabblad in een venster verandert. De URL van het tabblad is misschien niet ingesteld op het moment dat deze gebeurtenis wordt geactiveerd, maar je kunt luisteren naar tabs.onUpdated-gebeurtenissen om een melding te krijgen als er een URL is ingesteld.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • tabId

      getal

    • selectInfo

      object

      • windowId

        getal

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

onAttached

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

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

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • tabId

      getal

    • attachInfo

      object

      • newPosition

        getal

      • newWindowId

        getal

onCreated

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

Wordt geactiveerd als een tabblad wordt gemaakt. De URL van het tabblad en het lidmaatschap van de tabbladgroep zijn misschien niet ingesteld op het moment dat deze gebeurtenis wordt geactiveerd, maar je kunt luisteren naar onUpdated-gebeurtenissen om een melding te krijgen als een URL is ingesteld of het tabblad is toegevoegd aan een tabbladgroep.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (tab: Tab) => void

onDetached

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

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

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • tabId

      getal

    • detachInfo

      object

      • oldPosition

        getal

      • oldWindowId

        getal

onHighlightChanged

&leq; MV2 Beëindigd
chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Gebruik tabs.onHighlighted.

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

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (selectInfo: object) => void

    • selectInfo

      object

      • tabIds

        number[]

        Alle gemarkeerde tabbladen in het venster.

      • windowId

        getal

        Het venster waarvan de tabbladen zijn gewijzigd.

onHighlighted

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

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

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (highlightInfo: object) => void

    • highlightInfo

      object

      • tabIds

        number[]

        Alle gemarkeerde tabbladen in het venster.

      • windowId

        getal

        Het venster waarvan de tabbladen zijn gewijzigd.

onMoved

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

Wordt geactiveerd als een tabblad binnen een venster wordt verplaatst. Er wordt maar één verplaatsingsgebeurtenis geactiveerd, die het tabblad vertegenwoordigt 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 als een tabblad tussen vensters wordt verplaatst. Ga naar tabs.onDetached voor meer informatie.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • tabId

      getal

    • moveInfo

      object

      • fromIndex

        getal

      • toIndex

        getal

      • windowId

        getal

onRemoved

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

Wordt geactiveerd als een tabblad wordt gesloten.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • tabId

      getal

    • removeInfo

      object

      • isWindowClosing

        booleaans

        Waar als het tabblad is gesloten omdat het bovenliggende venster is gesloten.

      • windowId

        getal

        Het venster waarvan het tabblad is gesloten.

onReplaced

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

Wordt geactiveerd als een tabblad wordt vervangen door een ander tabblad vanwege pre-rendering of instant.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • addedTabId

      getal

    • removedTabId

      getal

onSelectionChanged

&leq; MV2 Beëindigd
chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Gebruik tabs.onActivated.

Wordt geactiveerd als het geselecteerde tabblad in een venster verandert.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • tabId

      getal

    • selectInfo

      object

      • windowId

        getal

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

onUpdated

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

Wordt geactiveerd als een tabblad wordt geüpdatet.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

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

    • tabId

      getal

    • changeInfo

      object

      • audible

        booleaans optioneel

        Chrome 45+

        De nieuwe hoorbare status van het tabblad.

      • autoDiscardable

        booleaans optioneel

        Chrome 54+

        De nieuwe status voor automatisch verwijderen van het tabblad.

      • verwijderd

        booleaans optioneel

        Chrome 54+

        De nieuwe beëindigde status van het tabblad.

      • favIconUrl

        tekenreeks optioneel

        De nieuwe favicon-URL van het tabblad.

      • vastgelopen

        booleaans optioneel

        Chrome 132+

        De nieuwe bevroren status van het tabblad.

      • groupId

        number optioneel

        Chrome 88+

        De nieuwe groep van het tabblad.

      • mutedInfo

        MutedInfo optioneel

        Chrome 46+

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

      • vastgezet

        booleaans optioneel

        De nieuwe vastgezette status van het tabblad.

      • splitViewId

        number optioneel

        Chrome 140+

        De nieuwe gesplitste weergave van het tabblad.

      • status

        TabStatus optioneel

        De laadstatus van het tabblad.

      • titel

        tekenreeks optioneel

        Chrome 48+

        De nieuwe titel van het tabblad.

      • url

        tekenreeks optioneel

        De URL van het tabblad als deze is gewijzigd.

    • tab

      Tab

onZoomChange

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

Wordt geactiveerd als er wordt ingezoomd op een tabblad.

Parameters

  • callback

    functie

    De parameter callback ziet er zo uit: 

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      object

      • newZoomFactor

        getal

      • oldZoomFactor

        getal

      • tabId

        getal

      • zoomSettings

        ZoomSettings