Retrieves information about a particular frame. A frame may be the top-level frame in a tab or a nested iframe , and is uniquely identified by a tab ID and a frame ID.
This is an asynchronous function that returns a
Promise
.
var gettingFrame = browser.webNavigation.getFrame(
details
// object
)
details
对象
. Information about the frame to retrieve information about.
tabId
integer
. The ID of the tab in which the frame is.
processId
可选
integer
. The ID of the process running the renderer for this tab.
frameId
integer
. The ID of the frame in the given tab.
A
Promise
that will be fulfilled with an object containing the following properties:
errorOccurred
boolean
. True if the last navigation in this frame was interrupted by an error, i.e. the
onErrorOccurred
event fired.
url
string
. The URL currently associated with this frame, if the frame identified by
frameId
existed at one point in the tab identified by
tabId
. The fact that an URL is associated with a given
frameId
does not imply that the corresponding frame still exists.
parentFrameId
integer
. ID of this frame's parent. This is -1 if there is no parent frame: that is, if this frame is the top-level browsing context in the tab.
If the tab is discarded, the promise will instead resolve with a
null
value. If the specified tab or frame ID could not be found, or some other error occurs, the promise will be rejected with an error message.
BCD tables only load in the browser
function onGot(frameInfo) {
console
.
log
(
frameInfo
)
;
}
function
onError
(
error
)
{
console
.
log
(
`
Error:
${
error
}
`
)
;
}
var
gettingFrame
=
浏览器
.
webNavigation
.
getFrame
(
{
tabId
:
19
,
frameId
:
1537
}
)
;
// Edge specific - processId is required not optional, must be integer not null
//var gettingFrame = browser.webNavigation.getFrame({ tabId: 19, processId: 0, frameId: 1537 });
gettingFrame
.
then
(
onGot
,
onError
)
;
注意：
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 贡献者