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
getInfo
Facultatif-
object
.populate
Facultatif-
boolean
. Si c'est vrai, l'objetwindows.Window
aura une propriété de tabulation contenant une liste d'objetstabs.Tab
représentant les onglets de la fenêtre. Les objets d'onglets ne contiennent que les propriétésurl
,title
etfavIconUrl
si le fichier manifest de l'extension comprend la permission"tabs"
. windowTypes
Facultatif-
Un ensemble d'objets
windows.WindowType
. Si défini, lewindows.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.
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.