Fired when an error occurs and the navigation is aborted. This can happen if either a network error occurred, or the user aborted the navigation.
browser.webNavigation.onErrorOccurred.addListener(
listener
,
// function
filter
// optional object
)
浏览器
.
webNavigation
.
onErrorOccurred
.
removeListener
(
listener
)
浏览器
.
webNavigation
.
onErrorOccurred
.
hasListener
(
listener
)
Events have three functions:
addListener(listener)
addListener(listener, filter)
Adds a listener to this event.
removeListener(listener)
Stop listening to this event. The
listener
argument is the listener to remove.
hasListener(listener)
校验是否
listener
is registered for this event. Returns
true
if it is listening,
false
否则。
listener
Function that will be called when this event occurs.
The
listener
function will be called with the following arguments:
details
对象
. Details about the navigation event.
details
has the following properties:
tabId
integer
. The ID of the tab in which the navigation was happening.
url
string
. The URL to which the given frame was navigating.
processId
integer
. The ID of the process in which this tab is being rendered.
frameId
integer
. Frame in which the navigation was happening.
0
indicates that navigation happened in the tab's top-level browsing context, not in a nested
<iframe>
.
A positive value indicates that navigation happened in a nested iframe.
Frame IDs are unique for a given tab and process.
timeStamp
编号
. The time at which the error occurred, in
milliseconds since the epoch
.
error
string
. The error code. This is an internal error code, and is not guaranteed to stay the same or be consistent from one browser to another.
filter
可选
对象
. An object containing a single property
url
, which is an
数组
of
events.UrlFilter
对象。
If you include this parameter, then the event will fire only for transitions to URLs which match at least one
UrlFilter
in the array.
If you omit this parameter, the event will fire for all transitions.
BCD tables only load in the browser
Logs the target URLs for
onErrorOccurred
, if the target URL's
hostname
包含
"example.com"
or starts with
"developer"
.
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);
注意：
This API is based on Chromium's
chrome.webNavigation
API. This documentation is derived from
web_navigation.json
in the Chromium code.
Microsoft Edge compatibility data is supplied by Microsoft Corporation and is included here under the Creative Commons Attribution 3.0 United States License.
最后修改： , 由 MDN 贡献者