tabs.highlight()
Met en évidence (sélectionné) un ou plusieurs onglets. Les onglets sont spécifiés à l'aide d'un identifiant de fenêtre et d'une plage d'indices de tabulation.
C'est une fonction asynchrone qui renvoie une Promise
.
Syntaxe
var highlighting = browser.tabs.highlight(
highlightInfo, // object
);
Paramètres
highlightInfo
-
object
.windowId
Facultatif-
integer
. ID de la fenêtre contenant les onglets. populate
Facultatif-
boolean
. Par défaut la valeur esttrue
. S'il est défini surfalse
, l'objetwindows.Window
n'aura pas de propriététabs
contenant une liste d'objetstabs.Tab
représentant les onglets ouverts dans la fenêtre.Note : Remplir la fenêtre (le comportement par défaut) peut être une opération coûteuse s'il y a beaucoup d'onglets. Pour de meilleures performances, il est recommandé de définir manuellement configuré
populate
àfalse
si vous n'avez pas besoin des détails de l'onglet. tabs
-
array
de valeurs entières spécifiant un ou plusieurs onglets à mettre en évidence. Les onglets surlignés précédemment qui ne sont pas inclus dans lesonglets
cesseront d'être surlignés. Le premier onglet desonglets
devient actif.
Valeur retournée
Une Promise
qui sera remplie avec un objet windows.Window
contenant des détails sur la fenêtre dont les onglets ont été mis en surbrillance. Si la fenêtre n'a pas pu être trouvée ou qu'une autre erreur se produit, la promesse sera rejetée avec un message d'erreur.
Compatibilité des navigateurs
BCD tables only load in the browser
Note :
Cette API est basée sur l'API chrome.tabs
de Chromium. Cette documentation est dérivée de tabs.json
dans le code de Chromium code.
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.