extension.getViews()
Renvoie un tableau des objets Window pour chacune des pages exécutées dans l'extension en cours. Cela inclut, par exemple :
- la page d'arrière-plan, si une est définie
- toutes les pages contextuelles, si définies et chargées
- toutes les pages d'options, si définies et chargées
- les onglets du navigateur hébergeant le contenu fourni avec l'extension
Dans Firefox, si cette méthode est appelée à partir d'une page faisant partie d'une fenêtre de navigation privée, telle qu'une barre latérale dans une fenêtre privée ou une fenêtre ouverte à partir d'une fenêtre privée, sa valeur de retour n'inclut pas la page d'arrière-plan de l'extension.
Syntaxe
var windows = browser.extension.getViews(
fetchProperties, // optional object
);
Paramètres
fetchProperties
Facultatif-
object
.type
Facultatif-
string
. Unextension.ViewType
indiquant le type de vue à obtenir. Si omis, cette fonction renvoie toutes les vues. windowId
Facultatif-
integer
. La fenêtre pour restreindre la recherche. Si omis, cette fonction renvoie toutes les vues.
Valeur retournée
array
of object
. Un tableau d'objets Window.
Compatibilité des navigateurs
BCD tables only load in the browser
Exemples
Obtenez toutes les fenêtres appartenant à cette extension et consignez leurs URL :
var windows = browser.extension.getViews();
for (var extensionWindow of windows) {
console.log(extensionWindow.location.href);
}
Obtenez uniquement des fenêtres dans les onglets du navigateur hébergeant du contenu fourni avec l'extension :
var windows = browser.extension.getViews({ type: "tab" });
Obtenir seulement des fenêtres dans les popups :
var windows = browser.extension.getViews({ type: "popup" });
Note :
Cette API est basée sur l'API Chromium chrome.extension
. Cette documentation est dérivée de extension.json
dans le code Chromium.
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.