PluginArray object (Object/browser)

A collection of plugin modules that the browser can use to playback embedded content.

Availability:

JavaScript - 1.1
JScript - 3.0
Internet Explorer - 4.0
Netscape - 3.0
Opera - 3.0
JavaScript syntax:IEmyPluginArray = document.plugins
NmyPluginArray = navigator.plugins
Object properties:length
Object methods:item(), refresh()

Netscape and MSIE encapsulate plugin/embedded objects in a different way. In MSIE they are objects of the EMBED class. In Netscape Navigator they are objects commonly referred to as belonging to the Plugin class although they are really implemented as JavaObject objects. In MSIE, this is an ActiveX object.

There is additional confusion in that there is a plugins[] array that belongs to the document and another than belongs to the navigator object. They both contain collections of objects but of different types. This is further confused by the fact that the document.plugins[] array is another name for the document.embeds[] array.

Due to this confusing situation, the best recommendation is that we refer to document.embeds[] and navigator.plugins[] and quietly ignore the document.plugins[] array. Furthermore we shall refer to Plugin objects as being something the browser can use to play embedded content and Embed objects as instances of a plugin that is alive and running in a document.

Warnings:

Example code:

   // Execute this in Netscape Navigator to fix the
   // navigator.plugins enumeration bug
   for(ii=0; ii<navigator.plugins.length; ii++)
   {
      navigator.plugins[ii].refresh;
   }

See also:Collection object, EmbedArray object, Navigator.plugins[], Plugin object

PropertyJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
length1.1 1.13.0 3.03.0 3.04.0 4.0 n/a n/a n/a n/a n/a n/aWarning , ReadOnly.

MethodJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
item() n/a3.0 3.0 n/a4.0 4.0 n/a n/a n/a n/a n/a n/a-
refresh()1.1 1.1 n/a3.0 3.0 n/a3.0 3.0 n/a n/a n/a n/a n/a-