windows.getLastFocused()

Obtient la fenêtre qui a été recentrée récemment — généralement la fenêtre 'en haut'.

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

Syntaxe

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

Note :

Si fourni, le composant windowTypes de getInfo est ignoré. L'utilisation de windowTypes a été dépréciée à partir de Firefox 62.

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

BCD tables only load in the browser

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.

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

Note :

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.