chrome.webNavigation

Beschreibung

Verwenden Sie die chrome.webNavigation API, um Benachrichtigungen über den Status laufender Navigationsanfragen zu erhalten.

Berechtigungen

webNavigation

Für alle chrome.webNavigation-Methoden und -Ereignisse muss die Berechtigung "webNavigation" deklariert werden im Erweiterungsmanifest. Beispiel:

{
  "name": "My extension",
  ...
  "permissions": [
    "webNavigation"
  ],
  ...
}

Konzepte und Verwendung

Ereignisreihenfolge

Für eine Navigation, die erfolgreich abgeschlossen wurde, werden Ereignisse in der folgenden Reihenfolge ausgelöst:

onBeforeNavigate -> onCommitted -> [onDOMContentLoaded] -> onCompleted

Jeder Fehler, der während des Vorgangs auftritt, führt zu einem onErrorOccurred-Ereignis. Für eine bestimmte werden nach onErrorOccurred keine weiteren Ereignisse ausgelöst.

Wenn ein Navigationsframe Subframes enthält, wird sein onCommitted vor einem seiner untergeordneten Frames ausgelöst onBeforeNavigate; während onCompleted nach allen onCompleted-Elementen der untergeordneten Elemente ausgelöst wird.

Wenn das Referenzfragment eines Frames geändert wird, wird ein onReferenceFragmentUpdated-Ereignis ausgelöst. Dieses Ereignis kann jederzeit nach onDOMContentLoaded ausgelöst werden, auch nach onCompleted.

Wird die History API verwendet, um den Status eines Frames zu ändern (z.B. mit history.pushState(), wird ein onHistoryStateUpdated-Ereignis wurde ausgelöst. Dieses Ereignis kann nach dem onDOMContentLoaded jederzeit ausgelöst werden.

Wenn eine Navigation eine Seite aus dem Back-Forward-Cache wiederhergestellt hat, gilt das Ereignis onDOMContentLoaded wird nicht ausgelöst. Das Ereignis wird nicht ausgelöst, weil der Content bereits vollständig geladen ist, wenn die Seite die zum ersten Mal besucht wurden.

Wenn eine Navigation mit Chrome Instant oder Instant Pages ausgelöst wurde, wird eine vollständig geladene Seite in den aktuellen Tab verschoben. In diesem Fall wird ein onTabReplaced-Ereignis ausgelöst.

Bezug zu webRequest-Ereignissen

Es gibt keine definierte Reihenfolge zwischen den Ereignissen der webRequest API und den Ereignissen der webNavigation API. Es ist möglich, dass webRequest-Ereignisse für Frames, die bereits eine neue Navigation gestartet hat oder dass eine Navigation erst fortgesetzt wird, wenn die Netzwerkressourcen bereits vollständig geladen ist.

Im Allgemeinen sind die webNavigation-Ereignisse eng mit dem angezeigten Navigationsstatus verbunden während die webRequest-Ereignisse dem Status des Netzwerkstacks entsprechen, für den Nutzer in der Regel undurchsichtig.

Tab-IDs

Nicht alle Navigationstabs entsprechen den tatsächlichen Tabs in der Chrome-Benutzeroberfläche, z. B. ein Tab, der gerade vorab gerendert. Auf diese Tabs kann weder über die Tabs API zugegriffen werden noch können Sie Informationen anfordern. indem du webNavigation.getFrame() oder webNavigation.getAllFrames() anrufst. Sobald ein solcher Tab wird ein onTabReplaced-Ereignis ausgelöst und sie sind über diese APIs zugänglich.

Zeitstempel

Es ist wichtig zu beachten, dass einige technische Besonderheiten beim Umgang des Betriebssystems mit verschiedenen Chrome-Geräten Prozesse können dazu führen, dass die Uhr zwischen dem Browser selbst und den Erweiterungsprozessen verfälscht wird. Das bedeutet, dass für die Eigenschaft timeStamp des Ereignisses WebNavigation die Eigenschaft timeStamp nur garantiert ist, Sie muss intern konsistent sein. Wenn Sie ein Ereignis mit einem anderen vergleichen, erhalten Sie den richtigen Offset. zwischen ihnen, aber verglichen mit der aktuellen Zeit in der Erweiterung (mithilfe von (new Date()).getTime(), zu unerwarteten Ergebnissen führen.

Frame-IDs

Frames in einem Tab können anhand einer Frame-ID identifiziert werden. Die Frame-ID des Hauptframes ist immer 0, die Die ID der untergeordneten Frames ist eine positive Zahl. Sobald ein Dokument in einem Frame erstellt wurde, wird seine Frame-ID bleibt während der Lebensdauer des Dokuments gleich. Ab Chrome 49 ist diese ID auch für alle Die Lebensdauer des Frames (über mehrere Navigationen hinweg)

Aufgrund der Multi-Prozess-Struktur von Chrome kann ein Tab zum Rendern der Quelle unterschiedliche Prozesse verwenden. und Ziel einer Webseite. Wenn also eine Navigation in einem neuen Prozess stattfindet, Ereignisse sowohl von der neuen als auch von der alten Seite empfangen, bis für die neue Navigation ein Commit durchgeführt wurde (d.h. onCommitted-Ereignis für den neuen Hauptframe gesendet wird. Mit anderen Worten: Es ist möglich, als eine ausstehende Sequenz von webNavigationsereignissen mit derselben frameId. Die Sequenzen können gekennzeichnet durch den Schlüssel processId.

Beachten Sie außerdem, dass der Prozess während einer vorläufigen Last mehrmals gewechselt werden kann. Das passiert wenn die Last an eine andere Website weitergeleitet wird. In diesem Fall erhalten Sie wiederholte onBeforeNavigate- und onErrorOccurred-Ereignisse, bis du das letzte onCommitted-Ereignis erhältst.

Ein weiteres Problem bei Erweiterungen ist der Lebenszyklus der Frame. Ein Frame hostet ein Dokument, das mit einer URL verknüpft ist, für die ein Commit durchgeführt wurde. Das Dokument kann sich ändern (z. B. durch eine Navigation), die frameId hingegen nicht. dass etwas in einem bestimmten Dokument passiert ist, nur frameIds. Wir führen das Konzept einer documentId ein. Dies ist eine eindeutige Kennung pro Dokument. Wenn ein Frame navigiert wird und ein neues Dokument erstellt, ändert sich die ID. Anhand dieses Feldes lässt sich ermitteln, wenn Seiten ihren Lebenszyklusstatus ändern (zwischen „Pre-Rendering“, „Aktiv“ und „Im Cache“) weil es gleich bleibt.

Übergangstypen und Qualifier

Das webNavigation onCommitted-Ereignis hat einen transitionType und einen transitionQualifiers Property. Der Übergangstyp entspricht dem, der in der history API verwendet wird und beschreibt, wie die zu dieser URL gelangt sind. Darüber hinaus können mehrere Übergangsqualifizierer festgelegt werden. die die Navigation genauer definieren.

Die folgenden Übergangsqualifizierer sind verfügbar:

ÜbergangsqualifiziererBeschreibung
„client_redirect“Eine oder mehrere Weiterleitungen, die durch JavaScript- oder Meta-Refresh-Tags auf der Seite ausgelöst wurden, erfolgten während der Navigation.
„server_redirect“Eine oder mehrere Weiterleitungen, die durch vom Server gesendete HTTP-Header verursacht wurden, erfolgten während der Navigation.
„forward_back“Der Nutzer hat die Vorwärts- oder Zurück-Taste verwendet, um die Navigation zu starten.
"from_address_bar"Der Nutzer hat die Navigation über die Adressleiste (auch als Omnibox bezeichnet) gestartet.

Beispiele

Installieren Sie das Beispiel für die WebNavigation API aus chrome-extension-samples, um diese API auszuprobieren. zu erstellen.

Typen

TransitionQualifier

Chrome (ab Version 44)

Enum

"client_redirect"

"server_redirect"

"forward_back"

"from_address_bar"

TransitionType

Chrome (ab Version 44)

Ursache der Navigation. Es werden dieselben Übergangstypen verwendet, die in der History API definiert sind. Es handelt sich um dieselben Übergangstypen, die in der Verlaufs-API definiert sind, mit Ausnahme von "start_page" anstelle von "auto_toplevel" (aus Gründen der Abwärtskompatibilität).

Enum

"Link"

"typed"

"auto_bookmark"

"auto_subframe"

"manual_subframe"

"Generiert"

"start_page"

"form_submit"

"reload"

"Keyword"

"keyword_generated"

Methoden

getAllFrames()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.webNavigation.getAllFrames(
  details: object,
  callback?: function,
)

Ruft Informationen zu allen Frames eines bestimmten Tabs ab.

Parameter

  • Details

    Objekt

    Informationen zum Tab, von dem alle Frames abgerufen werden sollen.

    • tabId

      Zahl

      Die ID des Tabs.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details?: object[]) => void

    • Details

      Objekt[] optional

      Eine Liste der Frames auf dem jeweiligen Tab; null, wenn die angegebene Tab-ID ungültig ist.

      • documentId

        String

        Chrome 106 und höher

        Eine UUID des geladenen Dokuments.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 und höher

        Der Lebenszyklus, in dem sich das Dokument befindet.

      • errorOccurred

        boolean

        Dieser Wert ist "True", wenn die letzte Navigation in diesem Frame aufgrund eines Fehlers unterbrochen wurde, d.h., das Ereignis "onErrorOccurred" wurde ausgelöst.

      • frameId

        Zahl

        Die ID des Frames. 0 gibt an, dass dies der Hauptframe ist. ein positiver Wert die ID eines Subframes angibt.

      • frameType

        FrameType

        Chrome 106 und höher

        Der Frame-Typ, in dem die Navigation erfolgte.

      • parentDocumentId

        String optional

        Chrome 106 und höher

        Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist.

      • parentFrameId

        Zahl

        Die ID des übergeordneten Frames oder -1, wenn dies der Hauptframe ist.

      • processId

        Zahl

        Die ID des Prozesses, der den Renderer für diesen Frame ausführt.

      • URL

        String

        Die URL, die derzeit mit diesem Frame verknüpft ist.

Returns

  • Promise&lt;object[] | nicht definiert>

    Chrome 93 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

getFrame()

<ph type="x-smartling-placeholder"></ph> Versprechen 
chrome.webNavigation.getFrame(
  details: object,
  callback?: function,
)

Ruft Informationen zum angegebenen Frame ab. Ein Frame bezieht sich auf ein <iframe>-Element. oder ein <frame> einer Webseite und wird durch eine Tab-ID und eine Frame-ID identifiziert.

Parameter

  • Details

    Objekt

    Informationen über den Frame, zu dem Informationen abgerufen werden sollen.

    • documentId

      String optional

      Chrome 106 und höher

      Die UUID des Dokuments. Wenn „frameId“ und/oder „tabId“ angegeben sind, werden sie validiert, damit sie mit dem Dokument übereinstimmen, das über die bereitgestellte Dokument-ID gefunden wurde.

    • frameId

      Zahl optional

      Die ID des Frames im jeweiligen Tab.

    • processId

      Zahl optional

      <ph type="x-smartling-placeholder"></ph> Seit Chrome 49 verworfen

      Frames werden jetzt eindeutig durch ihre Tab-ID und Frame-ID identifiziert. wird die Prozess-ID nicht mehr benötigt und daher ignoriert.

      Die ID des Prozesses, der den Renderer für diesen Tab ausführt.

    • tabId

      Zahl optional

      Die ID des Tabs, in dem sich der Frame befindet.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (details?: object) => void

    • Details

      Objekt (optional)

      Informationen zum angeforderten Frame; null, wenn die angegebene Frame-ID und/oder Tab-ID ungültig sind.

      • documentId

        String

        Chrome 106 und höher

        Eine UUID des geladenen Dokuments.

      • documentLifecycle

        DocumentLifecycle

        Chrome 106 und höher

        Der Lebenszyklus, in dem sich das Dokument befindet.

      • errorOccurred

        boolean

        Dieser Wert ist "True", wenn die letzte Navigation in diesem Frame aufgrund eines Fehlers unterbrochen wurde, d.h., das Ereignis "onErrorOccurred" wurde ausgelöst.

      • frameType

        FrameType

        Chrome 106 und höher

        Der Frame-Typ, in dem die Navigation erfolgte.

      • parentDocumentId

        String optional

        Chrome 106 und höher

        Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist.

      • parentFrameId

        Zahl

        Die ID des übergeordneten Frames oder -1, wenn dies der Hauptframe ist.

      • URL

        String

        Die URL, die derzeit mit diesem Frame verknüpft ist, wenn der durch die Frame-ID angegebene Frame an einer Stelle auf dem entsprechenden Tab vorhanden war. Die Tatsache, dass eine URL mit einer bestimmten Frame-ID verknüpft ist, bedeutet nicht, dass der entsprechende Frame noch vorhanden ist.

Returns

  • Promise&lt;object | nicht definiert>

    Chrome 93 und höher

    Promise-Objekte werden in Manifest V3 und höher unterstützt, Callbacks sind jedoch für Abwärtskompatibilität. Sie können nicht beide in demselben Funktionsaufruf verwenden. Die Promise wird mit demselben Typ aufgelöst, der an das Callback übergeben wird.

Ereignisse

onBeforeNavigate

chrome.webNavigation.onBeforeNavigate.addListener(
  callback: function,
  filters?: object,
)

Wird ausgelöst, wenn gleich eine Navigation beginnt.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • Chrome 106 und höher

        Der Lebenszyklus, in dem sich das Dokument befindet.

      • frameId

        Zahl

        0 bedeutet, dass die Navigation im Inhaltsfenster des Tabs stattfindet; Ein positiver Wert zeigt die Navigation in einem Subframe an. Frame-IDs sind für einen bestimmten Tab und Prozess eindeutig.

      • Chrome 106 und höher

        Der Frame-Typ, in dem die Navigation erfolgte.

      • parentDocumentId

        String optional

        Chrome 106 und höher

        Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist.

      • parentFrameId

        Zahl

        Die ID des übergeordneten Frames oder -1, wenn dies der Hauptframe ist.

      • processId

        Zahl

        <ph type="x-smartling-placeholder"></ph> Eingestellt seit Chrome 50

        Für dieses Ereignis wird die processId nicht mehr festgelegt, da der Prozess, der das resultierende Dokument rendert, erst bei onCommit bekannt ist.

        Der Wert von -1.

      • tabId

        Zahl

        Die ID des Tabs, auf dem die Navigation beginnen soll.

      • timeStamp

        Zahl

        Der Zeitpunkt, zu dem der Browser die Navigation starten sollte, in Millisekunden seit Epochzeit.

      • URL

        String

  • Filter

    Objekt (optional)

    • Bedingungen, die die aufgerufene URL erfüllen muss. Die „Schemas“ und "Ports" von UrlFilter werden bei diesem Ereignis ignoriert.

onCommitted

chrome.webNavigation.onCommitted.addListener(
  callback: function,
  filters?: object,
)

Wird ausgelöst, wenn ein Commit für eine Navigation durchgeführt wird. Das Dokument und die Ressourcen, auf die es verweist, z. B. Bilder und Subframes, werden möglicherweise noch heruntergeladen, aber mindestens ein Teil des Dokuments wurde vom Server empfangen und der Browser hat beschlossen, zum neuen Dokument zu wechseln.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • documentId

        String

        Chrome 106 und höher

        Eine UUID des geladenen Dokuments.

      • Chrome 106 und höher

        Der Lebenszyklus, in dem sich das Dokument befindet.

      • frameId

        Zahl

        0 bedeutet, dass die Navigation im Inhaltsfenster des Tabs stattfindet; Ein positiver Wert zeigt die Navigation in einem Subframe an. Frame-IDs sind innerhalb eines Tabs eindeutig.

      • Chrome 106 und höher

        Der Frame-Typ, in dem die Navigation erfolgte.

      • parentDocumentId

        String optional

        Chrome 106 und höher

        Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist.

      • parentFrameId

        Zahl

        Chrome 74 und höher

        Die ID des übergeordneten Frames oder -1, wenn dies der Hauptframe ist.

      • processId

        Zahl

        Die ID des Prozesses, der den Renderer für diesen Frame ausführt.

      • tabId

        Zahl

        Die ID des Tabs, auf dem die Navigation erfolgt.

      • timeStamp

        Zahl

        Der Zeitpunkt, zu dem ein Commit für die Navigation durchgeführt wurde, in Millisekunden seit der Epoche.

      • transitionQualifiers

        TransitionQualifier[]

        Eine Liste der Übergangsqualifizierer.

      • transitionType

        TransitionType

        Ursache der Navigation.

      • URL

        String

  • Filter

    Objekt (optional)

    • Bedingungen, die die aufgerufene URL erfüllen muss. Die „Schemas“ und "Ports" von UrlFilter werden bei diesem Ereignis ignoriert.

onCompleted

chrome.webNavigation.onCompleted.addListener(
  callback: function,
  filters?: object,
)

Wird ausgelöst, wenn ein Dokument einschließlich der Ressourcen, auf die es verweist, vollständig geladen und initialisiert wurde.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • documentId

        String

        Chrome 106 und höher

        Eine UUID des geladenen Dokuments.

      • Chrome 106 und höher

        Der Lebenszyklus, in dem sich das Dokument befindet.

      • frameId

        Zahl

        0 bedeutet, dass die Navigation im Inhaltsfenster des Tabs stattfindet; Ein positiver Wert zeigt die Navigation in einem Subframe an. Frame-IDs sind innerhalb eines Tabs eindeutig.

      • Chrome 106 und höher

        Der Frame-Typ, in dem die Navigation erfolgte.

      • parentDocumentId

        String optional

        Chrome 106 und höher

        Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist.

      • parentFrameId

        Zahl

        Chrome 74 und höher

        Die ID des übergeordneten Frames oder -1, wenn dies der Hauptframe ist.

      • processId

        Zahl

        Die ID des Prozesses, der den Renderer für diesen Frame ausführt.

      • tabId

        Zahl

        Die ID des Tabs, auf dem die Navigation erfolgt.

      • timeStamp

        Zahl

        Der Zeitpunkt, zu dem das Dokument vollständig geladen wurde, in Millisekunden seit der Epoche.

      • URL

        String

  • Filter

    Objekt (optional)

    • Bedingungen, die die aufgerufene URL erfüllen muss. Die „Schemas“ und "Ports" von UrlFilter werden bei diesem Ereignis ignoriert.

onCreatedNavigationTarget

chrome.webNavigation.onCreatedNavigationTarget.addListener(
  callback: function,
  filters?: object,
)

Wird ausgelöst, wenn ein neues Fenster oder ein neuer Tab in einem vorhandenen Fenster zum Hosten einer Navigation erstellt wird

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • sourceFrameId

        Zahl

        Die ID des Frames mit der sourceTabId, in der die Navigation ausgelöst wird. 0 gibt den Hauptframe an.

      • sourceProcessId

        Zahl

        Die ID des Prozesses, der den Renderer für den Quell-Frame ausführt.

      • sourceTabId

        Zahl

        Die ID des Tabs, auf dem die Navigation ausgelöst wird.

      • tabId

        Zahl

        Die ID des Tabs, auf dem die URL geöffnet wird

      • timeStamp

        Zahl

        Der Zeitpunkt, zu dem der Browser im Begriff war, eine neue Ansicht zu erstellen, in Millisekunden seit Epochzeit.

      • URL

        String

        URL, die in einem neuen Fenster geöffnet werden soll

  • Filter

    Objekt (optional)

    • Bedingungen, die die aufgerufene URL erfüllen muss. Die „Schemas“ und "Ports" von UrlFilter werden bei diesem Ereignis ignoriert.

onDOMContentLoaded

chrome.webNavigation.onDOMContentLoaded.addListener(
  callback: function,
  filters?: object,
)

Wird ausgelöst, wenn das DOM der Seite vollständig erstellt wurde, aber die Ressourcen, auf die verwiesen wird, möglicherweise nicht fertig geladen werden.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • documentId

        String

        Chrome 106 und höher

        Eine UUID des geladenen Dokuments.

      • Chrome 106 und höher

        Der Lebenszyklus, in dem sich das Dokument befindet.

      • frameId

        Zahl

        0 bedeutet, dass die Navigation im Inhaltsfenster des Tabs stattfindet; Ein positiver Wert zeigt die Navigation in einem Subframe an. Frame-IDs sind innerhalb eines Tabs eindeutig.

      • Chrome 106 und höher

        Der Frame-Typ, in dem die Navigation erfolgte.

      • parentDocumentId

        String optional

        Chrome 106 und höher

        Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist.

      • parentFrameId

        Zahl

        Chrome 74 und höher

        Die ID des übergeordneten Frames oder -1, wenn dies der Hauptframe ist.

      • processId

        Zahl

        Die ID des Prozesses, der den Renderer für diesen Frame ausführt.

      • tabId

        Zahl

        Die ID des Tabs, auf dem die Navigation erfolgt.

      • timeStamp

        Zahl

        Die Zeit, in der das DOM der Seite vollständig erstellt wurde, in Millisekunden seit der Epoche.

      • URL

        String

  • Filter

    Objekt (optional)

    • Bedingungen, die die aufgerufene URL erfüllen muss. Die „Schemas“ und "Ports" von UrlFilter werden bei diesem Ereignis ignoriert.

onErrorOccurred

chrome.webNavigation.onErrorOccurred.addListener(
  callback: function,
  filters?: object,
)

Wird ausgelöst, wenn ein Fehler auftritt und die Navigation abgebrochen wird. Dies kann passieren, wenn entweder ein Netzwerkfehler aufgetreten ist oder der Nutzer die Navigation abgebrochen hat.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • documentId

        String

        Chrome 106 und höher

        Eine UUID des geladenen Dokuments.

      • Chrome 106 und höher

        Der Lebenszyklus, in dem sich das Dokument befindet.

      • Fehler

        String

        Die Fehlerbeschreibung.

      • frameId

        Zahl

        0 bedeutet, dass die Navigation im Inhaltsfenster des Tabs stattfindet; Ein positiver Wert zeigt die Navigation in einem Subframe an. Frame-IDs sind innerhalb eines Tabs eindeutig.

      • Chrome 106 und höher

        Der Frame-Typ, in dem die Navigation erfolgte.

      • parentDocumentId

        String optional

        Chrome 106 und höher

        Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist.

      • parentFrameId

        Zahl

        Chrome 74 und höher

        Die ID des übergeordneten Frames oder -1, wenn dies der Hauptframe ist.

      • processId

        Zahl

        <ph type="x-smartling-placeholder"></ph> Eingestellt seit Chrome 50

        Die ProcessId ist für dieses Ereignis nicht mehr festgelegt.

        Der Wert von -1.

      • tabId

        Zahl

        Die ID des Tabs, auf dem die Navigation erfolgt.

      • timeStamp

        Zahl

        Die Zeit, zu der der Fehler aufgetreten ist, in Millisekunden seit der Epoche.

      • URL

        String

  • Filter

    Objekt (optional)

    • Bedingungen, die die aufgerufene URL erfüllen muss. Die „Schemas“ und "Ports" von UrlFilter werden bei diesem Ereignis ignoriert.

onHistoryStateUpdated

chrome.webNavigation.onHistoryStateUpdated.addListener(
  callback: function,
  filters?: object,
)

Wird ausgelöst, wenn der Verlauf des Frames auf eine neue URL aktualisiert wurde Für alle zukünftigen Ereignisse für diesen Frame wird die aktualisierte URL verwendet.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • documentId

        String

        Chrome 106 und höher

        Eine UUID des geladenen Dokuments.

      • Chrome 106 und höher

        Der Lebenszyklus, in dem sich das Dokument befindet.

      • frameId

        Zahl

        0 bedeutet, dass die Navigation im Inhaltsfenster des Tabs stattfindet; Ein positiver Wert zeigt die Navigation in einem Subframe an. Frame-IDs sind innerhalb eines Tabs eindeutig.

      • Chrome 106 und höher

        Der Frame-Typ, in dem die Navigation erfolgte.

      • parentDocumentId

        String optional

        Chrome 106 und höher

        Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist.

      • parentFrameId

        Zahl

        Chrome 74 und höher

        Die ID des übergeordneten Frames oder -1, wenn dies der Hauptframe ist.

      • processId

        Zahl

        Die ID des Prozesses, der den Renderer für diesen Frame ausführt.

      • tabId

        Zahl

        Die ID des Tabs, auf dem die Navigation erfolgt.

      • timeStamp

        Zahl

        Der Zeitpunkt, zu dem ein Commit für die Navigation durchgeführt wurde, in Millisekunden seit der Epoche.

      • transitionQualifiers

        TransitionQualifier[]

        Eine Liste der Übergangsqualifizierer.

      • transitionType

        TransitionType

        Ursache der Navigation.

      • URL

        String

  • Filter

    Objekt (optional)

    • Bedingungen, die die aufgerufene URL erfüllen muss. Die „Schemas“ und "Ports" von UrlFilter werden bei diesem Ereignis ignoriert.

onReferenceFragmentUpdated

chrome.webNavigation.onReferenceFragmentUpdated.addListener(
  callback: function,
  filters?: object,
)

Wird ausgelöst, wenn das Referenzfragment eines Frames aktualisiert wurde. Für alle zukünftigen Ereignisse für diesen Frame wird die aktualisierte URL verwendet.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • documentId

        String

        Chrome 106 und höher

        Eine UUID des geladenen Dokuments.

      • Chrome 106 und höher

        Der Lebenszyklus, in dem sich das Dokument befindet.

      • frameId

        Zahl

        0 bedeutet, dass die Navigation im Inhaltsfenster des Tabs stattfindet; Ein positiver Wert zeigt die Navigation in einem Subframe an. Frame-IDs sind innerhalb eines Tabs eindeutig.

      • Chrome 106 und höher

        Der Frame-Typ, in dem die Navigation erfolgte.

      • parentDocumentId

        String optional

        Chrome 106 und höher

        Eine UUID des übergeordneten Dokuments, zu dem dieser Frame gehört. Dieser Wert wird nicht festgelegt, wenn kein übergeordnetes Element vorhanden ist.

      • parentFrameId

        Zahl

        Chrome 74 und höher

        Die ID des übergeordneten Frames oder -1, wenn dies der Hauptframe ist.

      • processId

        Zahl

        Die ID des Prozesses, der den Renderer für diesen Frame ausführt.

      • tabId

        Zahl

        Die ID des Tabs, auf dem die Navigation erfolgt.

      • timeStamp

        Zahl

        Der Zeitpunkt, zu dem ein Commit für die Navigation durchgeführt wurde, in Millisekunden seit der Epoche.

      • transitionQualifiers

        TransitionQualifier[]

        Eine Liste der Übergangsqualifizierer.

      • transitionType

        TransitionType

        Ursache der Navigation.

      • URL

        String

  • Filter

    Objekt (optional)

    • Bedingungen, die die aufgerufene URL erfüllen muss. Die „Schemas“ und "Ports" von UrlFilter werden bei diesem Ereignis ignoriert.

onTabReplaced

chrome.webNavigation.onTabReplaced.addListener(
  callback: function,
)

Wird ausgelöst, wenn der Inhalt des Tabs durch einen anderen (normalerweise zuvor gerenderten) Tab ersetzt wird

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (details: object) => void

    • Details

      Objekt

      • replacedTabId

        Zahl

        Die ID des ersetzten Tabs.

      • tabId

        Zahl

        Die ID des Tabs, der den alten ersetzt hat.

      • timeStamp

        Zahl

        Der Zeitpunkt, zu dem der Austausch stattfand, in Millisekunden seit der Epoche.