The Scripts Collection

Note : The Scripts collection is Internet Explorer 4.0 specific. The <SCRIPT> element supports the standard Internet Explorer 4.0 attributes of CLASS, ID, TITLE, as well as its own SRC, LANGUAGE, FOR and EVENT attributes (and Dynamic HTML properties of the same names and other standard Dynamic HTML properties and methods.

The Scripts collection is an ordered, indexed (by order in the source) array, containing a reference to every <SCRIPT> element in a document.

Script Objects would normally be retrieved by their index in the All collection (for example, above document.scripts(3) contains a reference to the third <SCRIPT> element in the document), but a string value can be used, as long as that string is a valid identifier (ID attribute value) for a <SCRIPT> element in the document.

E.g., consider the following to be the second <SCRIPT> element in the document

<SCRIPT LANGUAGE="VBScript" ID="HelloScript">
msgbox "Hello"
</SCRIPT>

both:

document.scripts(1).language

and

document.scripts("HelloScript").language

would return "VBScript" as they both reference the same script.

Properties

length
The length property returns the number of <SCRIPT> elements in the collection. Note that the length count starts at 1, not 0 as the scripts collection index does. Therefore, the length property may return a value of 5, but to access the 3rd element, you'd need to use document.scripts(2).property

Methods

item
The item method retrieves single items, or sub-collections from the scripts collection. It accepts the following arguments:

scripts.item(index, sub-index)

If index is a number, then the method returns a reference to the <SCRIPT> element object at that position in the scripts collections index.

If the index property is a string value, then the item method returns a sub-collection, containing a reference to every element in the document that has its ID or NAME attribute set to the string contained in the index argument (Note that if you are using ID attributes only to uniquely identify scripts, then the sub-collection will only contain the one item). To retrieve certain element objects from this sub-collection, the sub-index argument must be used.