MDN wants to learn about developers like you: https://qsurvey.mozilla.com/s3/MDN-dev-survey

Modules

windows.getLastFocused()

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

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

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 Promesse 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

ChromeEdgeFirefoxFirefox for AndroidOpera
Basic supportYesYes45NoYes
getInfo18Yes45No15
getInfo.windowTypes46Yes45No33

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,