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

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é du navigateur

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxOperaFirefox pour Android
Support simpleChrome Support complet OuiEdge Support complet 14Firefox Support complet 45Opera Support complet OuiFirefox Android Aucun support Non
getInfoChrome Support complet 18Edge Support complet 14Firefox Support complet 45Opera Support complet 15Firefox Android Aucun support Non
getInfo.windowTypes
ObsolèteNon-standard
Chrome Support complet 46Edge Support complet 14Firefox Aucun support NonOpera Support complet 33Firefox Android Aucun support Non

Légende

Support complet  
Support complet
Aucun support  
Aucun support
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Fonctionnalité non-standard. Celle-ci peut être incorrectement supportée par les autres navigateurs.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.
Obsolète. Les nouveaux sites web ne doivent pas utiliser cette fonctionnalité.

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

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,