chrome.tabs

Nota: l'API Tabs può essere utilizzata dalle pagine dei service worker e delle estensioni, ma non dagli script di contenuti.

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

Nota: questo esempio non richiede autorizzazioni.

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

Importante: l'utilizzo di catch(error) in una Promise è un modo per garantire che un errore che altrimenti popola che "chrome.runtime.lastError" non è deselezionato.

  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:

• Manifest V2 - Estensioni API Tabs.
• Manifest V3 - Gestione schede.

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

• runtime.Port

  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

  • tab

    Scheda

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

  • schede

    Scheda[]

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

  • tab

    Scheda facoltativa

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

  • tab

    Scheda

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

  • risultato

    Scheda[]

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

  DeleteInjectionDetails

  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

  • tab

    Scheda

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