The Embeds Collection

Note : Both Netscape and Internet Explorer support the Embeds collection (Netscape call it an array). For properties, methods and events accessible through the Embeds array, see the <EMBED> topic.

The Embeds collection is an ordered, indexed array, containing a reference to every <EMBED> element in the document.

Embed Objects would normally be retrieved by their index in the Embeds collection (for example document.embeds(3) contains a reference to the 4th embedded object in the document), but a string value can be used, as long as that string is a valid identifier (ID attribute value) for an <EMBED> element.


The length property returns the number of elements in the collection. Note that the length count starts at 1, not 0 as the embeds 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.embeds(2).property


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

embeds.item(index, sub-index)

If index is a number, then the method returns a reference to the embed object at that position in the embeds collections index. I.e.


would make the value of strTag be the pluginSpace property (which reflects the PLUGINSPACE attribute) for the third <EMBED> element in the embeds collection.

If the index property is a string value, then the item method returns a sub-collection, containing a reference to every <EMBED> in the document that has its ID or NAME attribute set to the string contained in the index argument. To retrieve certain element objects from this sub-collection, the sub-index argument must be used.