Wird ausgelöst, wenn ein Tab aktualisiert wird.

Wenn der Benutzer in einem Tab zu einer neuen URL navigiert, generiert dies typischerweise mehrereonUpdated-Ereignisse, da verschiedene Eigenschaften destabs.Tab-Objekts aktualisiert werden. Dazu gehört dieurl, aber potenziell auch die Eigenschaftentitle undfavIconUrl. Die Eigenschaftstatus wechselt zwischen"loading" und"complete".

Dieses Ereignis wird auch bei Änderungen an den Eigenschaften eines Tabs ausgelöst, die keine Navigation beinhalten, wie das Anheften und Lösen (was die Eigenschaftpinned aktualisiert) und das Stummschalten oder Aufheben der Stummschaltung (was die Eigenschaftenaudible undmutedInfo aktualisiert).

Sie können dieses Ereignis filtern, sodass es nur für Tabs ausgelöst wird, deren URLs bestimmtenMustern entsprechen, Änderungen an bestimmten Eigenschaften, Änderungen an einem Tab oder Fenster oder jede Kombination dieser Einschränkungen.

Syntax

browser.tabs.onUpdated.addListener(  listener, // function  filter     // optional object)browser.tabs.onUpdated.removeListener(listener)browser.tabs.onUpdated.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(callback, filter)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Beendet das Lauschen auf dieses Ereignis. Das Argumentlistener ist der zu entfernende Listener.

hasListener(listener)

Überprüft, oblistener für dieses Ereignis registriert ist. Gibttrue zurück, wenn es lauscht, andernfallsfalse.

addListener Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis auftritt. Der Funktion werden diese Argumente übergeben:

tabId

integer. Die ID des aktualisierten Tabs.

changeInfo

object. Eigenschaften des Tabs, die sich geändert haben. Weitere Einzelheiten finden Sie im AbschnittchangeInfo.

tab

tabs.Tab. Der neue Zustand des Tabs.

filterOptional

object. Eine Reihe von Filtern, die die an diesen Listener gesendeten Ereignisse einschränken. Dieses Objekt kann eine oder mehrere dieser Eigenschaften haben. Ereignisse werden nur gesendet, wenn sie alle angegebenen Filter erfüllen.

urls

Array. Ein Array vonMusterübereinstimmungen. Löst das Ereignis nur für Tabs aus, deren aktuelleurl-Eigenschaft einem der Muster entspricht.

properties

Array. Ein Array von Zeichenfolgen, das unterstützte Eigenschaftsnamen vontabs.Tab-Objekten enthält. Löst das Ereignis nur bei Änderungen einer der im Array benannten Eigenschaften aus. Diese Eigenschaften können verwendet werden:

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

Hinweis:Der Wert "url" wird seit Firefox 88 unterstützt. In Firefox 87 und früher könnenurl-Änderungen durch Filtern nachstatus beobachtet werden.

tabId

Integer. Löst dieses Ereignis nur für den Tab aus, der durch diese ID identifiziert wird.

windowId

Integer. Löst dieses Ereignis nur für Tabs im durch diese ID identifizierten Fenster aus.

cookieStoreId

Integer. Löst dieses Ereignis nur für Tabs im durch diese ID identifizierten Cookie-Store aus.

Zusätzliche Objekte

changeInfo

Listet die Änderungen am Zustand des aktualisierten Tabs auf. Um mehr über diese Eigenschaften zu erfahren, lesen Sie die Dokumentation zutabs.Tab. Beachten Sie, dass nicht alle Eigenschaften vontabs.Tab unterstützt werden.

attentionOptional

boolean. Gibt an, ob der Tab Aufmerksamkeit erregt. Zum Beispiel istattentiontrue, wenn der Tab einen modalen Dialog anzeigt.

audibleOptional

boolean. Der neue hörbare Zustand des Tabs.

autoDiscardableOptional

boolean. Ob der Tab vom Browser verworfen werden kann. Der Standardwert isttrue. Wennfalse gesetzt ist, kann der Browser den Tab nicht automatisch verwerfen. Der Tab kann jedoch durchtabs.discard verworfen werden.

discardedOptional

boolean. Ob der Tab verworfen ist. Ein verworfener Tab ist einer, dessen Inhalt aus dem Speicher entladen wurde, aber im Tab-Bereich sichtbar ist. Sein Inhalt wird beim nächsten Aktivieren neu geladen.

favIconUrlOptional

string. Die neue Favicon-URL des Tabs. Wird nicht eingeschlossen, wenn ein Tab sein Favicon verliert (von einer Seite mit Favicon zu einer Seite ohne Favicon navigiert). Überprüfen SiefavIconUrl imtab stattdessen.

groupIdOptional

integer. Die ID der Gruppe, in der sich die Tabs befinden, oder-1 (tabGroups.TAB_GROUP_ID_NONE) für nicht gruppierte Tabs.

hiddenOptional

boolean. Wahr, wenn der Tabhidden ist.

isArticleOptional

boolean. Wahr, wenn der Tab ein Artikel ist und daher für die Anzeige imReader-Modus geeignet ist.

mutedInfoOptional

tabs.MutedInfo. Der neue Stummschaltezustand des Tabs und der Grund für die Änderung.

openerTabIdOptional

integer. Die ID des Tabs, der diesen Tab geöffnet hat, falls vorhanden. Diese Eigenschaft ist nur vorhanden, wenn der eröffnende Tab existiert und sich im gleichen Fenster befindet.

pinnedOptional

boolean. Der neue angeheftete Zustand des Tabs.

statusOptional

string. Der Status des Tabs. Kann entwederloading odercomplete sein.

titleOptional

string. Der neue Titel des Tabs.

urlOptional

string. Die URL des Tabs, falls sie sich geändert hat.

Beispiele

Hören Sie auf und protokollieren Sie alle Änderungsinformationen und den neuen Zustand:

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);

Protokollieren Sie Änderungen an URLs:

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

Filterbeispiele

Protokollieren Sie Änderungen nur für Tabs, derenurl-Eigenschaft mithttps://developer.mozilla.org/* oderhttps://mastodon.social/@mdnübereinstimmt:

const pattern1 = "https://developer.mozilla.org/*";const pattern2 = "https://mastodon.social/@mdn";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);

Protokollieren Sie Änderungen nur an derpinned-Eigenschaft von Tabs (d.h. Anheft- und Lösaktionen):

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);

Kombinieren Sie beide vorangehenden Filter, protokollieren Sie nur, wenn diepinned-Eigenschaft von Tabs geändert wird, derenurl-Eigenschaft mithttps://developer.mozilla.org/* oderhttps://mastodon.social/@mdnübereinstimmt:

const pattern1 = "https://developer.mozilla.org/*";const pattern2 = "https://mastodon.social/@mdn";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);

Protokollieren Sie Änderungen nur, wenn sich diepinned-Eigenschaft von Tabs ändert, derenurl-Eigenschaft mithttps://developer.mozilla.org/* oderhttps://mastodon.social/@mdnübereinstimmt, wobei sich der Tab im aktuellen Browserfenster befand, als das Aktualisierungsereignis ausgelöst wurde:

const pattern1 = "https://developer.mozilla.org/*";const pattern2 = "https://mastodon.social/@mdn";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);

Beispielerweiterungen

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

Browser-Kompatibilität