Obtient des informations sur toutes les fenêtres ouvertes, en les passant dans un rappel.

Il s'agit d'une fonction asynchrone qui renvoie une Promesse.

Syntaxe

var gettingAll = browser.windows.getAll(
  getInfo                // optional object
)

Paramètres

getInfoFacultatif
object. Cela contrôle ce que les objets windows.Window sont récupérés.
populateFacultatif
boolean. Par défaut, c'est Faux. Si c'est définie sur true, chaque objet windows.Window aura une propriété de tabulation contenant une liste d'objets tabs.Tab représentant les onglets de cette fenêtre. Les objets d'onglets ne contiennent que les propriétés url, title et favIconUrl si le fichier manifeste de l'extension comprend la permission "onglets".
windowTypesFacultatif
Un ensemble d'objets windows.WindowType. Si cette option est définie, les objets windows.Window renvoyés seront filtrés en fonction de leur type. Si désactivé, le filtre par défaut est réglé sur ['normal', 'panel', 'popup'], avec des types de fenêtres 'panel' qui sont limités aux propres fenêtres de l'extension.

Valeur retournée

Une Promesse qui sera remplie avec un ensemble d'objets  windows.Window, représentant toutes les fenêtres qui correspondent aux critères donnés. Si une erreur survient, la promesse sera rejetée avec un message d'erreur.

Compatibilité du navigateur

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic supportYesYes45NoYes
populateYesNo45NoYes
windowTypes46Yes45No33

Exemples

Enregistrez les URL pour les onglets sur toutes les fenêtres de navigateur "normales". Notez que vous aurez besoin de permission "onglets" pour accéder aux URLs des onglets.

function logTabsForWindows(windowInfoArray) {
  for (windowInfo of windowInfoArray) {
    console.log(`Window: ${windowInfo.id}`);
    console.log(windowInfo.tabs.map((tab) => {return tab.url}));
  }
}

function onError(error) {
  console.log(`Error: ${error}`);
}

browser.browserAction.onClicked.addListener((tab) => {
  var getting = browser.windows.getAll({
    populate: true,
    windowTypes: ["normal"]
  });
  getting.then(logTabsForWindows, onError);
});

Example extensions

Remerciements

Cette API est basée sur l'API de Chromnium chrome.windows. Cette documentation provient de windows.json dans le code de Chromium.

Les données de compatibilité Microsoft Edge sont fournies par Microsoft Corporation et sont incluses ici sous la licence Creative Commons Attribution 3.0 United States.

Étiquettes et contributeurs liés au document

 Contributeurs à cette page : hellosct1
 Dernière mise à jour par : hellosct1,