tabs.query()
Obtient tous les onglets qui ont les propriétés spécifiées, ou tous les onglets si aucune propriété n'est spécifiée.
C'est une fonction asynchrone qui renvoie une Promise
.
Syntaxe
var querying = browser.tabs.query(
queryInfo, // object
);
Paramètres
queryInfo
-
object
. La fonctionquery()
obtiendra uniquement les onglets dont les propriétés correspondent aux propriétés incluses ici. Pour en savoir plus sur ces propriétés, consultez la documentationtabs.Tab
.active
Facultatif-
boolean
. Si les onglets sont actifs dans leurs fenêtres. audible
Facultatif-
boolean
. Si les onglets sont audibles. autoDiscardable
Facultatif-
boolean
. Si les onglets peuvent être supprimés automatiquement par le navigateur lorsque les ressources sont faibles. -
string
. Utilisez cette option pour renvoyer uniquement les onglets dont l'ID estcookieStoreId
. Cette option n'est disponible que si l'extension à la permission"cookies"
currentWindow
Facultatif-
boolean
. Si les onglets sont dans la fenêtre actuelle. discarded
Facultatif-
boolean
. Si les onglets sont supprimés. Un onglet supprimé est celui dont le contenu a été déchargé de la mémoire, mais est toujours visible dans la bande d'onglets. Son contenu est rechargé la prochaine fois qu'il est activé. -
boolean
. Si les onglets sont cachés. highlighted
Facultatif-
boolean
. Si les onglets sont en surbrillance. index
Facultatif-
integer
. La position des onglets dans leurs fenêtres. muted
Facultatif-
boolean
. Si les onglets sont en sourdine. lastFocusedWindow
Facultatif-
boolean
. Si les onglets sont dans la dernière fenêtre focalisée. openerTabId
Facultatif-
integer
. L'ID de l'onglet qui a ouvert cet onglet. pinned
Facultatif-
boolean
. Si les onglets sont épinglés. status
Facultatif-
tabs.TabStatus
. Si les onglets ont terminé le chargement. title
Facultatif-
string
. Faites correspondre les titres de page à un motif. url
Facultatif-
string
ouarray de string
. Faites correspondre les onglets avec un ou plusieurs modèle de correspondance. Notez que les identificateurs de fragment ne sont pas appariés. windowId
Facultatif-
integer
. L'ID de la fenêtre parente, ouwindows.WINDOW_ID_CURRENT
pour la fenêtre en cours. windowType
Facultatif-
tabs.WindowType
. Le type de fenêtre dans lequel les onglets y sont.
Valeur retournée
Exemples
Obtenez tous les onglets :
function logTabs(tabs) {
for (let tab of tabs) {
// tab.url requires the `tabs` permission
console.log(tab.url);
}
}
function onError(error) {
console.log(`Error: ${error}`);
}
var querying = browser.tabs.query({});
querying.then(logTabs, onError);
Obtenez tous les onglets dans la fenêtre actuelle :
function logTabs(tabs) {
for (let tab of tabs) {
// tab.url requires the `tabs` permission
console.log(tab.url);
}
}
function onError(error) {
console.log(`Error: ${error}`);
}
var querying = browser.tabs.query({ currentWindow: true });
querying.then(logTabs, onError);
Obtenez l'onglet actif dans la fenêtre actuelle :
function logTabs(tabs) {
for (let tab of tabs) {
// tab.url requires the `tabs` permission
console.log(tab.url);
}
}
function onError(error) {
console.log(`Error: ${error}`);
}
var querying = browser.tabs.query({ currentWindow: true, active: true });
querying.then(logTabs, onError);
Obtenez des onglets pour toutes les URL HTTP et HTTPS sous "mozilla.org" ou l'un de ses sous-domaines :
function logTabs(tabs) {
for (let tab of tabs) {
// tab.url requires the `tabs` permission
console.log(tab.url);
}
}
function onError(error) {
console.log(`Error: ${error}`);
}
var querying = browser.tabs.query({ url: "*://*.mozilla.org/*" });
querying.then(logTabs, onError);
Example extensions
Compatibilité des navigateurs
BCD tables only load in the browser
Note :
Cette API est basée sur l'API Chromium chrome.tabs
. Cette documentation est dérivée de tabs.json
dans le code de Chromium code.
Les données de compatibilité relatives à Microsoft Edge sont fournies par Microsoft Corporation et incluses ici sous la licence Creative Commons Attribution 3.0 pour les États-Unis.