The Window.frameElement property returns the element (such as <iframe> or <object>) in which the window is embedded.
Note: Despite this property's name, it works for documents embedded within any embedding point, including <object>, <iframe>, or <embed>.
Syntax
const frameEl = window.frameElement
Value
The element which the window is embedded into. If the window isn't embedded into another document, or if the document into which it's embedded has a different origin, the value is null instead.
Example
const frameEl = window.frameElement;
// If we're embedded, change the containing element's URL to 'http://mozilla.org/'
if (frameEl) {
frameEl.src = 'http://mozilla.org/';
}
Specifications
| Specification | Status | Comment |
|---|---|---|
| HTML Living Standard The definition of 'Window.frameElement' in that specification. |
Candidate Recommendation | Initial specification. |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
| Desktop | Mobile | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
frameElement | Chrome Full support Yes | Edge Full support 12 | Firefox Full support 1 | IE Full support Yes | Opera Full support Yes | Safari Full support Yes | WebView Android Full support Yes | Chrome Android Full support Yes | Firefox Android Full support Yes | Opera Android Full support Yes | Safari iOS Full support Yes | Samsung Internet Android Full support Yes |
Legend
- Full support
- Full support
See also
window.framesreturns an array-like object, listing the direct sub-frames of the current window.window.parentreturns the parent window, which is the window containing theframeElementof the child window.