Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

webNavigation.getFrame()

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.

Syntax

chrome.webNavigation.getFrame(
  details,                // object
  function(details) {...} // function
)

This API is also available as browser.webNavigation.getFrame() in a version that returns a promise.

Parameters

details
object. 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.
callback
function. The function is passed the following arguments:
detailsOptional
object. Information about the requested frame. If the specified frame ID and/or tab ID are invalid, this is null.

Additional objects

details

Information about the requested frame. If the specified frame ID and/or tab ID are invalid, this is null.

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.

Browser compatibility

Chrome Edge Firefox Firefox for Android Opera
Basic support Yes Yes 47.0 48.0 33

Examples

function logFrameInfo(frameInfo) {
  console.log(frameInfo.url);
}

var frameReference = {
  tabId: myTabId,
  frameId: myFrameId,
  processId: myProcessId
}

chrome.webNavigation.getFrame(frameReference, logFrameInfo);

Acknowledgements

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.

Document Tags and Contributors

 Contributors to this page: Makyen, wbamberg
 Last updated by: Makyen,