W3cubDocs

/Web APIs

Window: frames property

Returns the window itself, which is an array-like object, listing the direct sub-frames of the current window.

Value

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 frame or iframe 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.

Examples

js

const frames = window.frames; // or const frames = window.parent.frames;
for (let 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
# 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 4.4 18 4 ≤12.1 1 1.0

© 2005–2023 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