문서에 있는 모든 문서 자체나 frameSet로 지정된 프레임의 window 개체들의 컬렉션을 반환한다.

인수

: (개체)

필수적인 요소이고 컬렉션을 포함하는 모체 개체이다.

cVal : (컬렉션)

선택적인 요소이고 값은 컬렉션을 나타내는 개체이다.

oVal : (개체)

선택적인 요소이고 값은 컬렉션의 한개의 엘레멘트 개체이다.

index : (정수/문자열)

필수적인 요소이고 값은 컬렉션의 인수나 문자열로 한개의 엘레멘트 개체나 다른 컬렉션을 참조할수 있고 배열변수의 규칙에따라 0부터 시작하고 제일 마지막 인수는 길이보다 1 작다. 같은 name이나 id 속성을 가진 개체들이 있는 경우에는 컬렉션을 반환한다.

subIndex : (문자열)

선택적인 요소이고 값은 컬렉션의 반환받고저 하는 개체의 위치를 지정하며 name이나 id 속성값을 지정하는 문자열이다. 일치하는 개체나 컬렉션을 반환한다.

특기

HTML 문서가 body 태그를 포함하면 이 frames 컬렉션은 문서의 개체의 iFrame 개체들의 배열변수를 반환한다. 문서가 frameSet를 포함하면 각 frame 태그들의 배열변수를 반환한다. 규격에 의하여 두가지를 동시에 갖지는 않으나 갖는 경우는 HTML 소스에 나타나는 순서로 배열변수 인수가 결정된다.

컬렉션은 window 개체들만 포함하고 frame과 iFrame 개체들은 포함되지 않는다. frame과 iFrame 개체들을 호출하기 위해서는 document .all 컬렉션을 사용하면 된다.

컬렉션의 name 문자열로 item 메서드를 사용하여 컬렉션의 요소를 호출할 수 있으나 주어진 이름의 첫 윈도우 개체를 반환한다. 따라서 같은 이름의 윈도우를 한 문서에 사용하면 차질이 있을 수 있다.

적용

개체	script	HTML	규격	IE

설명을 위한 예제

length 속성 IE3.02 NS2
⇒ 컬렉션에 frame 개체가 몇개 포함되어 있는가를 반환한다.

문법: [iVal=].length

코드: document.write(oObj.length); 결과:

컬렉션 예제 1

<SCRIPT>
frameCol=top.frames;
for (i=0; i< frameCol.length;i++){
  document.write('top.frames['+i+'].location='+frameCol[i].location+'<BR>');
}

컬렉션 예제 2

<SCRIPT>
frameCol=window.parent.frames;
for (i=0; i< frameCol.length;i++){
  document.write('window.parent.frames['+i+'].location='+frameCol[i].location+'<BR>');
}