windows.getAll()

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 Promise.

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 Ă  false.  S'il est dĂ©fini sur true, chaque objet windows.Window aura une propriĂ©tĂ© tabs qui contient une liste d'objets tabs.Tab reprĂ©sentant les tabs de cette fenĂȘtre. Les objets Tab contiendront les propriĂ©tĂ©s url, title et favIconUrl uniquement si le fichier manifest de l'extension contient les permissions "tabs".
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 Promise 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

BCD tables only load in the browser

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.