Window: frames property
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
Returns the window itself, which is an array-like object, listing the direct sub-framesof the current window.
In this article
Value
A list of frame objects. It is similar to anarray in that it has alength property and its items can be accessedusing the[i] notation.
frames === windowevaluates to true.- Each item in the
window.framespseudo-array represents theWindowobject corresponding to the given<frame>'s or<iframe>'s content, not theframeoriframeDOM element (i.e.,window.frames[0]is the same thing asdocument.getElementsByTagName("iframe")[0].contentWindow). - For more details about the returned value, refer to thisthread 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> # dom-frames-dev> |