Latest web development tutorials

×

JavaScript Reference

JavaScript

JS String JS Number JS Operators JS Statements JS Math JS Date JS Array JS Boolean JS RegExp JS Global JS Conversion

Browser BOM

Window Navigator Screen History Location

HTML DOM

DOM Document DOM Elements DOM Attributes DOM Events DOM Style

HTML Objects

<a> <abbr> <address> <area> <article> <aside> <audio> <b> <base> <bdo> <blockquote> <body> <br> <button> <canvas> <caption> <cite> <code> <col> <colgroup> <datalist> <dd> <del> <details> <dfn> <dialog> <div> <dl> <dt> <em> <embed> <fieldset> <figcaption> <figure> <footer> <form> <head> <header> <h1> - <h6> <hr> <html> <i> <iframe> <img> <ins> <input> button <input> checkbox <input> color <input> date <input> datetime <input> datetime-local <input> email <input> file <input> hidden <input> image <input> month <input> number <input> password <input> radio <input> range <input> reset <input> search <input> submit <input> text <input> time <input> url <input> week <kbd> <keygen> <label> <legend> <li> <link> <map> <mark> <menu> <menuitem> <meta> <meter> <nav> <object> <ol> <optgroup> <option> <output> <p> <param> <pre> <progress> <q> <s> <samp> <script> <section> <select> <small> <source> <span> <strong> <style> <sub> <summary> <sup> <table> <td> <th> <tr> <textarea> <time> <title> <track> <u> <ul> <var> <video>

Other Objects

CSSStyleDeclaration

Window frameElement Property

< Window Object

Example

Find out if the current window is in an <iframe>. If so, change its URL to "w3ii.com":

var frame = window.frameElement; // Get the <iframe> element of the window

if (frame) { // If the window is in an <iframe>, change its source
frame.src = "http://www.w3ii.com/";
}

Try it Yourself »

Definition and Usage

The frameElement property returns the <iframe> element in which the current window is inserted.

If the document window is not placed within an <iframe>, the return value of this property is null.

Note: This property will also work for <frame> elements. However, the <frame> element is not supported in HTML5.

This property is read-only.

Browser Support

The numbers in the table specify the first browser version that fully supports the property.

Property
frameElement	18.0	6.0	1.0	Yes	Yes

Syntax

window.frameElement

Technical Details

Return Value:	An IFrame object, which is the host of the current window in the parent document, otherwise null

Related Pages

HTML DOM reference: HTML DOM IFrame Object

HTML reference: HTML <iframe> tag

< Window Object