Summary
Returns the window itself, which is an array-like object, listing the direct sub-frames of the current window.
Syntax
frameList = window.frames;
frameList
is a list of frame objects. It is similar to an array in that it has alength
property and its items can be accessed using the[i]
notation.frameList === window
evaluates to true.- Each item in the window.frames pseudo-array represents the window object corresponding to the given <frame>'s or <iframe>'s content, not the (i)frame DOM element (i.e.,
window.frames[ 0 ]
is the same thing asdocument.getElementsByTagName( "iframe" )[ 0 ].contentWindow
). - For more details about the returned value, refer to this thread on mozilla.dev.platform [dead link].
Example
var frames = window.frames; // or // var frames = window.parent.frames; for (var i = 0; i < frames.length; i++) { // do something with each subframe as frames[i] frames[i].document.body.style.background = "red"; }
Specifications
Specification | Status | Comment |
---|---|---|
WHATWG HTML Living Standard The definition of 'Window.frames' in that specification. |
Living Standard | |
HTML5 The definition of 'Window.frames' in that specification. |
Recommendation |
Document Tags and Contributors
Tags:
Contributors to this page:
sarafec,
momdo,
mrenty,
pygy,
Ms2ger,
cvrebert,
fscholz,
sanjaygouri,
YaseenKhan,
jsx,
teoli,
kscarfone,
Sheppy,
dbruant,
jswisher,
Nickolay,
jorh,
Mgjbot,
Rvts,
Alkiredjian,
Rahul sheenu,
H2g2bob,
Dria,
Callek,
JesseW
Last updated by:
sarafec,