Plugin object (Object/browser)

An object representing a plugin.

Availability:

JavaScript - 1.1
JScript - 3.0
Internet Explorer - 4.0
Netscape - 3.0
Opera - 3.0
JavaScript syntax:-myPlugin = document.plugins[anIndex]
NmyPlugin = navigator.plugins[anIndex]
-myPlugin = myPluginArray[anIndex]
HTML syntax:<APPLET> <EMBED> <OBJECT>
Argument list:anIndexA reference to an element in a collection
Object properties:description, filename, length, name
Object methods:isActive(), 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.

Because of 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:

See also:<EMBED>, Collection object, Embed object, EmbedArray object, Glue code, Java, Navigator.plugins[], Plugin events, PluginArray object

PropertyJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
description1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aReadOnly.
filename1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aReadOnly.
length1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aWarning , ReadOnly.
name1.1 1.13.0 3.03.0 3.04.0 4.03.0 3.0 n/a n/a n/a n/a n/aReadOnly.

MethodJavaScriptJScriptNIEOperaNESECMADOMCSSHTMLNotes
isActive()1.3 1.3 n/a4.7 4.7 n/a 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-