chrome.tabs

Nota: l'API Tabs può essere utilizzata dal service worker e dalle pagine 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 ridisporre le schede nel browser.

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

Autorizzazioni

L'utilizzo della maggior parte delle funzionalità non richiede alcuna autorizzazione. Ad esempio, creazione di una nuova scheda, ricaricamento di una scheda, navigazione su un altro URL e così via.

Quando lavorano con l'API Tabs, gli sviluppatori devono essere a conoscenza di tre autorizzazioni.

Autorizzazione "schede"

Questa autorizzazione non concede l'accesso allo spazio dei nomi chrome.tabs. Concede invece a un'estensione la possibilità di chiamare tabs.query() da quattro proprietà sensibili sulle 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 sulle quattro proprietà sensibili tabs.Tab di una scheda corrispondente. Possono anche interagire direttamente con le schede corrispondenti utilizzando metodi come tabs.captureVisibleTab(), tabs.executeScript(), tabs.insertCSS() e tabs.removeCSS().

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

L'autorizzazione "activeTab"

activeTab concede a un'estensione l'autorizzazione host temporanea 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 seguenti sezioni illustrano alcuni casi d'uso comuni.

Aprire 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 installata. Nell'esempio seguente viene illustrato 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.

Scaricare la scheda corrente

Questo esempio mostra come il service worker di un'estensione può recuperare la scheda attiva dalla finestra attualmente attiva (o dalla finestra attiva più di recente se non è attiva alcuna finestra di Chrome). In genere, può essere considerata come 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 l'audio di 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 nella prima posizione quando fai clic

Questo esempio mostra come spostare una scheda durante il trascinamento. Anche se in questo esempio viene utilizzato chrome.tabs.move, puoi utilizzare lo stesso modello di attesa per 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'uso di catch(error) in un Promise è un modo per garantire che un errore che altrimenti compila "chrome.runtime.lastError" non sia 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.");
      }
    });
  }

Passare 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 schede specifiche del browser utilizzando l'istruzione 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 uno qualsiasi dei seguenti argomenti:

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

Tipi

MutedInfo

Chrome 46 e versioni successive

L'audio della scheda è disattivato e il motivo dell'ultima modifica dello stato.

Proprietà

• extensionId

  stringa facoltativo

  L'ID dell'estensione che ha modificato lo stato disattivato. Non impostato se un'estensione non è il motivo dell'ultima modifica dello stato disattivato.

• audio disattivato

  boolean

  Indica se l'audio della scheda è disattivato (è stata impedita la riproduzione dell'audio). L'audio della scheda potrebbe essere disattivato anche se non è stato riprodotto o se l'audio non è in riproduzione. Equivale alla visualizzazione dell'indicatore audio con audio disattivato.

• motivo

  MutedInfoReason facoltativo

  Il motivo per cui l'audio della scheda è stato disattivato o riattivato. Non impostato se lo stato di disattivazione dell'audio della scheda non è mai stato modificato.

MutedInfoReason

Chrome 46 e versioni successive

Un evento che ha causato una modifica dello stato disattivato.

Enum

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

"capture"
L'acquisizione delle schede è stata avviata e viene forzata la modifica dello stato disattivato.

"extension"
Un'estensione, identificata dal campo extensionsId, imposta lo stato disattivato.

Tab

Proprietà

• attivo

  boolean

  Indica se la scheda è attiva nella finestra. Questo non significa necessariamente che la finestra sia attiva.

• audible

  booleano facoltativo

  Chrome 45 e versioni successive

  Indica se la scheda ha prodotto un suono negli ultimi due secondi (ma potrebbe non essere udibile se l'audio è stato disattivato). Equivale alla visualizzazione dell'indicatore "audio speaker".

• autoDiscardable

  boolean

  Chrome 54 e versioni successive

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

• ignorato

  boolean

  Chrome 54 e versioni successive

  Indica se la scheda viene ignorata. Una scheda ignorata è una scheda il cui contenuto è stato scaricato dalla memoria, ma che è 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 viene caricata.

• 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

  boolean

  Indica 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 potrebbe non essere assegnato un ID a una scheda, ad esempio quando esegui 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 finestre di app e DevTools.

• in incognito

  boolean

  Indica 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 facoltativo

  Chrome 121 e versioni successive

  L'ultimo accesso alla scheda come numero di millisecondi dall'epoca.

• mutedInfo

  MutedInfo facoltative

  Chrome 46 e versioni successive

  L'audio della scheda è disattivato e il motivo dell'ultima modifica dello stato.

• openerTabId

  numero facoltativo

  L'ID della scheda che ha aperto la 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 viene indirizzata la scheda prima dell'esecuzione del commit. Questa proprietà è presente soltanto se il file manifest dell'estensione include l'autorizzazione "tabs" ed è presente una navigazione in attesa.

• fissata

  boolean

  Se la scheda è bloccata.

• selezionate

  boolean

  Deprecato

  Utilizza tabs.Tab.highlighted.

  Indica se la scheda è selezionata.

• sessionId

  stringa facoltativo

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

• status

  TabStatus facoltativo

  Lo stato di caricamento della scheda.

• title

  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 impegnato 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

WindowType

Chrome 44 e versioni successive

Il tipo di finestra.

Enum

"popup"

"app"

"devtools"

ZoomSettings

Definisce come vengono gestite le modifiche dello zoom in una scheda e in quale 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 tabulazioni.getZoomSettings.

• modalità

  ZoomSettingsMode facoltativo

  Definisce il modo in cui vengono gestite le modifiche dello zoom, ad esempio l'entità responsabile del ridimensionamento effettivo della pagina; il valore predefinito è automatic.

• ambito

  ZoomSettingsScope facoltativo

  Definisce se le modifiche dello zoom vengono mantenute per l'origine della pagina o se vengono applicate solo in questa scheda; il valore predefinito è per-origin in modalità automatic e per-tab in caso contrario.

ZoomSettingsMode

Chrome 44 e versioni successive

Definisce il modo in cui vengono gestite le modifiche dello zoom, ad esempio l'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 dello zoom. L'evento onZoomChange verrà comunque inviato ed è responsabilità dell'estensione rimanere in ascolto per questo evento e scalare manualmente la pagina. Questa modalità non supporta lo zoom per-origin, pertanto ignora l'impostazione di zoom scope e presuppone per-tab.

"disabilitato"
Disattiva tutto lo zoom della scheda. Viene ripristinato il livello di zoom predefinito e tutti i tentativi di modifica dello zoom vengono ignorati.

ZoomSettingsScope

Chrome 44 e versioni successive

Definisce se le modifiche dello zoom vengono mantenute per l'origine della pagina o se vengono applicate solo in questa scheda; il valore predefinito è per-origin in modalità automatic e per-tab in caso contrario.

Enum

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

"per-scheda"
Le modifiche allo zoom vengono applicate soltanto in questa scheda. Le modifiche apportate allo zoom in altre schede non influiscono sullo zoom in questa scheda. Inoltre, le modifiche dello zoom di per-tab vengono reimpostate durante la navigazione; quando navighi in una scheda, le pagine vengono sempre caricate 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 di 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 schede in una scheda_strip.

Valore

-1

Metodi

captureVisibleTab()

Promessa

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 altrimenti soggetti a limitazioni, incluse le pagine chrome:-scheme, le pagine di altre estensioni e i 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 del modello.

  Facoltativo ImageDetails

• 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 alla proprietà "src" di un elemento HTML img per la visualizzazione.

Ritorni

• Promessa<string>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

connect()

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

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 l'articolo Messaggistica relativa a Content Script.

Parametri

• tabId

  numero

• connectInfo

  oggetto facoltativo

  • documentId

    stringa facoltativo

    Chrome 106 e versioni successive

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

  • frameId

    numero facoltativo

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

  • nome

    stringa facoltativo

    Viene passato a onConnect per gli script di contenuti che ascoltano l'evento di connessione.

Ritorni

• 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()

Promessa

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'impostazione dello stato attivo della finestra (vedi windows.update). Il valore predefinito è true.

  • indice

    numero facoltativo

    La posizione che la scheda dovrebbe assumere nella finestra. Il valore fornito è bloccato su un valore compreso tra zero e il numero di tabulazioni nella finestra.

  • openerTabId

    numero facoltativo

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

  • fissata

    booleano facoltativo

    Se la scheda deve essere bloccata. Il valore predefinito è false

  • selezionate

    booleano facoltativo

    Deprecato

    Usa active.

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

  • url

    stringa facoltativo

    L'URL verso cui navigare inizialmente nella scheda. Gli URL completi devono includere uno schema (ad esempio "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

  • Home

    Tabulazione

    La scheda creata.

Ritorni

• Promise<Tab>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

detectLanguage()

Promessa

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 come en o fr. Per un elenco completo delle lingue supportate da questo metodo, consulta kLanguageInfoTable. Vengono controllate la seconda e la quarta colonna 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.

Ritorni

• Promessa<string>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

discard()

Promessa Chrome 54 e versioni successive

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

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

Parametri

• tabId

  numero facoltativo

  L'ID della scheda da eliminare. Se specificata, la scheda viene ignorata, a meno che non sia attiva o sia già eliminata. Se omessa, il browser ignora la scheda meno importante. Questa operazione potrebbe non riuscire se non esistono schede eliminabili.

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

  (tab?: Tab)=>void

  • Home

    Scheda facoltativa

    La scheda eliminata se è stata eliminata correttamente; in caso contrario non definita.

Ritorni

• Promessa<Tab|non definita>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

duplicate()

Promessa

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

  • Home

    Scheda facoltativa

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

Ritorni

• Promessa<Tab|non definita>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

executeScript()

Promise &leq; MV2 Obsoleto 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; il valore predefinito è 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

    any[] facoltativo

    Il risultato dello script in ogni frame inserito.

Ritorni

• Promessa<qualsiasi[]|non definita>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

get()

Promessa

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

  • Home

    Tabulazione

Ritorni

• Promise<Tab>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getAllInWindow()

Promessa &leq; MV2 Deprecata

chrome.tabs.getAllInWindow(
  windowId?: number,
  callback?: function,
)

Utilizza tabs.query {windowId: windowId}.

Consente di acquisire dettagli su 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[]

Ritorni

• Promise<Tab[]>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getCurrent()

Promessa

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

Recupera la scheda da cui viene effettuata la chiamata allo script. Restituisce undefined se chiamato da un contesto non basato su schede (ad esempio, una pagina in background o una visualizzazione popup).

Parametri

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

  (tab?: Tab)=>void

  • Home

    Scheda facoltativa

Ritorni

• Promessa<Tab|non definita>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getSelected()

Promessa &leq; MV2 Deprecata

chrome.tabs.getSelected(
  windowId?: number,
  callback?: function,
)

Utilizza tabs.query {active: true}.

Recupera 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

  • Home

    Tabulazione

Ritorni

• Promise<Tab>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getZoom()

Promessa

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; il valore predefinito è 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 attuale della scheda.

Ritorni

• Promessa<numero>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

getZoomSettings()

Promessa

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; il valore predefinito è 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.

Ritorni

• Promise<ZoomSettings>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

goBack()

Promessa 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; il valore predefinito è la scheda selezionata della finestra corrente.

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

  ()=>void

Ritorni

• Promise<void>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

goForward()

Promessa 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; il valore predefinito è la scheda selezionata della finestra corrente.

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

  ()=>void

Ritorni

• Promise<void>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

group()

Promessa Chrome 88 e versioni successive

chrome.tabs.group(
  options: object,
  callback?: function,
)

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

Parametri

• opzioni del modello.

  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.

Ritorni

• Promessa<numero>

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

highlight()

Promessa

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

Mette in evidenza le schede specificate e si concentra sulla prima del gruppo. Sembra che non faccia nulla se la scheda specificata è attualmente attiva.

Parametri

• highlightInfo

  oggetto

  • schede

    numero|numero[]

    Uno o più indici della scheda 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 i dettagli della finestra di cui sono state evidenziate le schede.

Ritorni

• Promessa<windows.Window>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

insertCSS()

Promise &leq; MV2 Obsoleto da Chrome 91

chrome.tabs.insertCSS(
  tabId?: number,
  details: InjectDetails,
  callback?: function,
)

Sostituito da scripting.insertCSS in Manifest V3.

Inserisci il 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; per impostazione predefinita viene utilizzata 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

Ritorni

• Promise<void>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

move()

Promessa

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

Sposta una o più schede in una nuova posizione all'interno della finestra o in una nuova. 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 la scheda.

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

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

  • schede

    Scheda|Scheda[]

    Dettagli sulle schede spostate.

Ritorni

• Promessa<Tab|Tab[]>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

query()

Promessa

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

Recupera tutte le schede che hanno le proprietà specificate o tutte le schede se non è specificata alcuna proprietà.

Parametri

• queryInfo

  oggetto

  • attivo

    booleano facoltativo

    Se le schede sono attive nelle relative finestre.

  • audible

    booleano facoltativo

    Chrome 45 e versioni successive

    Se le schede sono udibili.

  • autoDiscardable

    booleano facoltativo

    Chrome 54 e versioni successive

    Indica se le schede possono essere eliminate 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 ignorata è una scheda il cui contenuto è stato scaricato dalla memoria, ma che è 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 relative finestre.

  • lastFocusedWindow

    booleano facoltativo

    Se le schede si trovano nell'ultima finestra attiva.

  • audio disattivato

    booleano facoltativo

    Chrome 45 e versioni successive

    Se l'audio delle schede è disattivato.

  • fissata

    booleano facoltativo

    Se le schede sono bloccate.

  • status

    TabStatus facoltativo

    Lo stato di caricamento della scheda.

  • title

    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[] optional

    Abbina le schede con uno o più pattern URL. Gli identificatori di 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 corrente.

  • 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[]

Ritorni

• Promise<Tab[]>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

reload()

Promessa

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

Ricaricare una scheda.

Parametri

• tabId

  numero facoltativo

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

• reloadProperties

  oggetto facoltativo

  • bypassCache

    booleano facoltativo

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

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

  ()=>void

Ritorni

• Promise<void>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

remove()

Promessa

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

Ritorni

• Promise<void>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

removeCSS()

Promise Chrome 87 e versioni successive &leq; MV2 Deprecata da Chrome 91

chrome.tabs.removeCSS(
  tabId?: number,
  details: DeleteInjectionDetails,
  callback?: function,
)

Sostituito da scripting.removeCSS in Manifest V3.

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

Parametri

• tabId

  numero facoltativo

  L'ID della scheda da cui rimuovere il CSS; il valore predefinito è 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

Ritorni

• Promise<void>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

sendMessage()

Promessa

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 JSON compatibile.

• opzioni del modello.

  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 della scheda.

  • frameId

    numero facoltativo

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

• callback

  funzione facoltativa

  Chrome 99 e versioni successive

  Il parametro callback ha il seguente aspetto:

  (response: any)=>void

  • risposta

    Qualsiasi

    L'oggetto di 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.

Ritorni

• Promessa<qualsiasi>

  Chrome 99 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

sendRequest()

Promessa &leq; MV2 Deprecata

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 recapitata 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 di 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.

Ritorni

• Promessa<qualsiasi>

  Chrome 99 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

setZoom()

Promessa

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

Ingrandisce una scheda specificata.

Parametri

• tabId

  numero facoltativo

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

• zoomFactor

  numero

  Il nuovo fattore di zoom. Il valore 0 imposta la scheda sul fattore di zoom predefinito corrente. 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

Ritorni

• Promise<void>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

setZoomSettings()

Promessa

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

Consente di impostare le impostazioni di zoom per una scheda specificata che definiscono le modalità di gestione delle modifiche dello zoom. Queste impostazioni vengono ripristinate ai valori predefiniti durante la navigazione nella scheda.

Parametri

• tabId

  numero facoltativo

  L'ID della scheda per cui modificare le impostazioni di zoom. Il valore predefinito è la scheda attiva della finestra corrente.

• zoomSettings

  ZoomSettings

  Definisce come vengono gestite le modifiche dello zoom e in quale ambito.

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

  ()=>void

Ritorni

• Promise<void>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

ungroup()

Promessa Chrome 88 e versioni successive

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

Rimuove una o più schede dai rispettivi gruppi. Se alcuni gruppi diventano 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

Ritorni

• Promise<void>

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

update()

Promessa

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

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

Parametri

• tabId

  numero facoltativo

  Il valore predefinito è la scheda selezionata della finestra corrente.

• updateProperties

  oggetto

  • attivo

    booleano facoltativo

    Indica se la scheda deve essere attiva. Non influisce sull'impostazione dello stato attivo 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 esaurite.

  • 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 la scheda. Se specificata, la scheda di apertura deve trovarsi nella stessa finestra di questa scheda.

  • fissata

    booleano facoltativo

    Se la scheda deve essere bloccata.

  • selezionate

    booleano facoltativo

    Deprecato

    Usa i caratteri evidenziati.

    Indica se la scheda deve essere selezionata.

  • url

    stringa facoltativo

    Un URL verso cui navigare nella scheda. Gli URL JavaScript non sono supportati. Utilizza scripting.executeScript.

• callback

  funzione facoltativa

  Il parametro callback ha il seguente aspetto:

  (tab?: Tab)=>void

  • Home

    Scheda facoltativa

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

Ritorni

• Promessa<Tab|non definita>

  Chrome 88 e versioni successive

  Le promesse sono supportate in Manifest V3 e versioni successive, ma vengono forniti callback per garantire la compatibilità con le versioni precedenti. Non puoi utilizzarli entrambi nella stessa chiamata di funzione. La promessa viene risolta con lo stesso tipo trasmesso al callback.

Eventi

onActivated

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

Viene attivato quando la scheda attiva in una finestra viene modificata. Tieni presente che l'URL della scheda potrebbe non essere impostato nel momento in cui viene attivato questo evento, 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

&leq; MV2 Deprecata

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

Utilizza tabs.onActivated.

Si attiva quando la scheda selezionata in una finestra viene modificata. Tieni presente che l'URL della scheda potrebbe non essere impostato nel momento in cui viene attivato questo evento, 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 è cambiata la scheda selezionata.

onAttached

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

Attivato quando una scheda è collegata a una finestra, ad esempio perché è stata spostata tra finestre.

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

  • Home

    Tabulazione

onDetached

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

Attivato quando una scheda viene scollegata da una finestra, ad esempio perché è stata spostata 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

&leq; MV2 Deprecata

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

Utilizza tabs.onHighlighted.

Si attiva quando le schede evidenziate o selezionate in una finestra cambiano.

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 le cui schede sono state modificate.

onHighlighted

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

Si attiva quando le schede evidenziate o selezionate in una finestra cambiano.

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 le cui schede sono state modificate.

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 essere spostate in risposta alla scheda spostata manualmente. Questo evento non viene attivato quando una scheda viene spostata tra le finestre. 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

      boolean

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

    • windowId

      numero

      La finestra con la scheda chiusa.

onReplaced

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

Si attiva quando una scheda viene sostituita con un'altra a causa del prerendering o dell'app istantanea.

Parametri

• callback

  funzione

  Il parametro callback ha il seguente aspetto:

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

  • addedTabId

    numero

  • removedTabId

    numero

onSelectionChanged

&leq; MV2 Deprecata

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

Utilizza tabs.onActivated.

Si attiva quando la scheda selezionata in una finestra viene modificata.

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 è cambiata 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 individuabile automaticamente della scheda.

    • ignorato

      booleano facoltativo

      Chrome 54 e versioni successive

      Il nuovo stato Eliminato della scheda.

    • favIconUrl

      stringa facoltativo

      URL della nuova favicon della scheda.

    • groupId

      numero facoltativo

      Chrome 88 e versioni successive

      Nuovo gruppo della scheda.

    • mutedInfo

      MutedInfo facoltative

      Chrome 46 e versioni successive

      Il nuovo stato di disattivazione audio della scheda e il motivo del cambiamento.

    • fissata

      booleano facoltativo

      Nuovo stato di blocco della scheda.

    • status

      TabStatus facoltativo

      Lo stato di caricamento della scheda.

    • title

      stringa facoltativo

      Chrome 48 e versioni successive

      Il nuovo titolo della scheda.

    • url

      stringa facoltativo

      L'URL della scheda se è cambiato.

  • Home

    Tabulazione

onZoomChange

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

Attivato quando una scheda viene ingrandita.

Parametri

• callback

  funzione

  Il parametro callback ha il seguente aspetto:

  (ZoomChangeInfo: object)=>void

  • ZoomChangeInfo

    oggetto

    • newZoomFactor

      numero

    • oldZoomFactor

      numero

    • tabId

      numero

    • zoomSettings

      ZoomSettings