--- title: extension.getViews() slug: Mozilla/Add-ons/WebExtensions/API/extension/getViews tags: - API - Add-ons - Extension - Extensions - Méthode - Non-standard - Reference - WebExtensions - getViews translation_of: Mozilla/Add-ons/WebExtensions/API/extension/getViews ---
{{AddonSidebar()}}

Renvoie un tableau des objets Window pour chacune des pages exécutées dans l'extension en cours. Cela inclut, par exemple :

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{{optional_inline}}

object.

type{{optional_inline}}
string. Un {{WebExtAPIRef('extension.ViewType')}} indiquant le type de vue à obtenir. Si omis, cette fonction renvoie toutes les vues.
windowId{{optional_inline}}
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é du navigateur

{{Compat("webextensions.api.extension.getViews")}}

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"});

{{WebExtExamples}}

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.