windows.getAll()
Obtient des informations sur toutes les fenĂȘtres ouvertes, en les passant dans un rappel.
Il s'agit d'une fonction asynchrone qui renvoie une Promise
.
Syntaxe
var gettingAll = browser.windows.getAll(
getInfo // optional object
)
ParamĂštres
getInfo
Facultatifobject
. Cela contrĂŽle ce que les objetswindows.Window
sont récupérés.-
populate
Facultatifboolean
Par dĂ©faut Ăfalse
. S'il est défini surtrue
, chaque objetwindows.Window
aura une propriététabs
qui contient une liste d'objetstabs.Tab
reprĂ©sentant les tabs de cette fenĂȘtre. Les objetsTab
contiendront les propriétésurl
,title
etfavIconUrl
uniquement si le fichier manifest de l'extension contient les permissions"tabs"
.windowTypes
FacultatifUn ensemble d'objets
windows.WindowType
. Si cette option est définie, les objetswindows.Window
renvoyés seront filtrés en fonction de leur type. Si désactivé, le filtre par défaut est réglé sur['normal', 'panel', 'popup']
, avec des types de fenĂȘtres'panel'
qui sont limitĂ©s aux propres fenĂȘtres de l'extension.
Valeur retournée
Une Promise
qui sera remplie avec un ensemble d'objets windows.Window
, reprĂ©sentant toutes les fenĂȘtres qui correspondent aux critĂšres donnĂ©s. Si une erreur survient, la promesse sera rejetĂ©e avec un message d'erreur.
Compatibilité du navigateur
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Exemples
Enregistrez les URL pour les onglets sur toutes les fenĂȘtres de navigateur "normales". Notez que vous aurez besoin de permission "onglets" pour accĂ©der aux URLs des onglets.
function logTabsForWindows(windowInfoArray) {
for (windowInfo of windowInfoArray) {
console.log(`Window: ${windowInfo.id}`);
console.log(windowInfo.tabs.map((tab) => {return tab.url}));
}
}
function onError(error) {
console.log(`Error: ${error}`);
}
browser.browserAction.onClicked.addListener((tab) => {
var getting = browser.windows.getAll({
populate: true,
windowTypes: ["normal"]
});
getting.then(logTabsForWindows, onError);
});
Example extensions
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.