webNavigation.onErrorOccurred

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

Syntax

js
browser.webNavigation.onErrorOccurred.addListener(
  listener,                   // function
  filter                      // optional object
)
browser.webNavigation.onErrorOccurred.removeListener(listener)
browser.webNavigation.onErrorOccurred.hasListener(listener)

Ereignisse haben drei Funktionen:

addListener(listener)

addListener(listener, filter)

Fügt diesem Ereignis einen Listener hinzu.

removeListener(listener)

Stoppt das Lauschen auf dieses Ereignis. Das Argument listener ist der Listener, der entfernt wird.

hasListener(listener)

Überprüft, ob listener für dieses Ereignis registriert ist. Gibt true zurück, wenn er lauscht, andernfalls false.

addListener-Syntax

Parameter

listener

Die Funktion, die aufgerufen wird, wenn dieses Ereignis eintritt.

Die listener-Funktion wird mit diesen Argumenten aufgerufen:

details

object. Details über das Navigationsereignis. details hat die folgenden Eigenschaften:

tabId

integer. Die ID des Tabs, in dem die Navigation stattfand.

url

string. Die URL, zu der der gegebene Frame navigierte.

processId Optional Veraltet

integer. Dieser Wert wird in modernen Browsern nie gesetzt. Früher repräsentierte er die ID des Prozesses, der den Renderer für diesen Tab ausführte.

frameId

integer. Frame, in dem die Navigation stattfand.

0 zeigt an, dass die Navigation im oberen Browsing-Kontext des Tabs stattgefunden hat, nicht in einem verschachtelten <iframe>.

Ein positiver Wert zeigt an, dass die Navigation in einem verschachtelten iframe stattgefunden hat.

Frame-IDs sind einzigartig für einen bestimmten Tab und Prozess.

timeStamp

number. Die Zeit, zu der der Fehler auftrat, in Millisekunden seit der Epoche.

error

string. Der Fehlercode. Dies ist ein interner Fehlercode und es wird nicht garantiert, dass er dasselbe bleibt oder zwischen verschiedenen Browsern konsistent ist.

filter Optional

object. Ein Objekt, das eine einzelne Eigenschaft url enthält, die ein Array von events.UrlFilter-Objekten ist.

Wenn Sie diesen Parameter angeben, wird das Ereignis nur für Übergänge zu URLs ausgelöst, die mindestens einem UrlFilter im Array entsprechen.

Wenn Sie diesen Parameter weglassen, wird das Ereignis für alle Übergänge ausgelöst.

Browser-Kompatibilität

BCD tables only load in the browser

Beispiele

Protokolliert die Ziel-URLs für onErrorOccurred, falls der hostname der Ziel-URL „example.com“ enthält oder mit „developer“ beginnt.

js
const filter = {
  url: [{ hostContains: "example.com" }, { hostPrefix: "developer" }],
};

function logOnErrorOccurred(details) {
  console.log(`onErrorOccurred: ${details.url}`);
  console.log(details.error);
}

browser.webNavigation.onErrorOccurred.addListener(logOnErrorOccurred, filter);

Hinweis: Diese API basiert auf Chromiums chrome.webNavigation API. Diese Dokumentation stammt aus web_navigation.json im Chromium-Code.