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 a length 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 as document.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

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