windows.getLastFocused()

Syntaxe

var gettingWindow = browser.windows.getLastFocused(
  getInfo, // optional object
);

Paramètres

getInfoFacultatif

object.

populateFacultatif

boolean. Si c'est vrai, l'objet windows.Window aura une propriété de tabulation contenant une liste d'objets tabs.Tab représentant les onglets de la fenêtre. Les objets d'onglets ne contiennent que les propriétés url, title et favIconUrl si le fichier manifest de l'extension comprend la permission "tabs".

windowTypesFacultatif

Un ensemble d'objets windows.WindowType. Si défini, le windows.Window retourné sera filtré en fonction de son type. Si désactivé, le filtre par défaut est réglé sur ['normal', 'panel', 'popup'], avec le type de fenêtre 'panel' qui sont limités aux propres fenêtres de l'extension.

Valeur retournée

Une Promise qui sera remplie avec un objet windows.Window contenant les détails de la dernière fenêtre ciblée. Si une erreur survient, la promesse sera rejetée avec un message d'erreur.

Compatibilité des navigateurs

Exemples

Obtenez la dernière fenêtre ciblée et enregistrez les onglets qu'elle contient. Notez que vous aurez besoin de la permission "tabs" pour accéder aux URL des onglets.

function logTabs(windowInfo) {
  for (tabInfo of windowInfo.tabs) {
    console.log(tabInfo.url);
  }
}

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

browser.browserAction.onClicked.addListener((tab) => {
  var getting = browser.windows.getLastFocused({ populate: true });
  getting.then(logTabs, onError);
});