tabs.onUpdated

browser.tabs.onUpdated.addListener(listener[, extraParameters])
browser.tabs.onUpdated.removeListener(listener)
browser.tabs.onUpdated.hasListener(listener)

События имеют три функции:

addListener(callback[, extraParameters])

Добавляет слушателя к этому событию.

removeListener(listener)

Прекращает прослушивание этого события. Аргумент listener — это слушатель, который необходимо удалить.

hasListener(listener)

Проверяет, зарегистрирован ли listener для этого события. Возвращает true , если он прослушивает, false в противном случае.

callback

Функция, вызываемая при возникновении этого события. Функция получает следующие аргументы:

tabId

integer. Идентификатор обновленной вкладки.

changeInfo

object. Свойства вкладки, которые изменились. Дополнительные сведения см. в разделе changeInfo.

tab

tabs.Tab. Новое состояние вкладки.

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

object. Набор фильтров, которые ограничивают события, отправляемые этому слушателю. Этот объект может иметь одно или несколько из этих свойств. События отправляются только в том случае, если они удовлетворяют всем заданным фильтрам.

urls

Array. Массив шаблонов соответствия. Срабатывает только для вкладок, чье текущее свойство url соответствует одному из шаблонов.

properties

Array. Массив строк, содержащих имена свойств объекта tabs.Tab. Событие срабатывает только при изменении одного из свойств, указанных в массиве. Эти свойства могут быть:

• "attention"
• "audible"
• "discarded"
• "favIconUrl"
• "hidden"
• "isArticle"
• "mutedInfo"
• "pinned"
• "status"
• "title"
• "url"

Примечание: Значение "url" поддерживается с Firefox 88. В Firefox 87 и более ранних версиях изменения "url" можно наблюдать, отфильтровав по "status".

tabId

Integer. Срабатывает только для вкладки, идентифицированной этим ID.

windowId

Integer. Срабатывает только для вкладок в окне, идентифицированном этим ID.

Перечисляет изменения в состоянии обновленной вкладки. Более подробную информацию об этих свойствах см. в документации tabs.Tab. Обратите внимание, что не все свойства tabs.Tab поддерживаются.

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

boolean. Указывает, привлекает ли вкладка внимание. Например, attention является true при отображении вкладки модального диалогового окна.

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

boolean. Новое состояние звука вкладки.

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

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

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

string. Новый URL значка вкладки. Не включено, когда вкладка теряет свой значок (переход от страницы с значком к странице без него). Проверьте favIconUrl в вкладке вместо этого.

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

boolean. True, если вкладка hidden.

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

boolean. True, если вкладка является статьей и, следовательно, подходит для отображения в Reader Mode.

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

tabs.MutedInfo. Новое состояние отключения звука вкладки и причина изменения.

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

boolean. Новое состояние закрепления вкладки.

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

string. Статус вкладки. Может быть либо loading, либо complete.

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

string. Новый заголовок вкладки.

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

string. URL вкладки, если он изменился.

Прослушивание и вывод всех сведений об изменениях и нового состояния:

function handleUpdated(tabId, changeInfo, tabInfo) {
  console.log(`Updated tab: ${tabId}`);
  console.log("Changed attributes: ", changeInfo);
  console.log("New tab Info: ", tabInfo);
}

browser.tabs.onUpdated.addListener(handleUpdated);

Вывод изменений в URL:

function handleUpdated(tabId, changeInfo, tabInfo) {
  if (changeInfo.url) {
    console.log(`Tab: ${tabId} URL changed to ${changeInfo.url}`);
  }
}

browser.tabs.onUpdated.addListener(handleUpdated);

Выводить изменения только для вкладок, чье свойство url соответствует https://developer.mozilla.org/* или https://twitter.com/mozdevnet:

const pattern1 = "https://developer.mozilla.org/*";
const pattern2 = "https://twitter.com/mozdevnet";

const filter = {
  urls: [pattern1, pattern2]
}

function handleUpdated(tabId, changeInfo, tabInfo) {
  console.log(`Updated tab: ${tabId}`);
  console.log("Changed attributes: ", changeInfo);
  console.log("New tab Info: ", tabInfo);
}

browser.tabs.onUpdated.addListener(handleUpdated, filter);

Выводить изменения только для свойства pinned вкладок (т.е. действия закрепления и открепления):

const filter = {
  properties: ["pinned"]
}

function handleUpdated(tabId, changeInfo, tabInfo) {
  console.log(`Updated tab: ${tabId}`);
  console.log("Changed attributes: ", changeInfo);
  console.log("New tab Info: ", tabInfo);
}

browser.tabs.onUpdated.addListener(handleUpdated, filter);

Комбинирование предыдущих фильтров, вывод только тогда, когда свойство pinned вкладок изменяется для вкладок, чье свойство url соответствует https://developer.mozilla.org/* или https://twitter.com/mozdevnet:

const pattern1 = "https://developer.mozilla.org/*";
const pattern2 = "https://twitter.com/mozdevnet";

const filter = {
  urls: [pattern1, pattern2],
  properties: ["pinned"]
}

function handleUpdated(tabId, changeInfo, tabInfo) {
  console.log(`Updated tab: ${tabId}`);
  console.log("Changed attributes: ", changeInfo);
  console.log("New tab Info: ", tabInfo);
}

browser.tabs.onUpdated.addListener(
  handleUpdated,
  filter);

Вывод изменений только тогда, когда свойство pinned вкладок меняется для вкладок, чье свойство url соответствует https://developer.mozilla.org/* или https://twitter.com/mozdevnet , где вкладка была частью текущего браузера при срабатывании события обновления:

const pattern1 = "https://developer.mozilla.org/*";
const pattern2 = "https://twitter.com/mozdevnet";

const filter = {
  urls: [pattern1, pattern2],
  properties: ["pinned"],
  windowId: browser.windows.WINDOW_ID_CURRENT
}

function handleUpdated(tabId, changeInfo, tabInfo) {
  console.log(`Updated tab: ${tabId}`);
  console.log("Changed attributes: ", changeInfo);
  console.log("New tab Info: ", tabInfo);
}

browser.tabs.onUpdated.addListener(
  handleUpdated,
  filter);

• annotate-page
• apply-css
• bookmark-it
• chill-out
• cookie-bg-picker
• history-deleter
• session-state