chrome.tabs

Descrizione

Utilizza l'API chrome.tabs per interagire con il sistema di schede del browser. Puoi utilizzare questa API per creare, modificare e riordinare le schede nel browser.

L'API Tabs non solo offre funzionalità per la manipolazione e la gestione delle schede, ma è anche in grado di rilevare lingua della scheda, acquisisci uno screenshot e comunicare con gli script di contenuti di una scheda.

Autorizzazioni

La maggior parte delle funzionalità non richiede alcuna autorizzazione per l'utilizzo. Ad esempio, crei una nuova scheda. ricaricare una scheda, navigare a un altro URL e così via.

Esistono tre autorizzazioni di cui gli sviluppatori devono essere a conoscenza quando lavorano con l'API Tabs.

Le "schede" autorizzazione

Questa autorizzazione non concede l'accesso allo spazio dei nomi chrome.tabs. Invece, concede a un'estensione la possibilità di chiamare tabs.query() su quattro proprietà sensibili nelle istanze tabs.Tab: url, pendingUrl, title e favIconUrl.

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

Le autorizzazioni host consentono a un'estensione di leggere ed eseguire query sui quattro dati sensibili di una scheda corrispondente tabs.Tab proprietà. Possono anche interagire direttamente con le schede corrispondenti usando metodi quali come tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() e tabs.removeCSS().

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

activeTab concede l'autorizzazione di hosting temporanea dell'estensione per la scheda corrente in risposta alla chiamata di un utente. A differenza delle autorizzazioni dell'host, activeTab non attiva alcun avviso.

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

Casi d'uso

Le sezioni seguenti illustrano alcuni casi d'uso comuni.

Apri la pagina di un'estensione in una nuova scheda

Un pattern comune per le estensioni è l'apertura di una pagina di onboarding in una nuova scheda quando l'estensione viene installato. L'esempio seguente mostra come eseguire questa operazione.

background.js:

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

Scarica la scheda corrente

Questo esempio mostra come il service worker di un'estensione può recuperare la scheda attiva dalla finestra attualmente attiva (o finestra evidenziata più di recente, se non sono presenti finestre di Chrome selezionate). Questo può essere generalmente considerata la scheda corrente dell'utente.

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

Disattiva l'audio della scheda specificata

Questo esempio mostra come un'estensione può attivare/disattivare lo stato con audio disattivato per una determinata scheda.

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

Sposta la scheda corrente in prima posizione quando fai clic

Questo esempio mostra come spostare una scheda mentre è in corso un trascinamento. Anche se in questo esempio usa chrome.tabs.move, puoi usare lo stesso pattern di attesa per le altre chiamate che modificano le schede mentre è in corso un trascinamento.

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

Trasmetti un messaggio allo script dei contenuti di una scheda selezionata

Questo esempio mostra come il service worker di un'estensione può comunicare con gli script di contenuti in specifiche schede del browser utilizzando 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.
}

Esempi di estensioni

Per altre demo sulle estensioni dell'API Tabs, esplora una delle seguenti opzioni:

Tipi

MutedInfo

Chrome 46 e versioni successive .

Lo stato disattivato della scheda e il motivo dell'ultima modifica dello stato.

Proprietà

  • extensionId

    stringa facoltativo

    L'ID dell'estensione che ha modificato lo stato con audio disattivato. Non impostata se l'estensione non è stata il motivo per cui lo stato disattivato per l'ultima volta è cambiato.

  • audio disattivato

    booleano

    Se l'audio della scheda è disattivato (non è possibile riprodurre il suono). L'audio della scheda potrebbe essere disattivato anche se non è stata riprodotta o se l'audio non è in riproduzione. Equivale se l'audio è "disattivato" l'indicatore audio viene visualizzato.

  • motivo

    MutedInfoReason facoltativo

    Il motivo per cui l'audio della scheda è stato disattivato o riattivato. Non impostato se la disattivazione dell'audio della scheda non è mai stata modificata.

MutedInfoReason

Chrome 46 e versioni successive .

Un evento che ha causato un cambiamento di stato con audio disattivato.

Enum

"user"
Un'azione di input dell'utente ha impostato lo stato disattivato.

"capture"
L'acquisizione della scheda è stata avviata, forzando la modifica dello stato con audio disattivato.

"extension"
Un'estensione, identificata dal campo ExtensionId, imposta lo stato con audio disattivato.

Tab

Proprietà

  • attivo

    booleano

    Se la scheda è attiva nella relativa finestra. Ciò non significa necessariamente che la finestra sia attiva.

  • audible

    booleano facoltativo

    Chrome 45 e versioni successive .

    Se la scheda ha prodotto audio negli ultimi due secondi (ma potrebbe non essere udibile se l'audio è disattivato). Equivale a se il valore di "audio altoparlante" viene visualizzato l'indicatore di stato.

  • autoDiscardable

    booleano

    Chrome 54 e versioni successive .

    Indica se la scheda può essere ignorata automaticamente dal browser quando le risorse sono scarse.

  • ignorato

    booleano

    Chrome 54 e versioni successive .

    Se la scheda viene eliminata. Una scheda eliminata è una scheda i cui contenuti sono stati scaricati dalla memoria, ma è ancora visibile nella tabstrip. I relativi contenuti vengono ricaricati alla successiva attivazione.

  • favIconUrl

    stringa facoltativo

    L'URL della favicon della scheda. Questa proprietà è presente solo se il file manifest dell'estensione include l'autorizzazione "tabs". Potrebbe anche essere una stringa vuota se la scheda è in fase di caricamento.

  • groupId

    numero

    Chrome 88 e versioni successive .

    L'ID del gruppo a cui appartiene la scheda.

  • altezza

    numero facoltativo

    L'altezza della scheda in pixel.

  • in evidenza

    booleano

    Se la scheda è evidenziata.

  • id

    numero facoltativo

    L'ID della scheda. Gli ID scheda sono univoci all'interno di una sessione del browser. In alcuni casi non è possibile assegnare un ID a una scheda. ad esempio quando si eseguono query su schede esterne utilizzando l'API sessions, nel qual caso potrebbe essere presente un ID sessione. L'ID scheda può essere impostato anche su chrome.tabs.TAB_ID_NONE per le app e le finestre DevTools.

  • in incognito

    booleano

    Se la scheda è in una finestra di navigazione in incognito.

  • indice

    numero

    L'indice in base zero della scheda all'interno della relativa finestra.

  • lastAccessed

    numero

    Chrome 121 e versioni successive .

    L'ultima volta che è stato eseguito l'accesso alla scheda, espresso in millisecondi dall'epoca.

  • mutedInfo

    MutedInfo facoltativo

    Chrome 46 e versioni successive .

    Lo stato disattivato della scheda e il motivo dell'ultima modifica dello stato.

  • openerTabId

    numero facoltativo

    L'ID della scheda che ha aperto questa scheda, se presente. Questa proprietà è presente solo se la scheda di apertura esiste ancora.

  • pendingUrl

    stringa facoltativo

    Chrome 79 e versioni successive .

    L'URL a cui accede la scheda, prima del commit. Questa proprietà è presente solo se il file manifest dell'estensione include l'autorizzazione "tabs" ed è presente una navigazione in attesa.

  • fissata

    booleano

    Se la scheda è bloccata.

  • selezionato

    booleano

    Obsoleta

    Utilizza tabs.Tab.highlighted.

    Se la scheda è selezionata.

  • sessionId

    stringa facoltativo

    L'ID sessione utilizzato per identificare in modo univoco una scheda ottenuta dall'API sessions.

  • stato

    TabStatus facoltativo

    Lo stato di caricamento della scheda.

  • titolo

    stringa facoltativo

    Il titolo della scheda. Questa proprietà è presente solo se il file manifest dell'estensione include l'autorizzazione "tabs".

  • url

    stringa facoltativo

    L'ultimo URL di cui è stato eseguito il commit del frame principale della scheda. Questa proprietà è presente solo se il file manifest dell'estensione include l'autorizzazione "tabs" e potrebbe essere una stringa vuota se non è stato ancora eseguito il commit della scheda. Vedi anche Tab.pendingUrl.

  • larghezza

    numero facoltativo

    La larghezza della scheda in pixel.

  • windowId

    numero

    L'ID della finestra che contiene la scheda.

TabStatus

Chrome 44 e versioni successive .

Lo stato di caricamento della scheda.

Enum

"unload"

"caricamento"

"completato"

WindowType

Chrome 44 e versioni successive .

Il tipo di finestra.

Enum

"normale"

"popup"

"riquadro"

"app"

"devtools"

ZoomSettings

Definisce la modalità di gestione delle modifiche allo zoom in una scheda e l'ambito.

Proprietà

  • defaultZoomFactor

    numero facoltativo

    Chrome 43 e versioni successive .

    Utilizzato per ripristinare il livello di zoom predefinito per la scheda corrente nelle chiamate a tabs.getZoomSettings.

  • modalità

    ZoomSettingsMode optional

    Definisce la modalità di gestione delle modifiche allo zoom, ad esempio quale entità è responsabile del ridimensionamento effettivo della pagina. il valore predefinito è automatic.

  • ambito

    ZoomSettingsScope facoltativo

    Definisce se le modifiche allo zoom vengono mantenute per l'origine della pagina o se hanno effetto solo in questa scheda. il valore predefinito è per-origin in modalità automatic e per-tab negli altri casi.

ZoomSettingsMode

Chrome 44 e versioni successive .

Definisce la modalità di gestione delle modifiche allo zoom, ad esempio quale entità è responsabile del ridimensionamento effettivo della pagina. il valore predefinito è automatic.

Enum

"automatico"
Le modifiche dello zoom vengono gestite automaticamente dal browser.

"manual"
Sostituisce la gestione automatica delle modifiche allo zoom. L'evento onZoomChange verrà comunque inviato ed è responsabilità dell'estensione ascoltare questo evento e scalare manualmente la pagina. Questa modalità non supporta lo zoom per-origin. Di conseguenza, l'impostazione dello zoom scope viene ignorata e ipotizza per-tab.

"disattivato"
Disattiva tutte le opzioni di zoom nella scheda. Viene ripristinato il livello di zoom predefinito della scheda e tutti i tentativi di modifica dello zoom vengono ignorati.

ZoomSettingsScope

Chrome 44 e versioni successive .

Definisce se le modifiche allo zoom vengono mantenute per l'origine della pagina o se hanno effetto solo in questa scheda. il valore predefinito è per-origin in modalità automatic e per-tab negli altri casi.

Enum

"per-origin"
Le modifiche dello zoom vengono mantenute nell'origine della pagina con lo zoom, ad esempio vengono ingrandite anche tutte le altre schede navigate verso la stessa origine. Inoltre, le modifiche allo zoom di per-origin vengono salvate con l'origine, il che significa che quando passi ad altre pagine nella stessa origine, vengono tutte ingrandite con lo stesso fattore di zoom. L'ambito per-origin è disponibile solo in modalità automatic.

"per scheda"
Le modifiche relative allo zoom vengono applicate soltanto a questa scheda e le modifiche allo zoom nelle altre schede non influiscono sullo zoom di questa scheda. Inoltre, le modifiche allo zoom di per-tab vengono reimpostate durante la navigazione. la navigazione in una scheda carica sempre le pagine con i relativi fattori di zoom per-origin.

Proprietà

MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND

Chrome 92 e versioni successive .

Il numero massimo di chiamate captureVisibleTab al secondo. captureVisibleTab è costoso e non deve essere chiamato troppo spesso.

Valore

2

TAB_ID_NONE

Chrome 46 e versioni successive .

Un ID che rappresenta l'assenza di una scheda del browser.

Valore

-1

TAB_INDEX_NONE

Chrome 123 e versioni successive .

Un indice che rappresenta l'assenza di un indice di tabulazione in una tab_strip.

Valore

-1

Metodi

captureVisibleTab()

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

Acquisisce l'area visibile della scheda attualmente attiva nella finestra specificata. Per chiamare questo metodo, l'estensione deve avere l'autorizzazione <all_urls> o activeTab. Oltre ai siti a cui le estensioni possono normalmente accedere, questo metodo consente alle estensioni di acquisire siti sensibili che altrimenti potrebbero essere soggetti a limitazioni, incluse le pagine chrome:-scheme e altre estensioni. pagine e dati: URL. Questi siti sensibili possono essere acquisiti solo con l'autorizzazione ActiveTab. Gli URL dei file possono essere acquisiti solo se all'estensione è stato concesso l'accesso ai file.

Parametri

  • windowId

    numero facoltativo

    La finestra di destinazione. Il valore predefinito è la finestra attuale.

  • opzioni

    ImageDetails facoltativo

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (dataUrl: string) => void

    • dataUrl

      stringa

      Un URL di dati che codifica un'immagine dell'area visibile della scheda acquisita. Può essere assegnato all'account "src" di un elemento HTML img per la visualizzazione.

Resi

  • Promise<string>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

connect()

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

Si connette agli script dei contenuti nella scheda specificata. L'evento runtime.onConnect viene attivato in ogni script di contenuti in esecuzione nella scheda specificata per l'estensione corrente. Per maggiori dettagli, consulta Messaggi relativi a Content Script.

Parametri

  • tabId

    numero

  • connectInfo

    oggetto facoltativo

    • documentId

      stringa facoltativo

      Chrome 106 e versioni successive .

      Apri una porta verso un documento specifico identificato da documentId anziché tutti i frame nella scheda.

    • frameId

      numero facoltativo

      Apri una porta che rimanda a un frame specifico identificato da frameId anziché a tutti i frame nella scheda.

    • nome

      stringa facoltativo

      Viene trasmesso a onConnect per gli script di contenuti che stanno ascoltando l'evento di connessione.

Resi

  • Una porta che può essere utilizzata per comunicare con gli script di contenuti in esecuzione nella scheda specificata. L'evento runtime.Port della porta viene attivato se la scheda si chiude o non esiste.

create()

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

Crea una nuova scheda.

Parametri

  • createProperties

    oggetto

    • attivo

      booleano facoltativo

      Indica se la scheda deve diventare la scheda attiva nella finestra. Non influisce sull'effetto della finestra (vedi windows.update). Il valore predefinito è true.

    • indice

      numero facoltativo

      La posizione che la scheda deve assumere all'interno della finestra. Il valore fornito è bloccato tra zero e il numero di tabulazioni nella finestra.

    • openerTabId

      numero facoltativo

      L'ID della scheda che ha aperto questa scheda. Se specificata, la scheda di apertura deve trovarsi nella stessa finestra della scheda appena creata.

    • fissata

      booleano facoltativo

      Indica se la scheda deve essere bloccata. Il valore predefinito è false

    • selezionato

      booleano facoltativo

      Obsoleta

      Utilizza active.

      Indica se la scheda deve diventare la scheda selezionata nella finestra. Il valore predefinito è true

    • url

      stringa facoltativo

      L'URL in cui andare inizialmente nella scheda. Gli URL completi devono includere uno schema (ad es. "http://www.google.com", non "www.google.com"). Gli URL relativi sono relativi alla pagina corrente all'interno dell'estensione. Il valore predefinito è la pagina Nuova scheda.

    • windowId

      numero facoltativo

      La finestra in cui creare la nuova scheda. Il valore predefinito è la finestra attuale.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (tab: Tab) => void

    • tab

      Scheda

      La scheda creata.

Resi

  • Promesso<Tab>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

detectLanguage()

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

Rileva la lingua principale dei contenuti di una scheda.

Parametri

  • tabId

    numero facoltativo

    Il valore predefinito è la scheda attiva della finestra corrente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (language: string) => void

    • language

      stringa

      Un codice lingua ISO, ad esempio en o fr. Per un elenco completo delle lingue supportate da questo metodo, vedi kLanguageInfoTable. Le colonne dalla seconda alla quarta colonna vengono controllate e viene restituito il primo valore non NULL, ad eccezione del cinese semplificato per cui viene restituito zh-CN. Per una lingua sconosciuta/non definita, viene restituito und.

Resi

  • Promise&lt;string&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

discard()

Promesso Chrome 54 e versioni successive 
chrome.tabs.discard(
  tabId?: number,
  callback?: function,
)

Elimina una scheda dalla memoria. Le schede eliminate rimangono visibili nella tabstrip e vengono ricaricate quando vengono attivate.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda da ignorare. Se specificato, la scheda viene eliminata a meno che non sia attiva o già eliminata. Se omesso, il browser ignora la scheda meno importante. Questa operazione può non riuscire se non esistono schede annullabili.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (tab?: Tab) => void

    • tab

      Scheda facoltativa

      La scheda eliminata, se è stata eliminata correttamente. altrimenti indefinito.

Resi

  • Promesso<Tab | non definito>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

duplicate()

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

Duplica una scheda.

Parametri

  • tabId

    numero

    L'ID della scheda da duplicare.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (tab?: Tab) => void

    • tab

      Scheda facoltativa

      Dettagli sulla scheda duplicata. L'oggetto tabs.Tab non contiene url, pendingUrl, title e favIconUrl se l'autorizzazione "tabs" non è stata richiesta.

Resi

  • Promesso<Tab | non definito>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

executeScript()

Promesso &amp;leq; MV2 Ritirato da Chrome 91
chrome.tabs.executeScript(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Sostituito da scripting.executeScript in Manifest V3.

Inserisce il codice JavaScript in una pagina. Per maggiori dettagli, consulta la sezione sull'inserimento programmatico del documento sugli script di contenuti.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda in cui eseguire lo script; viene impostata per impostazione predefinita la scheda attiva della finestra corrente.

  • dettagli

    InjectDetails

    Dettagli dello script da eseguire. È necessario impostare il codice o la proprietà del file, ma non possono essere impostati entrambi contemporaneamente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result?: any[]) => void

    • risultato

      qualsiasi[] facoltativo

      Il risultato dello script in ogni frame inserito.

Resi

  • Promise&lt;any[] | non definito>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

get()

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

Recupera i dettagli sulla scheda specificata.

Parametri

  • tabId

    numero

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (tab: Tab) => void

Resi

  • Promesso<Tab>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getAllInWindow()

Promesso &amp;leq; MV2 Deprecato
chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

Utilizza tabs.query {windowId: windowId}.

Recupera i dettagli di tutte le schede nella finestra specificata.

Parametri

  • windowId

    numero facoltativo

    Il valore predefinito è la finestra attuale.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (tabs: Tab[]) => void

Resi

  • Promesso<Tab[]>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getCurrent()

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

Ottiene la scheda da cui viene effettuata la chiamata dello script. Restituisce undefined se chiamato da un contesto che non è una scheda (ad esempio, una pagina di sfondo o una visualizzazione popup).

Parametri

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (tab?: Tab) => void

Resi

  • Promesso<Tab | non definito>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getSelected()

Promesso &amp;leq; MV2 Deprecato
chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

Utilizza tabs.query {active: true}.

Restituisce la scheda selezionata nella finestra specificata.

Parametri

  • windowId

    numero facoltativo

    Il valore predefinito è la finestra attuale.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (tab: Tab) => void

Resi

  • Promesso<Tab>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getZoom()

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

Restituisce il fattore di zoom corrente di una scheda specificata.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda da cui ricavare il fattore di zoom corrente; viene impostata per impostazione predefinita la scheda attiva della finestra corrente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (zoomFactor: number) => void

    • zoomFactor

      numero

      Il fattore di zoom corrente della scheda.

Resi

  • Promise&lt;number&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

getZoomSettings()

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

Restituisce le impostazioni di zoom correnti di una scheda specificata.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda da cui ottenere le impostazioni di zoom correnti; viene impostata per impostazione predefinita la scheda attiva della finestra corrente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (zoomSettings: ZoomSettings) => void

    • zoomSettings

      ZoomSettings

      Le impostazioni di zoom correnti della scheda.

Resi

  • Promise&lt;ZoomSettings&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

goBack()

Promesso Chrome 72 e versioni successive 
chrome.tabs.goBack(
  tabId?: number,
  callback?: function,
)

Torna alla pagina precedente, se disponibile.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda per tornare indietro; viene impostata per impostazione predefinita la scheda selezionata della finestra corrente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

goForward()

Promesso Chrome 72 e versioni successive 
chrome.tabs.goForward(
  tabId?: number,
  callback?: function,
)

Vai alla pagina successiva, se disponibile.

Parametri

  • tabId

    numero facoltativo

    l'ID della scheda per andare avanti; viene impostata per impostazione predefinita la scheda selezionata della finestra corrente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

group()

Promesso Chrome 88 e versioni successive 
chrome.tabs.group(
  options: object,
  callback?: function,
)

Aggiunge una o più schede a un gruppo specificato oppure, se non viene specificato alcun gruppo, aggiunge le schede specificate a un gruppo appena creato.

Parametri

  • opzioni

    oggetto

    • createProperties

      oggetto facoltativo

      Configurazioni per la creazione di un gruppo. Non può essere utilizzato se groupId è già specificato.

      • windowId

        numero facoltativo

        La finestra del nuovo gruppo. Il valore predefinito è la finestra corrente.

    • groupId

      numero facoltativo

      L'ID del gruppo a cui aggiungere le schede. Se non specificato, verrà creato un nuovo gruppo.

    • tabIds

      numero | [numero, ...numero[]]

      L'ID scheda o l'elenco di ID scheda da aggiungere al gruppo specificato.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (groupId: number) => void

    • groupId

      numero

      L'ID del gruppo a cui sono state aggiunte le schede.

Resi

  • Promise&lt;number&gt;

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

highlight()

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

Evidenzia le schede specificate e attiva la prima del gruppo. Non farà nulla se la scheda specificata è attualmente attiva.

Parametri

  • highlightInfo

    oggetto

    • schede

      numero | numero[]

      Uno o più indici di schede da evidenziare.

    • windowId

      numero facoltativo

      La finestra che contiene le schede.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (window: Window) => void

    • finestra

      Finestra

      Contiene dettagli sulla finestra in cui sono state evidenziate le schede.

Resi

  • Promise&lt;windows.Window&gt;

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

insertCSS()

Promesso &amp;leq; MV2 Ritirato da Chrome 91
chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Sostituito da scripting.insertCSS in Manifest V3.

Inserisce codice CSS in una pagina. Gli stili inseriti con questo metodo possono essere rimossi con scripting.removeCSS. Per maggiori dettagli, consulta la sezione sull'inserimento programmatico del documento sugli script di contenuti.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda in cui inserire il CSS; viene impostata per impostazione predefinita la scheda attiva della finestra corrente.

  • dettagli

    InjectDetails

    Dettagli del testo CSS da inserire. È necessario impostare il codice o la proprietà del file, ma non possono essere impostati entrambi contemporaneamente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

move()

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

Sposta una o più schede in una nuova posizione all'interno della relativa finestra o in una nuova finestra. Tieni presente che le schede possono essere spostate solo da e verso finestre normali (window.type === "normal").

Parametri

  • tabIds

    numero | numero[]

    L'ID scheda o l'elenco di ID scheda da spostare.

  • moveProperties

    oggetto

    • indice

      numero

      La posizione in cui spostare la finestra. Usa -1 per posizionare la scheda alla fine della finestra.

    • windowId

      numero facoltativo

      Il valore predefinito è la finestra in cui si trova attualmente la scheda.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

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

    • schede

      Tab | Scheda[]

      Dettagli sulle schede spostate.

Resi

  • Promesso<Tab | Scheda[]>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

query()

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

Restituisce tutte le schede con le proprietà specificate oppure tutte le schede se non sono specificate proprietà.

Parametri

  • queryInfo

    oggetto

    • attivo

      booleano facoltativo

      Se le schede sono attive nelle relative finestre.

    • audible

      booleano facoltativo

      Chrome 45 e versioni successive .

      Indica se le schede sono udibili.

    • autoDiscardable

      booleano facoltativo

      Chrome 54 e versioni successive .

      Indica se le schede possono essere ignorate automaticamente dal browser quando le risorse sono scarse.

    • currentWindow

      booleano facoltativo

      Se le schede si trovano nella finestra corrente.

    • ignorato

      booleano facoltativo

      Chrome 54 e versioni successive .

      Indica se le schede vengono ignorate. Una scheda eliminata è una scheda i cui contenuti sono stati scaricati dalla memoria, ma è ancora visibile nella tabstrip. I relativi contenuti vengono ricaricati alla successiva attivazione.

    • groupId

      numero facoltativo

      Chrome 88 e versioni successive .

      L'ID del gruppo in cui si trovano le schede o tabGroups.TAB_GROUP_ID_NONE per le schede non raggruppate.

    • in evidenza

      booleano facoltativo

      Se le schede sono evidenziate.

    • indice

      numero facoltativo

      La posizione delle schede all'interno delle finestre.

    • lastFocusedWindow

      booleano facoltativo

      Se le schede si trovano nell'ultima finestra evidenziata.

    • audio disattivato

      booleano facoltativo

      Chrome 45 e versioni successive .

      Indica se le schede sono disattivate.

    • fissata

      booleano facoltativo

      Se le schede sono bloccate.

    • stato

      TabStatus facoltativo

      Lo stato di caricamento della scheda.

    • titolo

      stringa facoltativo

      Abbina i titoli delle pagine a uno schema. Questa proprietà viene ignorata se l'estensione non dispone dell'autorizzazione "tabs".

    • url

      string | string[] facoltativo

      Abbina le schede a uno o più pattern URL. Gli identificatori dei frammenti non corrispondono. Questa proprietà viene ignorata se l'estensione non dispone dell'autorizzazione "tabs".

    • windowId

      numero facoltativo

      L'ID della finestra principale o windows.WINDOW_ID_CURRENT per la finestra attuale.

    • windowType

      WindowType facoltativo

      Il tipo di finestra in cui si trovano le schede.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (result: Tab[]) => void

Resi

  • Promesso<Tab[]>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

reload()

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

Ricarica una scheda.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda da ricaricare; viene impostata per impostazione predefinita la scheda selezionata della finestra corrente.

  • reloadProperties

    oggetto facoltativo

    • bypassCache

      booleano facoltativo

      Indica se ignorare la memorizzazione nella cache locale. Il valore predefinito è false.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

remove()

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

Chiude una o più schede.

Parametri

  • tabIds

    numero | numero[]

    L'ID scheda o l'elenco di ID scheda da chiudere.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

removeCSS()

Promesso Chrome 87 e versioni successive &amp;leq; MV2 Ritirato da Chrome 91
chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Sostituito da scripting.removeCSS in Manifest V3.

Rimuove da un CSS della pagina inserito in precedenza da una chiamata a scripting.insertCSS.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda da cui rimuovere il CSS; viene impostata per impostazione predefinita la scheda attiva della finestra corrente.

  • Dettagli del testo CSS da rimuovere. È necessario impostare il codice o la proprietà del file, ma non possono essere impostati entrambi contemporaneamente.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

sendMessage()

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

Invia un singolo messaggio agli script dei contenuti nella scheda specificata, con un callback facoltativo da eseguire quando viene inviata una risposta. L'evento runtime.onMessage viene attivato in ogni script di contenuti in esecuzione nella scheda specificata per l'estensione corrente.

Parametri

  • tabId

    numero

  • messaggio

    qualsiasi

    Il messaggio da inviare. Questo messaggio deve essere un oggetto verificabile con JSON.

  • opzioni

    oggetto facoltativo

    • documentId

      stringa facoltativo

      Chrome 106 e versioni successive .

      Invia un messaggio a un documento specifico identificato da documentId anziché a tutti i frame nella scheda.

    • frameId

      numero facoltativo

      Invia un messaggio a un frame specifico identificato da frameId anziché a tutti i frame nella scheda.

  • callback

    funzione facoltativa

    Chrome 99 e versioni successive .

    Il parametro callback ha il seguente aspetto: 

    (response: any) => void

    • risposta

      qualsiasi

      L'oggetto risposta JSON inviato dal gestore del messaggio. Se si verifica un errore durante la connessione alla scheda specificata, il callback viene chiamato senza argomenti e runtime.lastError viene impostato sul messaggio di errore.

Resi

  • Promesso<qualsiasi>

    Chrome 99 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

sendRequest()

Promesso &amp;leq; MV2 Deprecato
chrome.tabs.sendRequest(
  tabId: number,
  request: any,
  callback?: function,
)

Utilizza runtime.sendMessage.

Invia una singola richiesta agli script dei contenuti nella scheda specificata, con un callback facoltativo da eseguire quando viene inviata una risposta. L'evento extension.onRequest viene attivato in ogni script di contenuti in esecuzione nella scheda specificata per l'estensione corrente.

Parametri

  • tabId

    numero

  • richiesta

    qualsiasi

  • callback

    funzione facoltativa

    Chrome 99 e versioni successive .

    Il parametro callback ha il seguente aspetto: 

    (response: any) => void

    • risposta

      qualsiasi

      L'oggetto risposta JSON inviato dal gestore della richiesta. Se si verifica un errore durante la connessione alla scheda specificata, il callback viene chiamato senza argomenti e runtime.lastError viene impostato sul messaggio di errore.

Resi

  • Promesso<qualsiasi>

    Chrome 99 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

setZoom()

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

Aumenta lo zoom su una scheda specificata.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda su cui eseguire lo zoom; viene impostata per impostazione predefinita la scheda attiva della finestra corrente.

  • zoomFactor

    numero

    Il nuovo fattore di zoom. Un valore 0 imposta la scheda sul fattore di zoom predefinito corrente. I valori superiori a 0 specificano un fattore di zoom (possibilmente non predefinito) per la scheda.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

setZoomSettings()

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

Consente di configurare le impostazioni di zoom per una scheda specificata, che definiscono il modo in cui vengono gestite le modifiche dello zoom. Durante la navigazione nella scheda vengono ripristinate le impostazioni predefinite di queste impostazioni.

Parametri

  • tabId

    numero facoltativo

    L'ID della scheda per la quale modificare le impostazioni di zoom; viene impostata per impostazione predefinita la scheda attiva della finestra corrente.

  • zoomSettings

    ZoomSettings

    Definisce come vengono gestite le modifiche allo zoom e l'ambito.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

ungroup()

Promesso Chrome 88 e versioni successive 
chrome.tabs.ungroup(
  tabIds: number | [number, ...number[]],
  callback?: function,
)

Rimuove una o più schede dai rispettivi gruppi. I gruppi vuoti vengono eliminati.

Parametri

  • tabIds

    numero | [numero, ...numero[]]

    L'ID scheda o l'elenco di ID scheda da rimuovere dai rispettivi gruppi.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    () => void

Resi

  • Promesso<void>

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

update()

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

Modifica le proprietà di una scheda. Le proprietà che non sono specificate in updateProperties non vengono modificate.

Parametri

  • tabId

    numero facoltativo

    Il valore predefinito è la scheda selezionata della finestra corrente.

  • updateProperties

    oggetto

    • attivo

      booleano facoltativo

      Se la scheda deve essere attiva. Non influisce sull'effetto della finestra (vedi windows.update).

    • autoDiscardable

      booleano facoltativo

      Chrome 54 e versioni successive .

      Indica se la scheda deve essere eliminata automaticamente dal browser quando le risorse sono scarse.

    • in evidenza

      booleano facoltativo

      Aggiunge o rimuove la scheda dalla selezione corrente.

    • audio disattivato

      booleano facoltativo

      Chrome 45 e versioni successive .

      Indica se l'audio della scheda deve essere disattivato.

    • openerTabId

      numero facoltativo

      L'ID della scheda che ha aperto questa scheda. Se specificato, la scheda di apertura deve trovarsi nella stessa finestra di questa scheda.

    • fissata

      booleano facoltativo

      Indica se la scheda deve essere bloccata.

    • selezionato

      booleano facoltativo

      Obsoleta

      Usa gli attributi evidenziati.

      Se la scheda deve essere selezionata.

    • url

      stringa facoltativo

      Un URL in cui passare alla scheda. Gli URL JavaScript non sono supportati; utilizza invece scripting.executeScript.

  • callback

    funzione facoltativa

    Il parametro callback ha il seguente aspetto: 

    (tab?: Tab) => void

    • tab

      Scheda facoltativa

      Dettagli sulla scheda aggiornata. L'oggetto tabs.Tab non contiene url, pendingUrl, title e favIconUrl se l'autorizzazione "tabs" non è stata richiesta.

Resi

  • Promesso<Tab | non definito>

    Chrome 88 e versioni successive .

    Le promesse sono supportate in Manifest V3 e versioni successive, ma sono disponibili callback per la compatibilità con le versioni precedenti. Non puoi utilizzare entrambi nella stessa chiamata di funzione. La si risolve con lo stesso tipo passato al callback.

Eventi

onActivated

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

Viene attivato quando cambia la scheda attiva in una finestra. Tieni presente che l'URL della scheda potrebbe non essere impostato nel momento in cui questo evento viene attivato, ma puoi ascoltare gli eventi onUpdated per ricevere una notifica quando viene impostato un URL.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (activeInfo: object) => void

    • activeInfo

      oggetto

      • tabId

        numero

        L'ID della scheda che è stata attivata.

      • windowId

        numero

        L'ID della finestra in cui è stata modificata la scheda attiva.

onActiveChanged

&amp;leq; MV2 Deprecato
chrome.tabs.onActiveChanged.addListener(
  callback: function,
)

Utilizza tabs.onActivated.

Si attiva quando la scheda selezionata in una finestra cambia. Tieni presente che l'URL della scheda potrebbe non essere impostato nel momento in cui questo evento è stato attivato, ma puoi ascoltare gli eventi tabs.onUpdated per ricevere una notifica quando viene impostato un URL.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • tabId

      numero

    • selectInfo

      oggetto

      • windowId

        numero

        L'ID della finestra in cui è stata modificata la scheda selezionata.

onAttached

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

Attivato quando una scheda è collegata a una finestra. ad esempio perché è stato spostato da una finestra all'altra.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • tabId

      numero

    • attachInfo

      oggetto

      • newPosition

        numero

      • newWindowId

        numero

onCreated

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

Attivato quando viene creata una scheda. Tieni presente che l'URL della scheda e l'appartenenza al gruppo di schede potrebbero non essere impostati nel momento in cui viene attivato questo evento, ma puoi ascoltare gli eventi onUpdated per ricevere una notifica quando viene impostato un URL o la scheda viene aggiunta a un gruppo di schede.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (tab: Tab) => void

onDetached

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

Attivato quando una scheda viene scollegata dalla finestra. ad esempio perché è stato spostato da una finestra all'altra.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • tabId

      numero

    • detachInfo

      oggetto

      • oldPosition

        numero

      • oldWindowId

        numero

onHighlightChanged

&amp;leq; MV2 Deprecato
chrome.tabs.onHighlightChanged.addListener(
  callback: function,
)

Utilizza tabs.onHighlighted.

Attivato quando cambiano le schede evidenziate o selezionate in una finestra.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (selectInfo: object) => void

    • selectInfo

      oggetto

      • tabIds

        numero[]

        Tutte le schede evidenziate nella finestra.

      • windowId

        numero

        La finestra in cui sono state modificate le schede.

onHighlighted

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

Attivato quando cambiano le schede evidenziate o selezionate in una finestra.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (highlightInfo: object) => void

    • highlightInfo

      oggetto

      • tabIds

        numero[]

        Tutte le schede evidenziate nella finestra.

      • windowId

        numero

        La finestra in cui sono state modificate le schede.

onMoved

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

Attivato quando una scheda viene spostata all'interno di una finestra. Viene attivato un solo evento di spostamento, che rappresenta la scheda spostata direttamente dall'utente. Gli eventi di spostamento non vengono attivati per le altre schede che devono spostarsi in risposta alla scheda spostata manualmente. Questo evento non viene attivato quando una scheda viene spostata da una finestra all'altra. Per maggiori dettagli, vedi tabs.onDetached.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • tabId

      numero

    • moveInfo

      oggetto

      • fromIndex

        numero

      • toIndex

        numero

      • windowId

        numero

onRemoved

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

Attivato quando viene chiusa una scheda.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • tabId

      numero

    • removeInfo

      oggetto

      • isWindowClosing

        booleano

        True quando la scheda è stata chiusa perché la finestra principale era chiusa.

      • windowId

        numero

        La finestra con la scheda chiusa.

onReplaced

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

Attivato quando una scheda viene sostituita con un'altra a causa di prerendering o istantaneo.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • addedTabId

      numero

    • removedTabId

      numero

onSelectionChanged

&amp;leq; MV2 Deprecato
chrome.tabs.onSelectionChanged.addListener(
  callback: function,
)

Utilizza tabs.onActivated.

Si attiva quando la scheda selezionata in una finestra cambia.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • tabId

      numero

    • selectInfo

      oggetto

      • windowId

        numero

        L'ID della finestra in cui è stata modificata la scheda selezionata.

onUpdated

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

Attivato quando viene aggiornata una scheda.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

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

    • tabId

      numero

    • changeInfo

      oggetto

      • audible

        booleano facoltativo

        Chrome 45 e versioni successive .

        Il nuovo stato udibile della scheda.

      • autoDiscardable

        booleano facoltativo

        Chrome 54 e versioni successive .

        Il nuovo stato della scheda annullabile automaticamente.

      • ignorato

        booleano facoltativo

        Chrome 54 e versioni successive .

        Il nuovo stato eliminato della scheda.

      • favIconUrl

        stringa facoltativo

        Il nuovo URL della favicon della scheda.

      • groupId

        numero facoltativo

        Chrome 88 e versioni successive .

        Il nuovo gruppo della scheda.

      • mutedInfo

        MutedInfo facoltativo

        Chrome 46 e versioni successive .

        Il nuovo stato disattivato della scheda e il motivo della modifica.

      • fissata

        booleano facoltativo

        Il nuovo stato bloccato della scheda.

      • stato

        TabStatus facoltativo

        Lo stato di caricamento della scheda.

      • titolo

        stringa facoltativo

        Chrome 48 e versioni successive .

        Il nuovo titolo della scheda.

      • url

        stringa facoltativo

        L'URL della scheda, se è stato modificato.

    • tab

      Scheda

onZoomChange

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

Attivato quando viene aumentato lo zoom di una scheda.

Parametri

  • callback

    funzione

    Il parametro callback ha il seguente aspetto: 

    (ZoomChangeInfo: object) => void

    • ZoomChangeInfo

      oggetto

      • newZoomFactor

        numero

      • oldZoomFactor

        numero

      • tabId

        numero

      • zoomSettings

        ZoomSettings