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
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. Gibttrue
zurück, wenn er lauscht, andernfallsfalse
.
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 Eigenschafturl
enthält, die einArray
vonevents.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.
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.