Window.frameElement

SummaryEdit

Returns the element (such as <iframe> or <object>) in which the window is embedded, or null if the window is top-level.

SyntaxEdit

frameEl = window.frameElement;

• frameEl is the element which the window is embedded into, or null if the window is top-level.

ExampleEdit

var frameEl = window.frameElement;
// If we are inside a frame, then change its URL to 'http://mozilla.org/'
if (frameEl) {
  frameEl.src = 'http://mozilla.org/';
}

NotesEdit

Note that despite its name, the property also works for documents inside <object> and other embedding points.

SpecificationEdit

WHATWG

Browser compatibilityEdit

See alsoEdit

• window.frames returns an array-like object, listing the direct sub-frames of the current window.
• window.parent returns the parent window, which is the window containing the frameElement of the child window.