tabs.query()

queryObj

object. Функция query() получит только те вкладки, свойства которых совпадают с указанными здесь.

См. документацию tabs.Tab, чтобы узнать больше об этих свойствах.

active Необязательно

boolean. Являются ли вкладки активными в своих окнах.

audible Необязательно

boolean. Являются ли вкладки звуковыми.

autoDiscardable Необязательно

boolean. Могут ли вкладки быть автоматически удалены браузером при низких ресурсах.

cookieStoreId Необязательно

string или array из string. Используйте это для возвращения вкладок, чьи tab.cookieStoreId совпадают с любым из cookieStoreId строк. Этот параметр доступен только, если у дополнения есть разрешение "cookies" разрешение.

currentWindow Необязательно

boolean. Являются ли вкладки в текущем окне.

discarded Необязательно

boolean. Являются ли вкладки удаленными. Удаленная вкладка — это вкладка, содержимое которой было загружено из памяти, но она все еще отображается в строке вкладок. Ее содержимое перезагружается при следующем активации.

hidden Необязательно

boolean. Являются ли вкладки скрытыми.

highlighted Необязательно

boolean. Являются ли вкладки выделенными.

index Необязательно

integer. Положение вкладок в их окнах.

muted Необязательно

boolean. Являются ли вкладки выключенными.

lastFocusedWindow Необязательно

boolean. Являются ли вкладки в последнем фокусированном окне.

pinned Необязательно

boolean. Являются ли вкладки закрепленными.

status Необязательно

tabs.TabStatus. Загрузились ли вкладки.

title Необязательно

string. Сопоставление заголовков страниц с шаблоном. Требует разрешения "tabs" или разрешения на доступ к хосту для сопоставления вкладки.

url Необязательно

string или array из string. Сопоставление вкладок с одним или несколькими шаблонами сопоставления. Обратите внимание, что идентификаторы фрагментов не сопоставляются. Требует разрешения "tabs" или разрешения на доступ к хосту для сопоставления вкладки.

windowId Необязательно

integer. id родительского окна или windows.WINDOW_ID_CURRENT для текущего окна.

windowType Необязательно

tabs.WindowType. Тип окна, в котором находятся вкладки.

A Promise, который будет выполнен с array из tabs.Tab объектов, содержащих информацию о каждой совпадающей вкладке.

Если произошла какая-либо ошибка, обещание будет отклонено с сообщением об ошибке.

Получить все вкладки:

function logTabs(tabs) {
  for (const tab of tabs) {
    // tab.url requires the `tabs` permission or a matching host permission.
    console.log(tab.url);
  }
}

function onError(error) {
  console.error(`Error: ${error}`);
}

browser.tabs.query({}).then(logTabs, onError);

Получить все вкладки в текущем окне:

function logTabs(tabs) {
  for (const tab of tabs) {
    // tab.url requires the `tabs` permission or a matching host permission.
    console.log(tab.url);
  }
}

function onError(error) {
  console.error(`Error: ${error}`);
}

browser.tabs.query({ currentWindow: true }).then(logTabs, onError);

Получить активную вкладку в текущем окне:

function logTabs(tabs) {
  // tabs[0].url requires the `tabs` permission or a matching host permission.
  console.log(tabs[0].url);
}

function onError(error) {
  console.error(`Error: ${error}`);
}

browser.tabs
  .query({ currentWindow: true, active: true })
  .then(logTabs, onError);

Получить вкладки для всех URL-адресов HTTP и HTTPS по адресу "mozilla.org" или любого из его дочерних доменов:

function logTabs(tabs) {
  for (const tab of tabs) {
    // tab.url requires the `tabs` permission or a matching host permission.
    console.log(tab.url);
  }
}

function onError(error) {
  console.error(`Error: ${error}`);
}

browser.tabs.query({ url: "*://*.mozilla.org/*" }).then(logTabs, onError);

• annotate-page
• apply-css
• beastify
• bookmark-it
• chill-out
• contextual-identities
• cookie-bg-picker
• find-across-tabs
• history-deleter
• imagify
• list-cookies
• session-state
• tabs-tabs-tabs