Description
Utilisez l'API chrome.tabs
pour interagir avec le système d'onglets du navigateur. Vous pouvez utiliser cette API pour créer, modifier et réorganiser des onglets dans le navigateur.
Présentation
L'API Tabs offre non seulement des fonctionnalités pour manipuler et gérer les onglets, mais elle peut également détecter la langue de l'onglet, effectuer une capture d'écran et communiquer avec les scripts de contenu d'un onglet.
Autorisations
L'utilisation de la plupart des fonctionnalités ne nécessite aucune autorisation. Par exemple: créer un onglet, actualiser un onglet, accéder à une autre URL, etc.
Il existe trois autorisations dont les développeurs doivent être conscients lorsqu'ils utilisent l'API Tabs.
- L'autorisation "tabs"
- Cette autorisation ne donne pas accès à l'espace de noms
chrome.tabs
. En revanche, elle permet à une extension d'appelertabs.query()
sur quatre propriétés sensibles sur les instancestabs.Tab
:url
,pendingUrl
,title
etfavIconUrl
. - Autorisations d'hôte
- Les autorisations d'hôte permettent à une extension de lire et d'interroger les quatre propriétés
tabs.Tab
sensibles d'un onglet correspondant. Elles peuvent également interagir directement avec les onglets correspondants à l'aide de méthodes telles quetabs.captureVisibleTab()
,tabs.executeScript()
,tabs.insertCSS()
ettabs.removeCSS()
. - L'autorisation "activeTab"
activeTab
accorde à une extension une autorisation d'hôte temporaire pour l'onglet actuel en réponse à un appel utilisateur. Contrairement aux autorisations d'hôte,activeTab
ne déclenche aucun avertissement.
Manifest
Voici des exemples de déclaration d'autorisation dans le fichier manifeste:
{
"name": "My extension",
...
"permissions": [
"tabs"
],
...
}
{
"name": "My extension",
...
"host_permissions": [
"http://*/*",
"https://*/*"
],
...
}
{
"name": "My extension",
...
"permissions": [
"activeTab"
],
...
}
Cas d'utilisation
Les sections suivantes présentent quelques cas d'utilisation courants.
Ouvrir une page d'extension dans un nouvel onglet
Un modèle courant pour les extensions consiste à ouvrir une page d'accueil dans un nouvel onglet lorsque l'extension est installée. L'exemple suivant montre comment procéder.
background.js:
chrome.runtime.onInstalled.addListener(({reason}) => {
if (reason === 'install') {
chrome.tabs.create({
url: "onboarding.html"
});
}
});
Obtenir l'onglet actif
Cet exemple montre comment le service worker d'une extension peut récupérer l'onglet actif à partir de la fenêtre actuellement sélectionnée (ou de la dernière fenêtre sélectionnée, si aucune fenêtre Chrome n'est sélectionnée). Il s'agit généralement de l'onglet actuel de l'utilisateur.
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);
});
}
Ignorer l'onglet spécifié
Cet exemple montre comment une extension peut activer/désactiver le son d'un onglet donné.
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" }`);
});
}
Déplacer l'onglet actif en première position lorsque vous cliquez dessus
Cet exemple montre comment déplacer un onglet alors qu'un déplacement peut être en cours ou non. Bien que cet exemple utilise chrome.tabs.move
, vous pouvez utiliser le même schéma d'attente pour les autres appels qui modifient les onglets pendant qu'un déplacement est en cours.
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.");
}
});
}
Transmettre un message au script de contenu d'un onglet sélectionné
Cet exemple montre comment le service worker d'une extension peut communiquer avec des scripts de contenu dans des onglets de navigateur spécifiques à l'aide de 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.
}
Exemples d'extensions
Pour voir d'autres démonstrations des extensions de l'API Tabs, consultez les ressources suivantes:
Types
MutedInfo
État du son de l'onglet et motif du dernier changement d'état.
Propriétés
-
extensionId
string facultatif
ID de l'extension qui a modifié l'état du son. Non défini si une extension n'est pas à l'origine du dernier changement d'état du son.
-
son coupé
boolean
Indique si le son de l'onglet est coupé (il est impossible d'émettre des sons). Il est possible que le son de l'onglet soit coupé même s'il n'a pas été lu ou s'il n'en diffuse aucun son en cours. Équivaut à l'affichage de l'indicateur de son "son coupé".
-
reason
MutedInfoReason facultatif
Raison pour laquelle le son de l'onglet a été coupé ou réactivé. Non défini si le son de l'onglet n'a jamais été modifié.
MutedInfoReason
Événement ayant entraîné un changement d'état du son.
Enum
"user"
Une action d'entrée utilisateur définit le son.
"capture"
La capture d'onglet a démarré, forçant le changement d'état du son.
"extension"
Une extension, identifiée par le champ extensionId, définit l'état de son coupé.
Tab
Propriétés
-
actif
boolean
Indique si l'onglet est actif dans sa fenêtre. Cela ne signifie pas nécessairement que la fenêtre est sélectionnée.
-
audible
Booléen facultatif
Chrome 45 ou version ultérieureIndique si l'onglet a produit un son au cours des deux dernières secondes (mais il risque de ne pas être entendu s'il a également coupé le son). Équivaut à l'affichage de l'indicateur "audio de l'enceinte".
-
autoDiscardable
boolean
Chrome 54 et versions ultérieuresIndique si l'onglet peut être supprimé automatiquement par le navigateur lorsque les ressources sont insuffisantes.
-
avez supprimé
boolean
Chrome 54 et versions ultérieuresIndique si l'onglet est supprimé. Un onglet supprimé est un onglet dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la barre d'onglets. Son contenu sera actualisé la prochaine fois qu'il sera activé.
-
favIconUrl
string facultatif
URL du favicon de l'onglet. Cette propriété n'est présente que si le fichier manifeste de l'extension inclut l'autorisation
"tabs"
. Il peut également s'agir d'une chaîne vide si l'onglet est en cours de chargement. -
groupId
Nombre
Chrome 88 et versions ultérieuresID du groupe auquel l'onglet appartient.
-
taille
numéro facultatif
Hauteur de l'onglet en pixels.
-
en surbrillance
boolean
Indique si l'onglet est mis en surbrillance.
-
id
numéro facultatif
ID de l'onglet. Les ID d'onglet sont uniques dans une session de navigateur. Dans certains cas, aucun identifiant n'est attribué à un onglet, par exemple lorsque vous interrogez des onglets étrangers à l'aide de l'API
sessions
, auquel cas un ID de session peut être présent. L'ID de l'onglet peut également être défini surchrome.tabs.TAB_ID_NONE
pour les fenêtres d'applications et d'outils de développement. -
navigation privée
boolean
Indique si l'onglet se trouve dans une fenêtre de navigation privée.
-
index
Nombre
Index basé sur zéro de l'onglet dans sa fenêtre.
-
lastAccessed
numéro facultatif
Chrome 121 et versions ultérieuresNombre de millisecondes écoulées depuis l'epoch du dernier accès à l'onglet.
-
mutedInfo
MutedInfo facultatif
Chrome 46 ou version ultérieureÉtat du son de l'onglet et motif du dernier changement d'état.
-
openerTabId
numéro facultatif
L'ID de l'onglet qui a ouvert cet onglet, le cas échéant. Cette propriété n'est présente que si l'onglet d'ouverture existe toujours.
-
pendingUrl
string facultatif
Chrome 79 et versions ultérieuresURL vers laquelle l'onglet accède, avant qu'il ne soit validé. Cette propriété n'est présente que si le fichier manifeste de l'extension inclut l'autorisation
"tabs"
et qu'une navigation est en attente. -
épinglé
boolean
Si l'onglet est épinglé ou non
-
sélectionné
boolean
ObsolèteVeuillez utiliser
tabs.Tab.highlighted
.Indique si l'onglet est sélectionné.
-
sessionId
string facultatif
ID de session permettant d'identifier de manière unique un onglet obtenu à partir de l'API
sessions
. -
status
TabStatus facultatif
État de chargement de l'onglet.
-
title
string facultatif
Titre de l'onglet. Cette propriété n'est présente que si le fichier manifeste de l'extension inclut l'autorisation
"tabs"
. -
url
string facultatif
Dernière URL validée du frame principal de l'onglet. Cette propriété n'est présente que si le fichier manifeste de l'extension inclut l'autorisation
"tabs"
. Elle peut être une chaîne vide si l'onglet n'a pas encore été validé. Voir aussiTab.pendingUrl
. -
largeur
numéro facultatif
Largeur de l'onglet en pixels.
-
windowId
Nombre
ID de la fenêtre qui contient l'onglet.
TabStatus
État de chargement de l'onglet.
Enum
"complete"
WindowType
Type de fenêtre.
Enum
"normal"
"panel"
"devtools"
ZoomSettings
Définit la manière dont les changements de zoom dans un onglet sont traités et à quel niveau.
Propriétés
-
defaultZoomFactor
numéro facultatif
Chrome 43 et versions ultérieuresUtilisé pour renvoyer le niveau de zoom par défaut pour l'onglet actuel dans les appels à tabulations.getZoomSettings.
-
Standard
ZoomSettingsMode facultatif
Définit la manière dont les modifications de zoom sont gérées, c'est-à-dire l'entité responsable de la mise à l'échelle réelle de la page. Valeur par défaut :
automatic
. -
champ d'application
ZoomSettingsScope facultatif
Définit si les changements de zoom sont conservés pour l'origine de la page ou s'ils ne s'appliquent que dans cet onglet. La valeur par défaut est
per-origin
en modeautomatic
, etper-tab
dans les autres cas.
ZoomSettingsMode
Définit la manière dont les modifications de zoom sont gérées, c'est-à-dire l'entité responsable de la mise à l'échelle réelle de la page. Valeur par défaut : automatic
.
Enum
"automatic"
Les modifications de zoom sont gérées automatiquement par le navigateur.
"manual"
Ignore la gestion automatique des modifications du zoom. L'événement onZoomChange
sera toujours envoyé, et il incombe à l'extension d'écouter cet événement et d'ajuster manuellement la page. Ce mode n'est pas compatible avec le zoom per-origin
. Il ignore donc le paramètre de zoom scope
et suppose per-tab
.
"désactivé"
Désactive tout zoom sur l'onglet. Le niveau de zoom par défaut est rétabli et toutes les tentatives de modification du zoom sont ignorées.
ZoomSettingsScope
Définit si les changements de zoom sont conservés pour l'origine de la page ou s'ils ne s'appliquent que dans cet onglet. La valeur par défaut est per-origin
en mode automatic
, et per-tab
dans les autres cas.
Enum
"per-origin"
Les modifications de zoom sont conservées sur l'origine de la page agrandie, c'est-à-dire que le zoom s'applique également à tous les autres onglets consultés vers cette même origine. De plus, les modifications de zoom per-origin
sont enregistrées avec l'origine. Cela signifie que lorsque vous naviguez vers d'autres pages avec la même origine, elles sont toutes zoomées sur le même facteur de zoom. Le champ d'application per-origin
n'est disponible qu'en mode automatic
.
"par onglet"
Les modifications de zoom ne s'appliquent que dans cet onglet. Les changements de zoom dans les autres onglets n'affectent pas le zoom de cet onglet. De plus, les changements de zoom per-tab
sont réinitialisés lors de la navigation. Lorsque vous naviguez dans un onglet, les pages sont toujours chargées avec leurs facteurs de zoom per-origin
.
Propriétés
MAX_CAPTURE_VISIBLE_TAB_CALLS_PER_SECOND
Nombre maximal de fois que captureVisibleTab
peut être appelé par seconde. captureVisibleTab
est coûteux et ne doit pas être appelé trop souvent.
Valeur
2
TAB_ID_NONE
ID représentant l'absence d'onglet du navigateur.
Valeur
-1
TAB_INDEX_NONE
Index représentant l'absence d'index de tabulation dans une barre de lecture tab_strip.
Valeur
-1
Méthodes
captureVisibleTab()
chrome.tabs.captureVisibleTab(
windowId?: number,
options?: ImageDetails,
callback?: function,
)
Capture la zone visible de l'onglet actif dans la fenêtre spécifiée. Pour appeler cette méthode, l'extension doit disposer de l'autorisation <all_urls> ou activeTab. En plus des sites auxquels les extensions ont normalement accès, cette méthode permet aux extensions de capturer les sites sensibles qui font l'objet de restrictions, y compris les pages chrome:-scheme, les pages d'autres extensions et les URL data:. Ces sites sensibles ne peuvent être capturés qu'avec l'autorisation activeTab. Les URL de fichier ne peuvent être capturées que si l'extension a été autorisée à accéder aux fichiers.
Paramètres
-
windowId
numéro facultatif
Fenêtre cible. La valeur par défaut est la fenêtre actuelle.
-
options
ImageDetails facultatif
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(dataUrl: string) => void
-
dataUrl
chaîne
URL de données qui encode une image de la zone visible de l'onglet capturé. Peut être attribué à la propriété "src" d'un élément HTML
img
pour l'affichage.
-
Renvoie
-
Promesse<chaîne>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
connect()
chrome.tabs.connect(
tabId: number,
connectInfo?: object,
)
Se connecte au(s) script(s) de contenu dans l'onglet spécifié. L'événement runtime.onConnect
est déclenché dans chaque script de contenu exécuté dans l'onglet spécifié pour l'extension actuelle. Pour en savoir plus, consultez Messages du script de contenu.
Paramètres
-
tabId
Nombre
-
connectInfo
objet facultatif
-
documentId
string facultatif
Chrome 106 et versions ultérieuresOuvrez un port sur un document spécifique identifié par
documentId
au lieu de tous les cadres de l'onglet. -
frameId
numéro facultatif
Ouvrez un port sur un frame spécifique identifié par
frameId
au lieu de tous les frames de l'onglet. -
name
string facultatif
est transmise à onConnect pour les scripts de contenu qui écoutent l'événement de connexion.
-
Renvoie
-
Port qui peut être utilisé pour communiquer avec les scripts de contenu exécutés dans l'onglet spécifié. L'événement
runtime.Port
du port est déclenché si l'onglet se ferme ou n'existe pas.
create()
chrome.tabs.create(
createProperties: object,
callback?: function,
)
Crée un onglet.
Paramètres
-
createProperties
objet
-
actif
Booléen facultatif
Indique si l'onglet doit devenir l'onglet actif dans la fenêtre. Cela n'affecte pas la fenêtre active (voir
windows.update
). La valeur par défaut esttrue
. -
index
numéro facultatif
Position de l'onglet dans la fenêtre. La valeur fournie est comprise entre zéro et le nombre d'onglets dans la fenêtre.
-
openerTabId
numéro facultatif
ID de l'onglet qui a ouvert cet onglet. S'il est spécifié, l'onglet d'ouverture doit se trouver dans la même fenêtre que le nouvel onglet.
-
épinglé
Booléen facultatif
Épinglez ou non l'onglet. La valeur par défaut est
false
. -
sélectionné
Booléen facultatif
ObsolèteVeuillez utiliser active.
Définit si l'onglet doit devenir l'onglet sélectionné dans la fenêtre. La valeur par défaut est
true
. -
url
string facultatif
URL vers laquelle accéder initialement à l'onglet. Les URL complètes doivent inclure un schéma (par exemple, "http://www.google.com", et non "www.google.com"). Les URL relatives se rapportent à la page active dans l'extension. La page "Nouvel onglet" est utilisée par défaut.
-
windowId
numéro facultatif
Fenêtre dans laquelle créer le nouvel onglet. La valeur par défaut est la fenêtre actuelle.
-
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(tab: Tab) => void
-
tab
Onglet créé.
-
Renvoie
-
Promise<Tab>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
detectLanguage()
chrome.tabs.detectLanguage(
tabId?: number,
callback?: function,
)
Détecte la langue principale du contenu d'un onglet.
Paramètres
-
tabId
numéro facultatif
La valeur par défaut est l'onglet actif de la fenêtre actuelle.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(language: string) => void
-
language
chaîne
Un code de langue ISO tel que
en
oufr
. Pour obtenir la liste complète des langues compatibles avec cette méthode, consultez kLanguageInfoTable. Les deuxième à la quatrième colonnes sont vérifiées et la première valeur non nulle est renvoyée, à l'exception du chinois simplifié pour lequelzh-CN
est renvoyé. Pour une langue inconnue/non définie,und
est renvoyé.
-
Renvoie
-
Promesse<chaîne>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
discard()
chrome.tabs.discard(
tabId?: number,
callback?: function,
)
Supprime un onglet de la mémoire. Les onglets supprimés restent visibles dans la barre d'onglets et sont actualisés lorsqu'ils sont activés.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet à supprimer. S'il est spécifié, il est supprimé, sauf s'il est actif ou déjà supprimé. En cas d'omission, le navigateur supprime l'onglet le moins important. Cette opération peut échouer s'il n'existe aucun onglet pouvant être supprimé.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(tab?: Tab) => void
-
tab
Tabulation facultatif
Onglet supprimé, s'il a bien été supprimé, ou non défini dans le cas contraire.
-
Renvoie
-
Promise<Tab | undefined>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
duplicate()
chrome.tabs.duplicate(
tabId: number,
callback?: function,
)
Duplique un onglet.
Paramètres
-
tabId
Nombre
ID de l'onglet à dupliquer.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(tab?: Tab) => void
-
tab
Tabulation facultatif
Informations sur l'onglet dupliqué. L'objet
tabs.Tab
ne contient pasurl
,pendingUrl
,title
nifavIconUrl
si l'autorisation"tabs"
n'a pas été demandée.
-
Renvoie
-
Promise<Tab | undefined>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
executeScript()
chrome.tabs.executeScript(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Remplacé par scripting.executeScript
dans Manifest V3.
Injecte du code JavaScript dans une page. Pour en savoir plus, consultez la section Injection programmatique de la documentation sur les scripts de contenu.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet dans lequel exécuter le script. La valeur par défaut est l'onglet actif de la fenêtre actuelle.
-
détails
Détails du script à exécuter. Le code ou la propriété de fichier doivent être définis, mais ils ne peuvent pas être définis en même temps.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(result?: any[]) => void
-
résultat
any[] facultatif
Résultat du script dans chaque frame injecté.
-
Renvoie
-
Promesse<toute[] | indéfini>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
get()
chrome.tabs.get(
tabId: number,
callback?: function,
)
Récupère les détails de l'onglet spécifié.
Paramètres
-
tabId
Nombre
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(tab: Tab) => void
-
tab
-
Renvoie
-
Promise<Tab>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
getAllInWindow()
chrome.tabs.getAllInWindow(
windowId?: number,
callback?: function,
)
Veuillez utiliser tabs.query
{windowId: windowId}
.
Récupère les détails de tous les onglets de la fenêtre spécifiée.
Paramètres
-
windowId
numéro facultatif
La valeur par défaut est la fenêtre actuelle.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(tabs: Tab[]) => void
-
onglets
-
Renvoie
-
Promise<Tab[]>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
getCurrent()
chrome.tabs.getCurrent(
callback?: function,
)
Récupère l'onglet à partir duquel cet appel de script est effectué. Renvoie undefined
s'il est appelé à partir d'un contexte autre que des tabulations (par exemple, une page d'arrière-plan ou une vue pop-up).
Paramètres
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(tab?: Tab) => void
-
tab
Tabulation facultatif
-
Renvoie
-
Promise<Tab | undefined>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
getSelected()
chrome.tabs.getSelected(
windowId?: number,
callback?: function,
)
Veuillez utiliser tabs.query
{active: true}
.
Récupère l'onglet sélectionné dans la fenêtre spécifiée.
Paramètres
-
windowId
numéro facultatif
La valeur par défaut est la fenêtre actuelle.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(tab: Tab) => void
-
tab
-
Renvoie
-
Promise<Tab>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
getZoom()
chrome.tabs.getZoom(
tabId?: number,
callback?: function,
)
Récupère le facteur de zoom actuel d'un onglet spécifié.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet à partir duquel obtenir le facteur de zoom actuel. La valeur par défaut est l'onglet actif de la fenêtre actuelle.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(zoomFactor: number) => void
-
zoomFactor
Nombre
Facteur de zoom actuel de l'onglet.
-
Renvoie
-
Promesse<number>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
getZoomSettings()
chrome.tabs.getZoomSettings(
tabId?: number,
callback?: function,
)
Récupère les paramètres de zoom actuels d'un onglet spécifié.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet d'où proviennent les paramètres de zoom actuels. La valeur par défaut est l'onglet actif de la fenêtre actuelle.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(zoomSettings: ZoomSettings) => void
-
zoomSettings
Paramètres de zoom actuels de l'onglet.
-
Renvoie
-
Promise<ZoomSettings>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
goBack()
chrome.tabs.goBack(
tabId?: number,
callback?: function,
)
Revenez à la page précédente, si vous en avez une.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet à utiliser pour revenir en arrière. La valeur par défaut est l'onglet sélectionné dans la fenêtre actuelle.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :() => void
Renvoie
-
Promise<void>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
goForward()
chrome.tabs.goForward(
tabId?: number,
callback?: function,
)
Passez à la page suivante, si elle est disponible.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet à parcourir. Par défaut, il est défini sur l'onglet sélectionné dans la fenêtre actuelle.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :() => void
Renvoie
-
Promise<void>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
group()
chrome.tabs.group(
options: object,
callback?: function,
)
Ajoute un ou plusieurs onglets à un groupe spécifié ou, si aucun groupe n'est spécifié, ajoute les onglets donnés à un groupe nouvellement créé.
Paramètres
-
options
objet
-
createProperties
objet facultatif
Configurations pour créer un groupe. Utilisation impossible si groupId est déjà spécifié.
-
windowId
numéro facultatif
Fenêtre du nouveau groupe. Par défaut, la fenêtre actuelle est utilisée.
-
-
groupId
numéro facultatif
ID du groupe auquel ajouter les onglets. Si vous n'indiquez aucune valeur, un groupe sera créé.
-
tabIds
numéro | [nombre, ...nombre[]]
ID de l'onglet ou liste des ID d'onglets à ajouter au groupe spécifié.
-
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(groupId: number) => void
-
groupId
Nombre
ID du groupe auquel les onglets ont été ajoutés.
-
Renvoie
-
Promesse<number>
Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
highlight()
chrome.tabs.highlight(
highlightInfo: object,
callback?: function,
)
Met en surbrillance les onglets donnés et sélectionne le premier d'un groupe. N'a aucun effet si l'onglet spécifié est actif.
Paramètres
-
highlightInfo
objet
-
onglets
nombre | nombre[]
Un ou plusieurs index de tabulation à mettre en évidence.
-
windowId
numéro facultatif
Fenêtre contenant les onglets
-
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(window: Window) => void
-
fenêtre
Contient des détails sur la fenêtre dont les onglets ont été mis en surbrillance.
-
Renvoie
-
Promettre<windows.Window>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
insertCSS()
chrome.tabs.insertCSS(
tabId?: number,
details: InjectDetails,
callback?: function,
)
Remplacé par scripting.insertCSS
dans Manifest V3.
Il injecte du code CSS dans une page. Les styles insérés avec cette méthode peuvent être supprimés avec scripting.removeCSS
. Pour en savoir plus, consultez la section Injection programmatique de la documentation sur les scripts de contenu.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet dans lequel insérer le code CSS. Par défaut, il s'agit de l'onglet actif de la fenêtre actuelle.
-
détails
Détails du texte CSS à insérer. Le code ou la propriété de fichier doivent être définis, mais ils ne peuvent pas être définis en même temps.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :() => void
Renvoie
-
Promise<void>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
move()
chrome.tabs.move(
tabIds: number | number[],
moveProperties: object,
callback?: function,
)
Déplace un ou plusieurs onglets vers un nouvel emplacement de la fenêtre ou une nouvelle fenêtre. Notez que les onglets ne peuvent être déplacés que vers et depuis des fenêtres normales (window.type === "normal").
Paramètres
-
tabIds
nombre | nombre[]
ID de l'onglet ou liste des ID d'onglets à déplacer.
-
moveProperties
objet
-
index
Nombre
Position vers laquelle déplacer la fenêtre. Utilisez
-1
pour placer l'onglet à la fin de la fenêtre. -
windowId
numéro facultatif
La valeur par défaut est la fenêtre dans laquelle se trouve l'onglet.
-
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(tabs: Tab | Tab[]) => void
-
onglets
Tabulation | Tabulation[]
Détails sur les onglets déplacés.
-
Renvoie
-
Chrome 88 et versions ultérieures
Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
query()
chrome.tabs.query(
queryInfo: object,
callback?: function,
)
Récupère tous les onglets comportant les propriétés spécifiées ou tous les onglets si aucune propriété n'est spécifiée.
Paramètres
-
queryInfo
objet
-
actif
Booléen facultatif
si les onglets sont actifs dans leurs fenêtres ;
-
audible
Booléen facultatif
Chrome 45 ou version ultérieureIndique si les onglets sont audibles.
-
autoDiscardable
Booléen facultatif
Chrome 54 et versions ultérieuresIndique si les onglets peuvent être supprimés automatiquement par le navigateur lorsque les ressources sont insuffisantes.
-
currentWindow
Booléen facultatif
Indique si les onglets se trouvent dans la fenêtre actuelle.
-
avez supprimé
Booléen facultatif
Chrome 54 et versions ultérieuresIndique si les onglets sont supprimés. Un onglet supprimé est un onglet dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la barre d'onglets. Son contenu sera actualisé la prochaine fois qu'il sera activé.
-
groupId
numéro facultatif
Chrome 88 et versions ultérieuresID du groupe dans lequel se trouvent les onglets ou
tabGroups.TAB_GROUP_ID_NONE
pour les onglets dissociés. -
en surbrillance
Booléen facultatif
Si les onglets sont mis en surbrillance.
-
index
numéro facultatif
La position des onglets dans leurs fenêtres.
-
lastFocusedWindow
Booléen facultatif
Indique si les onglets se trouvent dans la dernière fenêtre sélectionnée.
-
son coupé
Booléen facultatif
Chrome 45 ou version ultérieureIndique si le son des onglets est désactivé.
-
épinglé
Booléen facultatif
Épinglez ou non les onglets.
-
status
TabStatus facultatif
État de chargement de l'onglet.
-
title
string facultatif
Faites correspondre les titres de page à un modèle. Cette propriété est ignorée si l'extension ne dispose pas de l'autorisation
"tabs"
. -
url
string | string[] facultatif
Faites correspondre les onglets avec un ou plusieurs formats d'URL. Les identifiants de fragment ne correspondent pas. Cette propriété est ignorée si l'extension ne dispose pas de l'autorisation
"tabs"
. -
windowId
numéro facultatif
ID de la fenêtre parent, ou
windows.WINDOW_ID_CURRENT
pour la fenêtre actuelle. -
windowType
WindowType : facultatif
Type de fenêtre dans lequel se trouvent les onglets.
-
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(result: Tab[]) => void
-
résultat
-
Renvoie
-
Promise<Tab[]>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
reload()
chrome.tabs.reload(
tabId?: number,
reloadProperties?: object,
callback?: function,
)
Actualisez un onglet.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet à actualiser. Valeur par défaut : l'onglet sélectionné de la fenêtre actuelle.
-
reloadProperties
objet facultatif
-
bypassCache
Booléen facultatif
Indique s'il faut contourner la mise en cache locale. La valeur par défaut est
false
.
-
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :() => void
Renvoie
-
Promise<void>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
remove()
chrome.tabs.remove(
tabIds: number | number[],
callback?: function,
)
Ferme un ou plusieurs onglets.
Paramètres
-
tabIds
nombre | nombre[]
ID de l'onglet ou liste des ID des onglets à fermer.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :() => void
Renvoie
-
Promise<void>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
removeCSS()
chrome.tabs.removeCSS(
tabId?: number,
details: DeleteInjectionDetails,
callback?: function,
)
Remplacé par scripting.removeCSS
dans Manifest V3.
Supprime un élément du CSS d'une page précédemment injecté par un appel à scripting.insertCSS
.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet à partir duquel supprimer le CSS (par défaut, l'onglet actif de la fenêtre actuelle).
-
détails
Détails du texte CSS à supprimer. Le code ou la propriété de fichier doivent être définis, mais ils ne peuvent pas être définis en même temps.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :() => void
Renvoie
-
Promise<void>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
sendMessage()
chrome.tabs.sendMessage(
tabId: number,
message: any,
options?: object,
callback?: function,
)
Envoie un message unique aux scripts de contenu de l'onglet spécifié, avec un rappel facultatif à exécuter lorsqu'une réponse est renvoyée. L'événement runtime.onMessage
est déclenché dans chaque script de contenu exécuté dans l'onglet spécifié pour l'extension actuelle.
Paramètres
-
tabId
Nombre
-
message
toutes
Message à envoyer. Ce message doit être un objet JSON.
-
options
objet facultatif
-
documentId
string facultatif
Chrome 106 et versions ultérieuresEnvoyez un message vers un document spécifique identifié par
documentId
au lieu de tous les cadres de l'onglet. -
frameId
numéro facultatif
Envoyez un message à un cadre spécifique identifié par
frameId
, plutôt qu'à tous les cadres de l'onglet.
-
-
rappel
fonction facultative
Chrome 99 et versions ultérieuresLe paramètre
callback
se présente comme suit :(response: any) => void
-
réponse
toutes
Objet de réponse JSON envoyé par le gestionnaire du message. Si une erreur se produit lors de la connexion à l'onglet spécifié, le rappel est appelé sans argument et
runtime.lastError
est défini sur le message d'erreur.
-
Renvoie
-
Promettre<tout>
Chrome 99 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
sendRequest()
chrome.tabs.sendRequest(
tabId: number,
request: any,
callback?: function,
)
Veuillez utiliser runtime.sendMessage
.
Envoie une requête unique aux scripts de contenu de l'onglet spécifié, avec un rappel facultatif à exécuter lorsqu'une réponse est renvoyée. L'événement extension.onRequest
est déclenché dans chaque script de contenu exécuté dans l'onglet spécifié pour l'extension actuelle.
Paramètres
-
tabId
Nombre
-
request
toutes
-
rappel
fonction facultative
Chrome 99 et versions ultérieuresLe paramètre
callback
se présente comme suit :(response: any) => void
-
réponse
toutes
Objet de réponse JSON envoyé par le gestionnaire de la requête. Si une erreur se produit lors de la connexion à l'onglet spécifié, le rappel est appelé sans argument et
runtime.lastError
est défini sur le message d'erreur.
-
Renvoie
-
Promettre<tout>
Chrome 99 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
setZoom()
chrome.tabs.setZoom(
tabId?: number,
zoomFactor: number,
callback?: function,
)
Permet de zoomer sur un onglet spécifié.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet sur lequel zoomer. La valeur par défaut est l'onglet actif de la fenêtre actuelle.
-
zoomFactor
Nombre
Nouveau facteur de zoom. La valeur
0
définit l'onglet sur son facteur de zoom par défaut actuel. Les valeurs supérieures à0
spécifient un facteur de zoom (peut-être différent de celui par défaut) pour l'onglet. -
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :() => void
Renvoie
-
Promise<void>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
setZoomSettings()
chrome.tabs.setZoomSettings(
tabId?: number,
zoomSettings: ZoomSettings,
callback?: function,
)
Définit les paramètres de zoom d'un onglet spécifié, qui définissent la manière dont les modifications de zoom sont traitées. Les valeurs par défaut de ces paramètres sont rétablies lorsque vous naviguez dans l'onglet.
Paramètres
-
tabId
numéro facultatif
ID de l'onglet pour lequel modifier les paramètres de zoom. La valeur par défaut est l'onglet actif de la fenêtre actuelle.
-
zoomSettings
Définit la manière dont les modifications de zoom sont gérées et à quel niveau.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :() => void
Renvoie
-
Promise<void>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
ungroup()
chrome.tabs.ungroup(
tabIds: number | [number, ...number[]],
callback?: function,
)
Supprime un ou plusieurs onglets de leurs groupes respectifs. Si des groupes deviennent vides, ils sont supprimés.
Paramètres
-
tabIds
numéro | [nombre, ...nombre[]]
ID d'onglet ou liste des ID d'onglets à supprimer de leurs groupes respectifs.
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :() => void
Renvoie
-
Promise<void>
Les promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
update()
chrome.tabs.update(
tabId?: number,
updateProperties: object,
callback?: function,
)
Modifie les propriétés d'un onglet. Les propriétés qui ne sont pas spécifiées dans updateProperties
ne sont pas modifiées.
Paramètres
-
tabId
numéro facultatif
La valeur par défaut est l'onglet sélectionné dans la fenêtre actuelle.
-
updateProperties
objet
-
actif
Booléen facultatif
Indique si l'onglet doit être actif ou non. Cela n'a aucune incidence sur le fait que la fenêtre soit sélectionnée ou non (voir
windows.update
). -
autoDiscardable
Booléen facultatif
Chrome 54 et versions ultérieuresIndique si l'onglet doit être supprimé automatiquement par le navigateur lorsque les ressources sont insuffisantes.
-
en surbrillance
Booléen facultatif
Ajoute l'onglet à la sélection actuelle ou le supprime.
-
son coupé
Booléen facultatif
Chrome 45 ou version ultérieureIndique si le son de l'onglet doit être coupé.
-
openerTabId
numéro facultatif
ID de l'onglet qui a ouvert cet onglet. S'il est spécifié, l'onglet d'ouverture doit se trouver dans la même fenêtre que cet onglet.
-
épinglé
Booléen facultatif
Épinglez ou non l'onglet.
-
sélectionné
Booléen facultatif
ObsolèteVeuillez utiliser en surbrillance.
Indique si l'onglet doit être sélectionné.
-
url
string facultatif
URL permettant d'accéder à l'onglet. Les URL JavaScript ne sont pas acceptées. Utilisez
scripting.executeScript
à la place.
-
-
rappel
fonction facultative
Le paramètre
callback
se présente comme suit :(tab?: Tab) => void
-
tab
Tabulation facultatif
Informations sur l'onglet mis à jour. L'objet
tabs.Tab
ne contient pasurl
,pendingUrl
,title
nifavIconUrl
si l'autorisation"tabs"
n'a pas été demandée.
-
Renvoie
-
Promise<Tab | undefined>
Chrome 88 et versions ultérieuresLes promesses ne sont compatibles qu'avec Manifest V3 et versions ultérieures. Les autres plates-formes doivent utiliser des rappels.
Événements
onActivated
chrome.tabs.onActivated.addListener(
callback: function,
)
Se déclenche lorsque l'onglet actif dans une fenêtre est modifié. Remarque : Il est possible que l'URL de l'onglet ne soit pas définie au moment du déclenchement de l'événement. Toutefois, vous pouvez écouter les événements onUpdated afin d'être averti lorsqu'une URL est définie.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(activeInfo: object) => void
-
activeInfo
objet
-
tabId
Nombre
ID de l'onglet qui est devenu actif.
-
windowId
Nombre
ID de la fenêtre dans laquelle l'onglet actif a été modifié.
-
-
onActiveChanged
chrome.tabs.onActiveChanged.addListener(
callback: function,
)
Veuillez utiliser tabs.onActivated
.
Se déclenche lorsque l'onglet sélectionné dans une fenêtre est modifié. Notez que l'URL de l'onglet peut ne pas être définie au moment du déclenchement de l'événement, mais vous pouvez écouter les événements tabs.onUpdated
afin d'être averti lorsqu'une URL est définie.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(tabId: number, selectInfo: object) => void
-
tabId
Nombre
-
selectInfo
objet
-
windowId
Nombre
ID de la fenêtre dans laquelle l'onglet sélectionné a été modifié.
-
-
onAttached
chrome.tabs.onAttached.addListener(
callback: function,
)
Déclenché lorsqu'un onglet est associé à une fenêtre (par exemple, lorsqu'il a été déplacé d'une fenêtre à l'autre)
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(tabId: number, attachInfo: object) => void
-
tabId
Nombre
-
attachInfo
objet
-
newPosition
Nombre
-
newWindowId
Nombre
-
-
onCreated
chrome.tabs.onCreated.addListener(
callback: function,
)
Déclenché lors de la création d'un onglet. Notez que l'URL de l'onglet et l'appartenance au groupe d'onglets peuvent ne pas être définies au moment du déclenchement de cet événement. Toutefois, vous pouvez écouter les événements onUpdated afin d'être averti lorsqu'une URL est définie ou lorsqu'un onglet est ajouté à un groupe d'onglets.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(tab: Tab) => void
-
tab
-
onDetached
chrome.tabs.onDetached.addListener(
callback: function,
)
Déclenché lorsqu'un onglet est dissocié d'une fenêtre (lorsqu'il a été déplacé entre les fenêtres, par exemple).
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(tabId: number, detachInfo: object) => void
-
tabId
Nombre
-
detachInfo
objet
-
oldPosition
Nombre
-
oldWindowId
Nombre
-
-
onHighlightChanged
chrome.tabs.onHighlightChanged.addListener(
callback: function,
)
Veuillez utiliser tabs.onHighlighted
.
Déclenché lorsque les onglets mis en surbrillance ou sélectionnés dans une fenêtre sont modifiés
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(selectInfo: object) => void
-
selectInfo
objet
-
tabIds
nombre[]
Tous les onglets mis en surbrillance dans la fenêtre.
-
windowId
Nombre
Fenêtre dont les onglets ont été modifiés.
-
-
onHighlighted
chrome.tabs.onHighlighted.addListener(
callback: function,
)
Déclenché lorsque les onglets mis en surbrillance ou sélectionnés dans une fenêtre sont modifiés
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(highlightInfo: object) => void
-
highlightInfo
objet
-
tabIds
nombre[]
Tous les onglets mis en surbrillance dans la fenêtre.
-
windowId
Nombre
Fenêtre dont les onglets ont été modifiés.
-
-
onMoved
chrome.tabs.onMoved.addListener(
callback: function,
)
Déclenché lorsqu'un onglet est déplacé dans une fenêtre Un seul événement de déplacement est déclenché, représentant l'onglet que l'utilisateur a directement déplacé. Les événements de déplacement ne sont pas déclenchés pour les autres onglets devant être déplacés en réponse au déplacement manuel. Cet événement n'est pas déclenché lorsque vous déplacez un onglet d'une fenêtre à l'autre. Pour en savoir plus, consultez tabs.onDetached
.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(tabId: number, moveInfo: object) => void
-
tabId
Nombre
-
moveInfo
objet
-
fromIndex
Nombre
-
toIndex
Nombre
-
windowId
Nombre
-
-
onRemoved
chrome.tabs.onRemoved.addListener(
callback: function,
)
Déclenché lorsqu'un onglet est fermé
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(tabId: number, removeInfo: object) => void
-
tabId
Nombre
-
removeInfo
objet
-
isWindowClosing
boolean
Vrai lorsque l'onglet a été fermé, car sa fenêtre parente était fermée.
-
windowId
Nombre
La fenêtre dont l'onglet est fermé.
-
-
onReplaced
chrome.tabs.onReplaced.addListener(
callback: function,
)
Déclenché lorsqu'un onglet est remplacé par un autre en raison du prérendu ou d'instantané.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(addedTabId: number, removedTabId: number) => void
-
addedTabId
Nombre
-
removedTabId
Nombre
-
onSelectionChanged
chrome.tabs.onSelectionChanged.addListener(
callback: function,
)
Veuillez utiliser tabs.onActivated
.
Se déclenche lorsque l'onglet sélectionné dans une fenêtre est modifié.
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(tabId: number, selectInfo: object) => void
-
tabId
Nombre
-
selectInfo
objet
-
windowId
Nombre
ID de la fenêtre dans laquelle l'onglet sélectionné a été modifié.
-
-
onUpdated
chrome.tabs.onUpdated.addListener(
callback: function,
)
Déclenché lorsqu'un onglet est mis à jour
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(tabId: number, changeInfo: object, tab: Tab) => void
-
tabId
Nombre
-
changeInfo
objet
-
audible
Booléen facultatif
Chrome 45 ou version ultérieureNouvel état audible de l'onglet.
-
autoDiscardable
Booléen facultatif
Chrome 54 et versions ultérieuresNouvel état de l'onglet pouvant être supprimé automatiquement.
-
avez supprimé
Booléen facultatif
Chrome 54 et versions ultérieuresNouvel état "Supprimé" de l'onglet.
-
favIconUrl
string facultatif
URL de la nouvelle favicon de l'onglet.
-
groupId
numéro facultatif
Chrome 88 et versions ultérieuresNouveau groupe de l'onglet.
-
mutedInfo
MutedInfo facultatif
Chrome 46 ou version ultérieureNouvel état du son de l'onglet et motif de la modification.
-
épinglé
Booléen facultatif
Nouvel état épinglé de l'onglet.
-
status
TabStatus facultatif
État de chargement de l'onglet.
-
title
string facultatif
Chrome 48 ou version ultérieureNouveau titre de l'onglet.
-
url
string facultatif
URL de l'onglet, si elle a été modifiée.
-
-
tab
-
onZoomChange
chrome.tabs.onZoomChange.addListener(
callback: function,
)
Déclenché lors d'un zoom sur un onglet
Paramètres
-
rappel
function
Le paramètre
callback
se présente comme suit :(ZoomChangeInfo: object) => void
-
ZoomChangeInfo
objet
-
newZoomFactor
Nombre
-
oldZoomFactor
Nombre
-
tabId
Nombre
-
zoomSettings
-
-