PluginArray
Deprecated: This feature is no longer recommended. Though some browsers might still support it, it may have already been removed from the relevant web standards, may be in the process of being dropped, or may only be kept for compatibility purposes. Avoid using it, and update existing code if possible; see thecompatibility table at the bottom of this page to guide your decision. Be aware that this feature may cease to work at any time.
ThePluginArray interface is used to store a list ofPlugin objects; it's returned by thenavigator.plugins property. ThePluginArray is not a JavaScript array, but has thelength property and supports accessing individual items using bracket notation (plugins[2]), as well as viaitem(index) andnamedItem("name") methods.
Note:Own properties ofPluginArray objects are no longer enumerable in the latest browser versions.
In this article
Instance properties
PluginArray.lengthRead onlyDeprecatedThe number of plugins in the array.
Instance methods
PluginArray.itemDeprecatedReturns the
Pluginat the specified index into the array.PluginArray.namedItemDeprecatedReturns the
Pluginwith the specified name.PluginArray.refreshDeprecatedRefreshes all plugins on the current page, optionally reloading documents.
Examples
The following example function returns the version of the Shockwave Flash plugin.
const pluginsLength = navigator.plugins.length;document.body.innerHTML = `${pluginsLength} Plugin(s)<br>` + `<table><thead>` + `<tr><th>Name</th><th>Filename</th><th>description</th><th>version</th></tr>` + `</thead><tbody></tbody></table>`;const table = document.getElementById("pluginTable");for (let i = 0; i < pluginsLength; i++) { let newRow = table.insertRow(); newRow.insertCell().textContent = navigator.plugins[i].name; newRow.insertCell().textContent = navigator.plugins[i].filename; newRow.insertCell().textContent = navigator.plugins[i].description; newRow.insertCell().textContent = navigator.plugins[i].version ?? "";}The following example displays information about the installed plugin(s).
const pluginsLength = navigator.plugins.length;document.write( `${pluginsLength.toString()} Plugin(s)<br>` + `Name | Filename | description<br>`,);for (let i = 0; i < pluginsLength; i++) { document.write( `${navigator.plugins[i].name} | ${navigator.plugins[i].filename} | ${navigator.plugins[i].description} | ${navigator.plugins[i].version}<br>`, );}Specifications
| Specification |
|---|
| HTML> # pluginarray> |
Browser compatibility
In addition to listing each plugin as a pseudo-array by zero-indexed numeric properties, Firefox provides properties that are the plugin name directly on the PluginArray object.