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 chiamaretabs.query()
da quattro proprietà sensibili sulle istanzetabs.Tab
:url
,pendingUrl
,title
efavIconUrl
.{ "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 cometabs.captureVisibleTab()
,tabs.executeScript()
,tabs.insertCSS()
etabs.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"
});
}
});
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);
}
}
}
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:
Tipi
MutedInfo
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
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 successiveIndica 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 successiveIndica se la scheda può essere ignorata automaticamente dal browser quando le risorse sono scarse.
-
ignorato
boolean
Chrome 54 e versioni successiveIndica 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 successiveL'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 suchrome.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 successiveL'ultimo accesso alla scheda come numero di millisecondi dall'epoca.
-
mutedInfo
MutedInfo facoltative
Chrome 46 e versioni successiveL'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 successiveL'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.
-
selezionato
boolean
DeprecatoUtilizza
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 ancheTab.pendingUrl
. -
larghezza
numero facoltativo
La larghezza della scheda in pixel.
-
windowId
numero
L'ID della finestra che contiene la scheda.
TabStatus
Lo stato di caricamento della scheda.
Enum
WindowType
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 successiveUtilizzato 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
eper-tab
in caso contrario.
ZoomSettingsMode
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
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
Il numero massimo di chiamate di captureVisibleTab
al secondo. captureVisibleTab
è costoso e non deve essere chiamato troppo spesso.
Valore
2
TAB_ID_NONE
Un ID che rappresenta l'assenza di una scheda del browser.
Valore
-1
TAB_INDEX_NONE
Un indice che rappresenta l'assenza di un indice di schede in una scheda_strip.
Valore
-1
Metodi
captureVisibleTab()
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 successiveLe 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 successiveAprire 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
-
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()
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
-
selezionato
booleano facoltativo
DeprecatoUsa 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
La scheda creata.
-
Ritorni
-
Promise<Tab>
Chrome 88 e versioni successiveLe 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()
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
ofr
. 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 restituitozh-CN
. Per una lingua sconosciuta/non definita, viene restituitound
.
-
Ritorni
-
Promessa<string>
Chrome 88 e versioni successiveLe 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()
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
-
Promise<Tab | undefined>
Chrome 88 e versioni successiveLe 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()
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
Ritorni
-
Promise<Tab | undefined>
Chrome 88 e versioni successiveLe 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()
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
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 successiveLe 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()
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
-
Ritorni
-
Promise<Tab>
Chrome 88 e versioni successiveLe 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()
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 successiveLe 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()
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
Ritorni
-
Promise<Tab | undefined>
Chrome 88 e versioni successiveLe 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()
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
-
Ritorni
-
Promise<Tab>
Chrome 88 e versioni successiveLe 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()
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 successiveLe 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()
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
Le impostazioni di zoom correnti della scheda.
-
Ritorni
-
Promise<ZoomSettings>
Chrome 88 e versioni successiveLe 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()
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 successiveLe 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()
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 successiveLe 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()
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()
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
Contiene i dettagli della finestra di cui sono state evidenziate le schede.
-
Ritorni
-
Promessa<windows.Window>
Chrome 88 e versioni successiveLe 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()
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
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 successiveLe 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()
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
Ritorni
-
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()
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 successiveSe le schede sono udibili.
-
autoDiscardable
booleano facoltativo
Chrome 54 e versioni successiveIndica 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 successiveIndica 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 successiveL'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 successiveSe 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[] facoltativo
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 successiveLe 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()
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 successiveLe 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()
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 successiveLe 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()
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
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 successiveLe 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()
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 successiveInvia 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 successiveIl 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 successiveLe 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()
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 successiveIl 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 successiveLe 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()
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 a0
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 successiveLe 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()
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
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 successiveLe 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()
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()
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 successiveIndica 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 successiveIndica 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.
-
selezionato
booleano facoltativo
DeprecatoUsa 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
Ritorni
-
Promise<Tab | undefined>
Chrome 88 e versioni successiveLe 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
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
-
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
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
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 successiveIl nuovo stato udibile della scheda.
-
autoDiscardable
booleano facoltativo
Chrome 54 e versioni successiveIl nuovo stato individuabile automaticamente della scheda.
-
ignorato
booleano facoltativo
Chrome 54 e versioni successiveIl nuovo stato Eliminato della scheda.
-
favIconUrl
stringa facoltativo
URL della nuova favicon della scheda.
-
groupId
numero facoltativo
Chrome 88 e versioni successiveNuovo gruppo della scheda.
-
mutedInfo
MutedInfo facoltative
Chrome 46 e versioni successiveIl 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 successiveIl nuovo titolo della scheda.
-
url
stringa facoltativo
L'URL della scheda se è cambiato.
-
-
Home
-
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
-
-