This page is Ready to Use

Notice: The WebPlatform project, supported by various stewards between 2012 and 2015, has been discontinued. This site is now available on github.



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

Property of dom/Windowdom/Window


Note: This property is read-only.

var frames = window.frames;

Return Value

Returns an object of type DOM NodeDOM Node

Collection of HTMLWindow objects that are children of the window Node.


This example in JScript (compatible with ECMA 262 language specification) shows how to display the URLs of the HTML documents contained in windows created by the iframe objects in the document.

var frm = document.frames;
for (i=0; i < frm.length; i++)

This example in JScript shows how to display the name of each window defined by frame tags in the parent window of the current document.

var frm = window.parent.frames;
for (i=0; i < frm.length; i++)



If the HTML source document contains a body tag, the collection contains one window for each iframe object in the document. If the source document contains frameSet tags, the collection contains one window for each frame tag in the document. In both cases, the order is determined by the HTML source. This collection contains only window objects and does not provide access to the corresponding frame and iframe objects. Although you can use names with the item method on this collection, the method never returns a collection. Instead, it always returns the first window having the given name. To ensure that all windows are accessible, make sure that no two windows in a document have the same name.


  • Mozilla Developer Network cc-by-sa-small-wpd.svg: [frames Article]

  • Microsoft Developer Network: [window Object Article]