Web/API/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

Specification	Status	Comment
HTML Living StandardThe definition of 'Window.frames' in that specification.	Living Standard
HTML5The definition of 'Window.frames' in that specification.	Recommendation

Browser compatibility

The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.

Update compatibility data on GitHub

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
frames	Chrome Full support 1	Edge Full support 12	Firefox Full support 1	IE Full support 4	Opera Full support ≤12.1	Safari Full support 1	WebView Android Full support 1	Chrome Android Full support 18	Firefox Android Full support 4	Opera Android Full support ≤12.1	Safari iOS Full support 1	Samsung Internet Android Full support 1.0

Legend

Full support  

Full support

Window.frames by Mozilla Contributors is licensed under CC-BY-SA 2.5.