webNavigation.onReferenceFragmentUpdated
Wird ausgelöst, wenn der Fragment-Identifier einer Seite geändert wird. Wenn eine Seite beispielsweise ein Inhaltsverzeichnis mit Fragmenten implementiert und der Benutzer auf einen Eintrag im Inhaltsverzeichnis klickt, wird dieses Ereignis ausgelöst. Alle zukünftigen Ereignisse für diesen Frame verwenden die aktualisierte URL.
Syntax
browser.webNavigation.onReferenceFragmentUpdated.addListener(
listener, // function
filter // optional object
)
browser.webNavigation.onReferenceFragmentUpdated.removeListener(listener)
browser.webNavigation.onReferenceFragmentUpdated.hasListener(listener)
Ereignisse haben drei Funktionen:
addListener(listener)
-
Fügt diesem Ereignis einen Listener hinzu.
removeListener(listener)
-
Das Hören auf dieses Ereignis beenden. Das Argument
listener
ist der zu entfernende Listener. hasListener(listener)
-
Überprüfen Sie, ob
listener
für dieses Ereignis registriert ist. Gibttrue
zurück, wenn es zuhört, andernfallsfalse
.
Syntax von addListener
Parameter
listener
-
Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt. Der Funktion wird dieses Argument übergeben:
filter
Optional-
object
. Ein Objekt mit einer einzelnen Eigenschafturl
, die einArray
vonevents.UrlFilter
Objekten ist. Wenn Sie diesen Parameter angeben, wird das Ereignis nur für Übergänge zu URLs ausgelöst, die mit mindestens einemUrlFilter
im Array übereinstimmen. Wenn Sie diesen Parameter weglassen, wird das Ereignis für alle Übergänge ausgelöst.
Zusätzliche Objekte
details
tabId
-
integer
. Die ID des Tabs, in dem die Navigation stattfinden wird. url
-
string
. Die URL, zu der der gegebene Frame navigieren wird. processId
Optional Veraltet-
integer
. Dieser Wert wird in modernen Browsern nicht gesetzt. Wenn er gesetzt wurde, repräsentierte er die ID des Prozesses, der den Renderer für diesen Tab ausführte. frameId
-
integer
. Frame, in dem die Navigation stattfinden wird.0
bedeutet, dass die Navigation im obersten Browsing-Kontext des Tabs stattfindet, nicht in einem verschachtelten<iframe>
. Ein positiver Wert zeigt an, dass die Navigation in einem verschachtelten iframe stattfindet. Frame-IDs sind einzigartig für einen bestimmten Tab und Prozess. timeStamp
-
number
. Die Zeit, zu der der Fragment-Identifier der Seite geändert wurde, in Millisekunden seit der Epoche. transitionType
-
. Der Grund für die Navigation: zum BeispieltransitionType
"link"
, wenn der Benutzer auf einen Link geklickt hat. transitionQualifiers
-
Array
vontransitionQualifier
. Zusätzliche Informationen über die Navigation: zum Beispiel, ob es eine Server- oder Client-Weiterleitung gab.
Browser-Kompatibilität
BCD tables only load in the browser
Beispiele
Protokolliert die Ziel-URLs und zusätzliche Übergangsinformationen für onReferenceFragmentUpdated
, falls der Hostname der Ziel-URL "example.com" enthält oder mit "developer" beginnt.
const filter = {
url: [{ hostContains: "example.com" }, { hostPrefix: "developer" }],
};
function logOnReferenceFragmentUpdated(details) {
console.log(`onReferenceFragmentUpdated: ${details.url}`);
console.log(`Transition type: ${details.transitionType}`);
console.log(`Transition qualifiers: ${details.transitionQualifiers}`);
}
browser.webNavigation.onReferenceFragmentUpdated.addListener(
logOnReferenceFragmentUpdated,
filter,
);
Hinweis: Diese API basiert auf der chrome.webNavigation
API von Chromium. Diese Dokumentation stammt von web_navigation.json
im Chromium-Code.