浏览器-JavaScript手册-语法-函数

在客户端上安装的一个插件模块。


实现版本	Navigator 3.0

创建源

Plugin 对象是 JavaScript 的预定义对象，你可以通过 navigator.plugins数组访问它们。

描述

一个 Plugin 对象就是一个安装在客户端的插件。所谓插件，就是浏览器用于显示特定类型嵌入数据时调用的软件模块。用户从帮助菜单中选择关于插件选项可以获取已安装插件的清单。

每个 Plugin 对象本身都是一个数组，其中包含的每个元素分别对应于每个该插件支持的 MIME 类型。而数组的每个元素都是一个 MimeType 对象。例如，下面的代码将显示第一个 Plugin 对象的第一个 MimeType 对象的 type 和描述属性。

myPlugin=navigator.plugins[0]
myMimeType=myPlugin[0]
document.writeln('myMimeType.type 为 ',myMimeType.type,"<BR>")
document.writeln('myMimeType.description 为 ',myMimeType.description)

而此代码的显示输出与下列内容相似：

myMimeType.type 为 video/quicktime
myMimeType.description 为 QuickTime for Windows

Plugin 对象使你可以动态判断客户端上安装了哪些插件。你可以编写这样的脚本，用于在已安装对应的插件时显示嵌入插件数据，而在没有安装对应插件的时候显示某些如图像或文本等的替换信息。

插件可能是与平台相关的或可配置的，所以 Plugin 对象的 MimeType 对象数组在不同的平台或用户那里的情况可能并不相同。

每个 Plugin 对象都是 plugins 数组中的一个元素。

当你使用document.embeds数组。

属性概览

对象数组的元素个数。

插件的描述。

插件文件在磁盘上的文件名。

MimeType

插件的名称。

示例

示例 1用户可以从帮助菜单中选择关于插件获取已安装的插件列表。要查看浏览器完成此报表的源代码，可以首先从帮助菜单中选择关于插件选项，然后从查看菜单中选择页面源文件。

示例 2下列代码将把预定义的 LiveAudio 属性赋给简明变量。

var myPluginName = navigator.plugins["LiveAudio"].name
var myPluginFile = navigator.plugins["LiveAudio"].filename
var myPluginDesc = navigator.plugins["LiveAudio"].description

示例 3下面的代码将在已安装 LiveAudio 的情况下显示消息“LiveAudio 已经配置为 audio/wav”，也就是说它对应于“audio/wav”MIME类型：

var myPlugin = navigator.plugins["LiveAudio"]
var myType = myPlugin["audio/wav"]
if (myType && myType.enabledPlugin == myPlugin)
document.writeln("LiveAudio 已经配置为 audio/wav")

示例 4下面的表达式将呈现出 Shockwave 可以显示的 MIME 类型数目：

navigator.plugins["Shockwave"].length

示例 5下面的代码将列出一张表，其中显示了客户端每个 Plugin 对象的 name、filename、description 和 length 属性：

document.writeln("<TABLE BORDER=1><TR VALIGN=TOP>",
   "<TH>i",
   "<TH>名称",
   "<TH>文件名",
   "<TH>描述",
   "<TH>类型数</TR>")
for (i=0; i < navigator.plugins.length; i++) {
   document.writeln("<TR VALIGN=TOP><TD>",i,
      "<TD>",navigator.plugins[i].name,
      "<TD>",navigator.plugins[i].filename,
      "<TD>",navigator.plugins[i].description,
      "<TD>",navigator.plugins[i].length,
      "</TR>")
}
document.writeln("</TABLE>")

上面例子的输出结果与下面类似：

i	名称	文件名	描述	类型数
0	QuickTime Plug-In	d: ettools etscape av30\Program\ plugins\NPQTW32.DLL	QuickTime Plug-In for Win32 v.1.0.0	1
1	LiveAudio	d: ettools etscape av30\Program\ plugins\NPAUDIO.DLL	LiveAudio - Netscape Navigator sound playing component	7
2	NPAVI32 Dynamic Link Library	d: ettools etscape av30\Program\ plugins pavi32.dll	NPAVI32, avi plugin DLL	2
3	Netscape Default Plugin	d: ettools etscape av30\Program\ plugins pnul32.dll	Null Plugin	1

参看

document.embeds

属性

description

人工可阅读的插件描述。该文本由插件开发者提供。

属性源	Navigator 3.0

filename

插件文件在磁盘上的名称。

属性源	Navigator 3.0

描述

filename 属性是插件程序文件名，由插件自身提供。该名称可能因平台不同而不同。

示例

参看 Plugin的示例。

length

MimeType对象的插件数组中的元素个数。

属性源	Navigator 3.0

name

指定插件名称的字符串。

属性源	Navigator 3.0

安全性

Navigator 3.0: 该属性缺省情况下是带有污点的。要获得关于数据污点更多的信息，请看“JavaScript 安全性”。

描述

插件的名称，由插件自身提供。每个插件都应该有一个唯一的名称标识自身。