Window.frames
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.
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 |
---|
HTML Standard (HTML) # dom-frames-dev |
Browser compatibility
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | |
frames |
1 |
12 |
1 |
4 |
≤12.1 |
1 |
1 |
18 |
4 |
≤12.1 |
1 |
1.0 |
© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Window/frames